AGENTS.md

このリポジトリは長時間実行されるコーディングエージェントの作業に最適化されています。このファイルは短く保ち、巨大な指示のダンプではなく、記録のシステム文書へのルーティング層として使用してください。

スタートアップワークフロー

コードを変更する前に：

1. pwd でリポジトリルートを確認する。
2. 現在のシステムマップと厳格な依存ルールを確認するため ARCHITECTURE.md を読む。
3. どのドメインやレイヤーが最も弱いかを確認するため docs/QUALITY_SCORE.md を読む。
4. docs/PLANS.md を読み、作業中のアクティブプランを開く。
5. docs/product-specs/ の関連するプロダクト仕様を読む。
6. このリポジトリの標準ブートストラップと検証パスを実行する。
7. ベースライン検証が失敗している場合、スコープを追加する前にベースラインを修復する。

ルーティングマップ

• ARCHITECTURE.md: ドメインマップ、レイヤーモデル、依存ルール
• docs/design-docs/index.md: 設計上の決定とコアビリーフ
• docs/product-specs/index.md: 現在のプロダクト動作と受け入れ基準
• docs/PLANS.md: プランのライフサイクルと実行プランのポリシー
• docs/QUALITY_SCORE.md: プロダクトドメインとレイヤーの健全性
• docs/RELIABILITY.md: ランタイムシグナル、ベンチマーク、再起動の期待値
• docs/SECURITY.md: シークレット、サンドボックス、データ、外部アクションのルール
• docs/FRONTEND.md: UIの制約、デザインシステムルール、アクセシビリティチェック

ワーキングコントラクト

• 一度に一つの境界付けられたプランまたはフィーチャースライスから作業する。
• コードの検査だけで作業完了とマークしない。実行可能な証拠が必要である。
• 動作を変更した場合、同じセッションで対応するプロダクト、プラン、または信頼性の文書を更新する。
• 繰り返しのレビューフィードバックが見られた場合、チャットで再説明するのではなく、機械的なルール、チェック、またはリンターに昇格させる。
• 生成された素材は docs/generated/ に、ソース参照は docs/references/ に配置する。
• このファイルを肥大化させるのではなく、小さく最新の文書を追加することを優先する。

完了の定義

変更は以下のすべてが満たされた場合にのみ完了とみなされる：

• ターゲット動作が実装されている
• 必要な検証が実際に実行された
• 証拠が関連するプランまたは品質文書にリンクされている
• 影響を受ける文書が最新の状態である
• リポジトリが標準スタートアップパスからクリーンに再起動できる

セッションの終了

セッションを終了する前に：

1. アクティブな実行プランを更新する。
2. ドメインやレイヤーに意味のある変更があった場合、docs/QUALITY_SCORE.md を更新する。
3. 債務を先送りした場合、docs/exec-plans/tech-debt-tracker.md に新しい債務を記録する。
4. 適切なタイミングで終了したプランを docs/exec-plans/completed/ に移動する。
5. 次のアクションが明確な再起動可能な状態でリポジトリを残す。