プロジェクト文書
ワークフロー
- 実際の実装や診断を開始する前に、
docs/CURRENT_HANDOFF.mdと安定した文書の該当セクションのみを読む。 - 文書の主張を現在のリポジトリの証拠と照合して検証する。
- 探索中または読み取り専用レビュー中は、ユーザーが変更を許可しない限り、ドリフトを報告するだけで編集しない。
- タスク開始時に、
CURRENT_HANDOFF.mdの現在の目標と次のアクションを置き換える。 - 検証済みのマイルストーン達成後、現在の状態と検証証拠を置き換える。タイムラインは追加しない。
- ハンドオフ前に、完了したプロセスの詳細を削除し、継続可能な状態を1つだけ残す。
BLUEPRINT.mdは、製品の意図、ユーザー、スコープ、制約、または受入基準が変更された場合にのみ更新する。ARCHITECTURE.mdは、コンポーネント、境界、データフロー、検証済みコマンド、デプロイ、ロールバック、またはリスクが変更された場合にのみ更新する。- 重要な成果物を納品する前に、
python3 .agents/skills/project-docs/scripts/docs_lint.pyを実行する。
境界
- 現在のコード、テスト、設定、コマンド出力、およびユーザー指示は、これらの文書よりも優先される。
- BLUEPRINT は160行以下に保つ。
- ARCHITECTURE は160行以下に保つ。
- CURRENT_HANDOFF は80行以下に保つ。
- AGENTS は90行以下に保つ。
- Git が履歴を保存する。CURRENT_HANDOFF は最新の動作状態のみを保存する。