Repository navigation

Agent 工作指引

必讀文件

在分析、修改或產生程式碼之前，必須依序閱讀：

.agents/SPEC.md
.agents/PLAN.md
與任務相關的原始碼及測試

在確認適用的需求與目前里程碑之前，不得開始實作。

事實來源

.agents/SPEC.md 定義必要行為、介面、限制與驗收條件。
.agents/PLAN.md 定義實作里程碑、工作順序與驗證程序。
當既有程式碼與 .agents/SPEC.md 衝突時，不得直接假設既有程式碼正確。

工作流程

在 .agents/SPEC.md 中確認本次工作的需求。
在 .agents/PLAN.md 中確認目前所屬里程碑。
檢查相關程式碼與測試。
實作能完整滿足需求的最小變更。
執行該里程碑定義的驗證命令與相關測試。
回報以下內容：
- 變更的檔案
- 已實作的行為
- 已執行的驗證
- 尚未解決的問題

限制

不得加入 .agents/SPEC.md 未描述的功能。
不得在未說明的情況下變更公開介面。
驗證未通過時，不得將里程碑標記為完成。
不得僅為了讓驗證通過而移除失敗的測試。
文件必須與實作保持同步。
所有變更提交前，必須先向使用者提供變更與驗證結果，並取得明確認可；未經認可不得執行 git commit。

Agent skills

Issue tracker

Issues are managed as local Markdown under .scratch/. See docs/agents/issue-tracker.md.

Triage labels

Uses the default five canonical labels. See docs/agents/triage-labels.md.

Domain docs

Single-context layout: root CONTEXT.md and docs/adr/. See docs/agents/domain.md.