本仓库使用知识工程工作流来管理一个前端 Vue 项目。
开始工作前,必须遵循以下链路:
hook
→ .claude/rules/must-read-claude.md
→ CLAUDE.md
→ knowledge/INDEX.md
→ agents/orchestrator.md
→ agents/skills/
CLAUDE.md 是启动索引。它只指向权威文件,不复制权威正文。
- 本项目是纯前端项目。
- 原始草案只放在
references/wips/。 - 工作必须逐步细化:草案 → MVP → 用户旅程 → 故事 → UI/测试 → 计划 → 实现 → 验证 → 审查/进度更新。
- 必须遵循
knowledge/principles/single-authority.md的唯一单一权威原则:可复用知识进knowledge/,其他文件只引用,不重复正文。
knowledge/INDEX.md:知识地图。knowledge/SOUL.md:价值观和方法论。agents/orchestrator.md:执行编排入口。
当前脚手架:
products/mvp-001/
mvp.md
user-journey-001/
user-journey.md
story-001/
story.md
ui.md
tests.md
plans/
plan.md
qa.md
review.md
progress.md
在声明实现完成前,必须执行 knowledge/qas/ 中相关检查。涉及 UI 改动时,应尽量使用浏览器或 Playwright 验证核心路径。