Teach /init to generate a repo brief with commands and validation steps

概要

/init が単なる AGENTS.md の雛形作成にとどまらず、リポジトリから検出できる build/test/lint/run コマンドや検証手順まで含む「repo brief」を生成できるようにしてほしいです。

背景・課題

OpenAI の公開ガイダンスでも、Codex は「GitHub Issue のように構造化されたプロンプト」や AGENTS.md のような永続コンテキストがあると使いやすくなるとされています。現状の /init は初期セットアップの入口として有用ですが、

• 何を実行すべきか
• どのテストをまず回すべきか
• どのコマンドがこのリポジトリで正しいか

までは埋まらず、結局ユーザーが手作業で整理する必要があります。

参考:

• <https://help.openai.com/en/articles/11096431|Codex CLI Getting Started>
• <https://openai.com/business/guides-and-resources/how-openai-uses-codex/|How OpenAI uses Codex>
• <https://github.com/openai/codex|openai/codex>

提案内容

/init 実行時に、既存の AGENTS.md の草案生成に加えて、リポジトリの実態から以下を推定・要約するオプションを追加します。

• build / test / lint の候補コマンド
• 単体テストの実行方法
• 主要なエントリポイントや注意点
• 生成物を更新する際の安全上の注意点

実装イメージ:

• codex init の既存動作は維持
• --brief または同等のモードで、より構造化された短い repo brief を出力
• package.json / Makefile / pyproject.toml / Cargo.toml などから、実行可能なコマンドを推定
• 推定できない項目は空欄にせず「要確認」として明示
• 既存の AGENTS.md を壊さず、追記候補として提示

受け入れ条件

1. /init で、少なくとも build/test/lint の候補が含まれた短い repo brief を生成できる。
2. 生成内容はリポジトリの実態に基づき、推定不能な項目は明示的に保留できる。
3. 既存の AGENTS.md は破壊せず、レビューしやすい差分として提示される。
4. 個人情報や秘密情報を新たに取り込まない。

代替案

• 既存の AGENTS.md を手で書く運用に寄せる
• ただし初回の摩擦が大きく、Codex の導入効果が出にくいです。
• /init とは別に専用の /brief コマンドを追加する
• 分離はきれいですが、入口が増えて初学者には分かりにくくなります。

影響範囲

• Codex CLI の /init
• 生成される AGENTS.md / repo brief
• ドキュメントと初回 onboarding
• 新規利用者と、既存リポジトリを Codex 対応させたい利用者

追加情報

現在の Codex では、構造化されたプロンプトと永続コンテキストが有効だと案内されています。一方で、/init が生成するのはまだ「入口の雛形」に近く、実際に作業を始めるためのコマンド情報までは十分に埋まりません。ここを埋めると、初回の往復が減って、ユーザーがすぐ実務に入れます。