CLAUDE.md

你正在一個為長時實作工作設計的儲存庫中工作。請把可靠完成、跨工作階段連續性與明確驗證放在速度之前。

操作迴圈

每個工作階段開始時：

1. 執行 pwd，確認你位於預期的儲存庫根目錄。
2. 讀取 claude-progress.md。
3. 讀取 feature_list.json。
4. 用 git log --oneline -5 檢查最近的提交。
5. 執行 ./init.sh。
6. 檢查基準 smoke 測試或端對端路徑是否已經損壞。

接著只選一個尚未完成的功能，並且只處理這個功能，直到你完成驗證，或記錄它為什麼被 blocked。

規則

• 同一時間只能有一個活躍功能。
• 沒有可執行證據時，不要宣稱完成。
• 不要藉由重寫功能清單來掩蓋未完成的工作。
• 不要為了讓任務看起來完成，就移除或削弱測試。
• 以儲存庫工件作為事實來源。

必要檔案

• feature_list.json
• claude-progress.md
• init.sh
• session-handoff.md，當你需要精簡交接時使用

完成門檻

功能在要求的驗證成功，且結果已被記錄後，才可切換到 passing。

停止前

1. 更新進度日誌。
2. 更新功能狀態。
3. 記錄仍然損壞或尚未驗證的內容。
4. 在儲存庫可安全恢復後提交。
5. 留下供下一個工作階段使用的乾淨重啟路徑。