agent-navigation-sop

エージェントのナビゲーション手順書

この手順書は、開発者向けの AGENTS.md ファイルを詳細にマッピングすることで、/init コマンドを補完します。

## フェーズ 1：詳細分析 エージェントは基本的なディレクトリスキャン（opencode はすでにツリーを認識しています）を省略し、以下に集中する必要があります。

1. ツールとスクリプト：ビルド、テスト、Lint、型チェックの一回限りのコマンドを特定します。
2. プロセス上の制約：除外する開発サーバーとウォッチモードを特定します。
3. 規約：プロジェクト固有の命名規則、アーキテクチャパターン、独自のエラー処理を特定します。

フェーズ 2：AGENTS.md の作成

約 50 行の高密度な出力を目標にします。

1. ビルドとテスト（手順）

• コピーして実行できる一回限りのコマンドを列挙します。
• dev、watch、または対話型のコマンドを含めてはなりません。

2. 制約とパターン（ルール）

• 重要：エージェントは、ブロッキングプロセス（開発サーバー、ウォッチモード）の実行を明示的に禁止しなければなりません。
• エージェントが変更すべきでない読み取り専用または制限付きのパスを特定します。
• リポジトリ固有のコーディングパターン（例：「Bun API を使用する」「クラスより関数型を優先する」）を記載します。

3. タスクの振り分け（ルーティング）

• よくあるタスク（機能追加、バグ修正）を、特定のディレクトリおよび関連するテストに対応付けます。
• 内容を重複して記載するのではなく、パッケージレベルの詳細についてはネストされた AGENTS.md ファイルを参照します。
• 繰り返し発生するタスクを特定し、エージェントの機能を拡張するために skill-creator を使って新しいスキルを作成するよう提案します。

- エージェントは環境メタデータ（日付、OS、絶対パス）を繰り返してはなりません。 - 約 50 行の出力を**強く推奨**します。 - エージェントは RFC 2119 のキーワード（MUST、MUST NOT、SHOULD、STRONGLY RECOMMENDED）を使用しなければなりません。 - エージェントは「アクセス制約」（読み取り専用ファイル／フォルダー）を優先しなければなりません。 - エージェントは長時間実行またはブロッキングするプロセスを記載してはなりません。 - エージェントは一回限りの検証コマンド（ビルド、Lint、テスト、型チェック、コード生成）を記載しなければなりません。 - エージェントの動作を変えない説明文を含めてはなりません。