AGENTS.md

このリポジトリは長時間実行されるコーディングエージェント作業用に設計されています。目標は 生のコード出力を最大化することではありません。目標は、次のセッションが推測なしに 続けられる状態でリポジトリを残すことです。

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

コードを書く前に：

1. pwd で作業ディレクトリを確認する。
2. claude-progress.md で最新の検証済み状態と次のステップを読む。
3. feature_list.json を読み、最優先の未完了機能を選択する。
4. git log --oneline -5 で最近のコミットを確認する。
5. ./init.sh を実行する。
6. 新しい作業を始める前に必要なスモークまたはエンドツーエンド検証を実行する。

ベースライン検証が既に失敗している場合、まずそれを修正する。壊れた開始状態の上に 新しい機能作業を積み上げないこと。

ワーキングルール

• 一度に一つの機能に取り組む。
• コードを追加しただけで機能を完了とマークしない。
• ブロッカーが狭範囲のサポート修正を強制しない限り、選択した機能スコープ内に変更を留める。
• 実装中に検証ルールを黙って変更しない。
• チャットサマリーより永続的なリポジトリ成果物を優先する。

必須成果物

• feature_list.json：機能状態の真実の情報源
• claude-progress.md：セッションログと現在の検証済みステータス
• init.sh：標準の起動・検証パス
• session-handoff.md：大きなセッション用のオプションのコンパクトな引き継ぎ

完了の定義

機能は以下がすべて true の場合にのみ完了：

• ターゲット動作が実装されている
• 必要な検証が実際に実行された
• 証拠が feature_list.json または claude-progress.md に記録されている
• リポジトリが標準起動パスから再起動可能である

セッション終了時

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

1. claude-progress.md を更新する。
2. feature_list.json を更新する。
3. 未解決のリスクやブロッカーを記録する。
4. 作業が安全な状態になったら説明的なメッセージでコミットする。
5. 次のセッションがすぐ ./init.sh を実行できるようリポジトリをきれいに残す。