エージェント指示書を作成する
テンプレート: ${CLAUDE_PLUGIN_ROOT}/templates/agent-brief.md。背景:
${CLAUDE_PLUGIN_ROOT}/docs/waves-and-agents.md。
手順
- 事実を収集する(推測しない):
- リポジトリパス、ブランチ、スタック概要(CLAUDE.md)、ゲートコマンド(CLAUDE.mdまたはプロファイル);
- 言語:
build/contracts/locales.jsonを読み、数、ソース言語、最も長い言語(通常はドイツ語またはフィンランド語)、および複数形が多い言語(Intl.PluralRulesがfew/manyを必要とするもの)(設定されていればスクリーンショット用); - データレジデンシー(CLAUDE.md);
- 文字列フォルダ、用語集、変更ログ(最大ID: 「あなたが書いた時点で次に空いている番号」と記載);
- 予約済みマイグレーションスロット、スクラッチDB、ポート、スクラッチフォルダ(ウェーブプランから、または空いているものを選んで記録);
- 最初に調査すべきファイルと、エージェントが所有するファイル。
- ユーザー観点でのゴールを書き、次に具体的なスコープの箇条書きとスコープ外の内容を書く。
- テンプレートのすべてのプレースホルダを埋める。本当に該当しないセクション(例:バックエンドのみのアイテムのスクリーンショット)は削除し、その理由を1行で説明する。
- テンプレートから常設ルールをそのまま維持する: すべての設定言語(複数形を含む)、WCAG 2.2 AA、ライト/ダーク、プライバシーバイデザイン、データレジデンシー、What's newエントリ1つ、STATE.mdセクション、小さく的を絞った編集、commit/push/deploy/cloud禁止、シークレット禁止、エージェントが書くものへのAI帰属表示禁止。
- 数字によるチェックと最後にレポート形式。
- アイテムがセキュリティに敏感な領域(サインイン、トークン、リンク、webhook、エクスポート、テナント境界)に触れる場合は、
${CLAUDE_PLUGIN_ROOT}/docs/security-review.mdの関連行をテスト付きの明示的な受け入れ基準として追加する。 - 指示書を1つのブロックとして出力し、エージェントのプロンプトとして渡せる状態にする。