# 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/` 由本文件覆蓋）。