AGENTS.md

這個倉庫面向長時運行的 coding agent 工作流。目標不是儘可能快地產出代碼，而是讓每一輪會話結束後，下一個會話仍然能無猜測地繼續工作。

開工流程

寫代碼前先做這些事：

1. 用 pwd 確認當前目錄。
2. 讀取 claude-progress.md，瞭解最新已驗證狀態和下一步。
3. 讀取 feature_list.json，選擇優先級最高的未完成功能。
4. 用 git log --oneline -5 看最近提交。
5. 運行 ./init.sh。
6. 在開始新功能前，先跑必需的 smoke test 或端到端驗證。

如果基礎驗證一開始就失敗，先修基礎狀態，不要在壞的起點上繼續疊新功能。

工作規則

• 一次只做一個功能。
• 不要因為“代碼已經寫了”就把功能標記為完成。
• 除非為了消除當前 blocker 的窄範圍修復，否則不要擴大到其他功能。
• 實現過程中不要悄悄改弱驗證規則。
• 優先依賴倉庫裡的持久化檔案，而不是聊天記錄。

必需檔案

• feature_list.json：功能狀態的唯一事實來源
• claude-progress.md：會話進度和當前已驗證狀態
• init.sh：統一的啟動與驗證入口
• session-handoff.md：較長會話可選的交接摘要

完成定義

一個功能只有在以下條件都滿足時才算完成：

• 目標行為已經實現
• 要求的驗證真的跑過
• 證據記錄在 feature_list.json 或 claude-progress.md
• 倉庫仍然能按標準啟動路徑重新開始工作

收尾

結束會話前：

1. 更新 claude-progress.md
2. 更新 feature_list.json
3. 記錄仍未解決的風險或 blocker
4. 在工作處於安全狀態後，用清晰的提交信息提交
5. 保證下一輪會話可以直接運行 ./init.sh