onboard-agent

必須の準備

/agent-workflow を呼び出してください。ここにはワークフローの原則、アンチパターン、コンテキスト収集プロトコルが含まれています。作業を進める前にプロトコルに従ってください。ワークフローのコンテキストがまだ存在しない場合は、まず /teach-maestro を必ず実行してください。

---

新しいエージェントワークフローをゼロから構築するか、既存のシステムに新しいエージェントを追加します。

ステップ 1：規約を定める

## Workflow Conventions
### Prompt Format
- Delimiter style: [XML tags / markdown headers / triple-dash]
- Section order: [System → Context → Instructions → Input]
- Output format: [JSON with schema / markdown template]

### Tool Conventions
- Naming: [verb_noun / noun.verb / camelCase]
- Description template: [What → When → When Not → Returns]
- Error format: [{ code, message, details }]

### Logging
- Format: [JSON structured]
- Required fields: [workflow_id, step, timestamp, level]

### File Structure
- Prompts: [prompts/workflow-name/v1.md]
- Tools: [tools/tool-name.{ext}]
- Config: [config/environment.yaml]
- Tests: [tests/workflow-name/]

ステップ 2：初期構成を作成する

project/
├── prompts/          # System prompts, versioned
├── tools/            # Tool definitions
├── config/           # Environment-specific configuration
├── tests/            # Golden test sets and evaluation suites
├── logs/             # Runtime logs (gitignored)
└── .maestro.md       # Workflow context

ステップ 3：最初のエージェントを作成する

1. システムプロンプト：制約を含む役割の定義
2. 必須ツール 2～3 個：実用最小限のツールセットから始める
3. 出力スキーマ：想定される出力形式を定義する
4. ゴールデンテストを 1 つ：正解がわかっているテストケースを少なくとも 1 つ用意する
5. 基本的なエラー処理：構造化されたエラーレスポンス
6. ロギング：各実行の構造化ログ出力

ステップ 4：検証する

• ゴールデンテストケースでエージェントを実行する
• エラー処理が機能することを検証する（不正な入力を送信する）
• ロギングで有用なコンテキストが記録されることを検証する

次のステップの推奨

オンボーディング後、まず /diagnose を実行してベースラインのヘルスチェックを行い、次に /fortify を実行して本番環境に対応したエラー処理を追加します。

絶対に行わないこと：

• 規約を定めずに構築を始める
• 説明なしでツールを作成する
• ゴールデンテストケースを省略する
• 初期エージェントのスコープを広げすぎる（最小限から始め、後で拡張する）