# MicroApps Docs Index

> 长青文档：[MICROAPPS_PRODUCT_CONTEXT.md](./MICROAPPS_PRODUCT_CONTEXT.md)（产品上下文，单一真源）

文档按用途分目录。新增文件请放到对应子目录，并按 `YYYY-MM-DD-{feature}-{type}.md` 命名。

---

## 📓 [retrospects/](./retrospects/) — 复盘

AI-用户协作过程复盘（内部分享格式）。每次任务收尾时产出，记录"做了什么 / 哪里卡住 / 学到什么"。

| 日期 | Feature | 文件 |
|---|---|---|
| 2026-05-20 | Video Sync | [mockup-retrospect-internal-share](./retrospects/2026-05-20-video-sync-mockup-retrospect-internal-share.md) — **复盘文件格式真源** |
| 2026-05-20 | Graphics Insertion | [9-round-retrospect](./retrospects/2026-05-20-graphics-insertion-9-round-retrospect.md) |

---

## 🤝 [handoffs/](./handoffs/) — Session 交接 / 下次 Pickup

跨 session 的工作交接说明。当前 session 写给下次的 self。

| 日期 | Feature | 文件 |
|---|---|---|
| 2026-05-21 | Video Sync | [next-session-pickup](./handoffs/2026-05-21-video-sync-next-session-pickup.md) |
| 2026-05-20 | Video Sync | [next-session-pickup](./handoffs/2026-05-20-video-sync-next-session-pickup.md) |
| 2026-05-20 | Graphics Insertion | [pickup](./handoffs/2026-05-20-graphics-insertion-pickup.md) |
| 2026-05-19 | Video Sync | [multi-session-handoff](./handoffs/2026-05-19-video-sync-multi-session-handoff.md) |
| 2026-05-19 | Graphics Insertion | [dual-preview-handoff](./handoffs/2026-05-19-graphics-insertion-dual-preview-handoff.md) |
| 2026-05-14 | Plan B Figma | [handoff](./handoffs/2026-05-14-plan-b-figma-handoff.md) · [connectors-pickup](./handoffs/2026-05-14-plan-b-figma-connectors-pickup.md) |
| 2026-05-11 | — | [handoff](./handoffs/2026-05-11-handoff.md) · [next-session](./handoffs/2026-05-11-next-session.md) |

---

## 🔍 [audits/](./audits/) — F1 走查 / Walkthrough

对 mockup / 代码的结构化走查记录（PRD 对齐、sibling visual contract、规则合规等）。

| 日期 | Feature | 文件 |
|---|---|---|
| 2026-05-20 | Video Sync | [m3-walkthrough-fix](./audits/2026-05-20-video-sync-m3-walkthrough-fix.md) |
| 2026-05-14 | Plan B | [f1-walkthrough](./audits/2026-05-14-plan-b-f1-walkthrough.md) |

---

## 📐 [specs/](./specs/) — 设计 Spec / Figma Prompt

设计描述、Plan B 规范、Figma 生成提示词等"输入型"文档。

| 日期 | 文件 |
|---|---|
| 2026-05-13 | [plan-b-spec](./specs/2026-05-13-plan-b-spec.md) · [plan-b-figma-prompt](./specs/2026-05-13-plan-b-figma-prompt.md) |
| 2026-05-09 | [design](./specs/2026-05-09-design.md) |

---

## ✅ [decisions/](./decisions/) — 设计决策记录 (ADR)

固化的设计/产品决策，单文件单决策。

| 日期 | 决策 |
|---|---|
| 2026-05-09 | [auto-refresh-pause-button](./decisions/2026-05-09-auto-refresh-pause-button.md) |
| 2026-05-09 | [master-console-readonly](./decisions/2026-05-09-master-console-readonly.md) |
| 2026-05-09 | [session-health-indicator](./decisions/2026-05-09-session-health-indicator.md) |

---

## 命名约定

- **复盘文件**：`YYYY-MM-DD-{feature}-{N-round-retrospect|retrospect-internal-share}.md`
- **Handoff**：`YYYY-MM-DD-{feature}-{handoff|pickup|next-session-pickup}.md`
- **Walkthrough**：`YYYY-MM-DD-{feature}-{milestone}-walkthrough{-fix}.md`
- **Spec**：`YYYY-MM-DD-{feature}-spec.md` / `-figma-prompt.md`
- **Decision**：`YYYY-MM-DD-{decision-slug}.md`