first commit

docs/AGENTS.md

@@ -0,0 +1,29 @@
+# docs/AGENTS.md
+
+## Purpose
+
+專案的設計規格與實作計劃文件。
+
+## Ownership
+
+- 擁有 `docs/` 全樹，包括 `docs/superpowers/specs/` 同 `docs/superpowers/plans/`。
+
+## Local Contracts
+
+- **設計權威**：`superpowers/specs/` 係已確認的設計規格，係設計決策的權威來源。實作與 spec 有出入時，以 spec 為準，或先更新 spec。
+- **實作計劃**：`superpowers/plans/` 用 checkbox 追蹤進度；計劃與實際實作有偏差時同步更新。
+- **檔名**：`YYYY-MM-DD-<slug>.md`。
+- 內容繁體中文（廣東話）。
+
+## Work Guidance
+
+- 做大改動前先讀對應 spec / plan；完成後如設計有變，更新文件而唔係留低過時描述。
+- 呢啲係設計記錄，唔係日常 diary；只記穩定決策同計劃。
+
+## Verification
+
+無自動化檢查；靠人工對照 spec 同實作。
+
+## Child DOX Index
+
+無（`superpowers/` 由本文件覆蓋）。