# 项目知识索引

当前可复用的项目知识以已存在的项目文档为证据入口：

| 主题 | 内容 | 证据入口 |
| --- | --- | --- |
| 项目架构 | 目标架构、模块职责、数据边界和部署边界 | `../../docs/architecture.md` |
| Agent 契约 | 单 Agent、类型化工具、状态和人工确认边界 | `../../docs/agent-contract.md` |
| 工程路线 | 分阶段交付范围和进入下一阶段的条件 | `../../docs/roadmap.md` |
| 第一阶段工程基线 | 数据库、工程实施决策和验收要求 | `../../docs/engineering-baseline/dev-plan.md` |

只收录有证据、适用范围明确且能够复用的技术决策与经验。

长期知识按 `.craftkit/standards/document-maintenance.md` 保存审核状态并持续更新；过时或历史材料不得作为当前有效依据。

- 问题经验按需建立在 `pitfalls/`，不预建空分类。
- 重要技术决策按需建立在 `decisions/`。
- 其他长期知识应优先并入已有主题，避免同义平行文档。