# docs 索引

日常小刀（S0/S1）：直接改，BACKLOG 记一行即可，**不要**套下面的 SDD 模板。

S2/S3（跨模块、有契约或危险写路径）：把 [sdd-template.md](./sdd-template.md) 拷成 `SDD-xxx.md` 再填。模板只服务这类变更，不另开第三套总览。

## 现在以哪份为准

| 文档 | 用途 |
|------|------|
| [ARCHITECTURE.md](./ARCHITECTURE.md) | 短架构：边界、`/src` 唯一产品 UI、端口、数据流、MCP/危险写 |
| [BACKLOG.md](./BACKLOG.md) | 待办与验收清单 |
| [15-AI-MCP-Agent.md](./15-AI-MCP-Agent.md) | MCP / 工具层任务书 |
| [16-AI-Session-Harness.md](./16-AI-Session-Harness.md) | 会话状态机、incomplete、Harness |
| [sdd-template.md](./sdd-template.md) | 仅 S2/S3 拷贝使用 |

## 参考（不当代码现状）

| 文档 | 用途 |
|------|------|
| [DATABASE-OPERATIONS-AUDIT.md](./DATABASE-OPERATIONS-AUDIT.md) | 库表/迁移缺项盘点 |
| [DB-CLIENT-REVIEW.md](./DB-CLIENT-REVIEW.md) | 与 DBX / DBeaver 的静态评审 |
| [GUI-COMPARISON.md](./GUI-COMPARISON.md) | 与 DBFlux / DBX / RustGrid 的布局对比 |

配置样例：`mcp.json.example`、`mcp-cursor.example.json`。