chrome-bridge: Instructions file for Codex

AGENTS.md

このリポジトリで作業するエージェント向けのガイドラインです。

作業前に読むもの

あらゆるタスクを開始する前に、下記を必ず把握してください。

• README.md
• SPEC.md — protocol と tool の規範仕様
• 下の「タスク一覧」と、着手するタスクの tasks/ ファイル

完了タスク・実測値・過去の意思決定を辿るときは HISTORY.md を参照し、 設計知識・公開契約・作業手順は docs/ を正典とします。

タスク管理の使い分け

• tasks/ — タスク。終わりがあり、達成したらファイルを消すもの。 今すぐ着手できるものと、 kiarina の判断・作業を待っているもの（頼む・思い出してもらうのはエージェントの仕事）を置く。 1 タスク 1 ファイルで、背景・やること・進捗・申し送りをそのファイルに直接記載する
• waiting/ — 待ち。ストアの審査、上流のリリース、相手の返事、日付など、外の条件を待っているもの。 1 件 1 ファイルで、待っているもの・確かめ方・確かめる目安（日付）・満たされたらやること・経緯を書く。 確かめ方と目安は、そのファイルだけ読めば実行できるように書く。必要になったときにリポジトリのルートに作る
• routines/ — ルーチン。監視・保守・終わりのない統括など、繰り返し実行して終わらないもの。 1 ルーチン 1 ファイルで、目的・手順・現在の状態（次に実行する目安日を含む）を保つ。必要になったときにリポジトリのルートに作る
• HISTORY.md — 完了した作業、実測値、過去の意思決定
• docs/ — 設計知識、公開契約、再利用する手順
• 各 component の CHANGELOG.md — 配布物ごとの利用者向け変更履歴

どちらに置くか迷ったら、完了条件を 1 行で書けるかで決めます。書けるならタスク、書けないなら ルーチンです。ルーチンの中から完了条件のある作業が生まれたら、タスクとして切り出します。

運用ルール:

• タスクに着手したら、進捗・未検証の懸念・踏んだ落とし穴・次の一手を該当の tasks/ ファイルへ直接追記する
• 新しいタスク（kiarina が着手を決めるだけの将来候補も含む）は tasks/ に、外の条件を待つものは waiting/ に、 新しいルーチンは routines/ にファイルを作り、下の「タスク一覧」へ 1 行追記する
• タスクが外の条件待ちに入ったら、そのタスクは終わり。 成果・実測値・判断を HISTORY.md へ移して タスクファイルを消し、waiting/ に待ちを 1 件作る。大きいタスクの一部だけが待ちなら、その部分だけを切り出す
• 待ちの条件が満たされたら waiting/ のファイルを消し、次の作業を新しいタスクとして tasks/ に起こす （その場で片付く小ささなら片付けて HISTORY.md へ）。waiting/ から tasks/ へ移し戻さない。 確かめてまだなら「確かめる目安」を更新するだけ
• タスクが完了したら、実測値・意思決定を HISTORY.md へ、再利用する知見を該当する docs/ へ移した上で、タスクファイルを削除し、「タスク一覧」から行を消す。 削除したファイルの全文は git 履歴で辿れるため、転記は要点だけで良い
• ルーチンの実行の記録は HISTORY.md に残し、ルーチンのファイルには次回も使う目的・手順・ 現在の状態だけを保つ
• ルーチン自体が不要になったときは、終了理由と必要な実測値・意思決定を HISTORY.md へ 移した上で、ルーチンのファイルと「タスク一覧」の行を削除する

ドキュメントの扱い

現在の状態・仕様・方針を表す記述の矛盾は放置せず、発見したら解消してください。 どちらが正しいか根拠から判断できる場合は、正典と影響する記述を更新します。判断できない 場合は、修正する前に必ずユーザーへ相談します。特に次の食い違いを対象とします。

• ドキュメント間で仕様が食い違っている
• 同じものが別の名前で呼ばれている
• ユーザーの指示とドキュメントの記述が食い違っている
• 実装とドキュメントの記述が食い違っている

誤字、リンク切れ、実在しないパス、実装済みだが記載が漏れている事項など、判断を伴わない ものは相談せずに直して構いません。役割の分担、名称の方針、値の定義など判断が要るものは 相談します。