Subagent Maintenance

• Cursor: .cursor
• Claude Code: .claude
• Codex: .codex

Subagent作成判断:

• 以下の条件を満たす場合のみAgents/にSubagentを作成する:
  • コンテキスト非依存: 親コンテキストを保持せずに実行する意義がある
  • Skill携帯: 1つ以上のSkillを skills: で指定できる
  • 独立性: 並列実行、バックグラウンド処理、外部検索等で価値を発揮
• 単なる評価・チェックのみが目的の場合は作成しない（Skill内評価で対応）

生成:

• ./questions/subagent_maintenance_questions.md に従い入力を確定する。
• operation=edit（既存Subagentの保守）では、特別な指示がない限り既存の機能/挙動/情報に干渉せず、フォーマット（型）整形に限定する（削除/無効化はユーザー明示指示時のみ）。
• operation=delete はユーザーが明示した場合のみ実施する。
• 公式仕様に従ったフロントマター形式を維持する。
• エージェントの必須セクション区切りを崩さない。

Subagent新規作成時のフォーマット:

• 新規Subagent作成時は以下の形式に従う:

  ---
  name: agent-name
  description: "エージェントの専門領域と自動委譲のトリガー説明"
  skills: skill1, skill2, skill3
  ---
  
  # Agent Name
  
  エージェントの詳細な役割、専門性、いつClaudeが呼び出すべきかの説明。
  
  ## Expertise Overview
  - 専門領域1
  - 専門領域2
  - 専門領域3
  
  ## Critical First Step
  タスク実行前に必ず行うべき手順（ドキュメント取得など）
  
  ## Domain Coverage
  - 対応可能なタスク1
  - 対応可能なタスク2
  
  ## Response Format
  期待される出力形式と引用要件
  
  ## Quality Assurance
  検証ステップとエラーハンドリング
  

• 保存先: {{AGENT_CONFIG_DIR}}/agents/{agent-name}.md
• 必須: skills: フィールドに1つ以上のSkillを指定すること

skillsを使うSubagentの場合:

• skills: フィールドに指定するSkillが存在することを確認する
• 該当Skillに ## Subagent Execution セクションが必要であることを伝える（サブエージェントパス、用途、入出力を明記）
• Skill側の更新が必要な場合は skill-maintenance ワークフローで対応する

CLAUDE.md / AGENTS.md への追記:

• 新規Subagent作成時は以下を確認・追記すること:
  • ワークフロー索引: 該当フェーズに追記（必要な場合）
  • パス辞書: 必要なパスパターンがあれば patterns: セクションに追記
• 追記後、python3 scripts/update_agent_master.py --source cursor --force で3環境同期を実施する。

検証:

• フロントマターの必須フィールド（name, description, skills）が存在することを確認する。
• 必要に応じて ./assets/agent_check_report_template.md 形式で検証ログを作成する。

QC（必須）:

• 共通QC Subagent（qa-skill-qc）に評価・チェックを委譲する。
• qa-skill-qc は最初に ./evaluation/evaluation_criteria.md をReadし、以下を中心にQCを実施する:
  • フロントマター仕様準拠
  • 必須セクション維持
  • skills整合性（指定Skillが存在するか）
  • Subagent設計原則への適合
• 評価結果を成果物末尾に追記する（修正有無/理由）。
• 重大な問題がある場合は修正し、再度 qa-skill-qc でQCする（最大3回）。

バックログ反映:

• 次アクション（3環境同期、レビュー依頼、ロールバック準備等）を抽出しバックログへ反映する。
• 反映先・編集制約・差分提示は AGENTS.md / CLAUDE.md の全体ルールに従う。