背景

作業の記録は日々のログに残している。決定事項も進捗も気づきも、全部そこにある。

困っていたのは再開のときだ。AIとのセッションを始めるたびに「いまどこまで進んでいて、何が残っているか」を伝える必要があり、直近のログを何本も読んでもらうことになる。ログは時系列なので、同じ件の最新の状態を探すには後ろの追記まで読まないと分からない。ちょっと不満に思っていた。

三つに分ける

Codexから、プロジェクトごとにSTATUS.mdを置く提案があり、採用した。

READMEは構成と使い方。STATUSは現在地と残タスク。ログは経緯。この三つに役割を分ける。

STATUSに書くのは、いまの状態、次にやることを最大3件、人の判断待ち、根拠になるログへのリンク、再開時に読むファイル。多く書かない。残タスクが3件を超えたら、ログを見に行けばよい。

全部のフォルダに一律には作らず、直近で作業がある案件から入れた。最初は14か所。完了した単発の作業には作らない。

書き方の約束

ひとつ大事にしたのが、「生成した」「確認した」「公開・配布した」を分けて書くこと。ファイルを作っただけなのか、動くことを見たのか、人に渡したのか。ここが混ざると、次回の自分が「できている」と思い込む。

根拠が無いことは「要確認」と書く。古い未完了は、最新の追記で解消したか撤回したかを明記する。

運用に組み込む

ルールだけ作っても読まれない。共通の指示書に「開始時はSTATUSを読む」「終了時はログとSTATUSを更新する」と書き、終了処理のコマンドにもSTATUSの更新を組み込んだ。

AGENTS.mdに統一したときに、このルールもClaudeとCodexの両方に渡るようになった。

感想

STATUS.mdを作り現場を記録することを提案してくれたのは、ちょっと不満に思っていたことだったのでよかった。これからセッションの開始が楽になりそうだし、そのときのトークン消費量も減りそう(ほんと?)と思った。