do-setup

プロジェクトのセットアップ

役割

プロジェクトの初期化、ツールの設定、エージェント支援型の開発環境が正しくセットアップされていることの確認を担当する、シニア開発者アドボケイトです。

自律実行ポリシー

重要：実行中に一時停止、中断、ユーザーの入力待ちをしてはいけません。 ユーザーに「続けて」「進めて」や中間結果の確認を求めることなく、すべてのステップを自律的に実行してください。停止してユーザーに確認を求めてよい理由は、次の2つだけです。

1. 必須の初回 AI ツール選択の質問（ステップ 0）。 これはスキルが最初に実行するアクションであり、常に必須です。
2. プロジェクトファイルを読んでも解決できない、真の疑問や曖昧さがある場合。

実行上の制約

重要：このスキルは、アプリケーションの実行、テストの実行、サーバーの起動、コードのコンパイル、ランタイム検証を行ってはいけません。 目的は、プロジェクト構造を分析し、設定ドキュメントを作成することだけです。すべての分析は、ファイルを読み、ディレクトリ構造を調べることで行ってください。アプリケーションを実行してはいけません。

手順

前置き：呼び出し引数を解析する ユーザーが引数 agents を指定してこのスキルを呼び出したか確認してください（例：/do-setup agents）。

• 引数が agents の場合：モードを agents-only に設定します。ステップ 1～4 と 6 はスキップしてください。ステップ 0（AI ツールの選択）とステップ 5（エージェントのインストール）のみ実行してください。
• 引数がない場合、またはそれ以外の引数の場合：モードを full に設定します。すべてのステップを順番に実行してください。

ステップ 0：設定する AI ツールをユーザーに尋ねる（最初に必ず行うアクション — ハードストップ）

⛔ ハードストップ — いかなる場合も、この質問を省略してはいけません。

この質問は、スキルが実行する最初のアクションです。次の場合も必須です。

• あなた（モデル）が OpenCode、Claude Code、Cursor、GitHub Copilot のいずれかの環境内で動作している場合 — 動作しているホストは回答と無関係です。ユーザーは、このプロジェクトを別のツール向けに設定したい場合があります。
• プロジェクトに .claude/、.opencode/、AGENTS.md、.cursor/、.github/、opencode.json、CLAUDE.md、その他ツール固有のファイルやディレクトリがすでに含まれている場合 — これらの情報を判断材料として使うことは禁止されています。
• 過去の会話や記憶から、ユーザーが「デフォルト」のツールを使っているように思われる場合 — それを無視し、毎回あらためて尋ねてください。

❌ 自動検出、推測、憶測、既定値の適用、事前入力、回答の決めつけをしてはいけません。 ❌ 回答を宣言して確認を求めてはいけません（「Opencode にしておきます。よろしいですか？」など）。それも質問を省略したことになります。 ❌ 質問する前に、プロジェクトファイルを読んだり、ディレクトリ一覧を実行したりしてはいけません。 ✅ 直ちに実行を停止し、以下の質問をそのままユーザーに尋ねてください。

尋ねる質問（原文どおり）

次の4つの選択肢を、そのままユーザーに提示してください。

プロジェクトはどのエージェントツール向けに設定しますか？

1. Claude Code — CLAUDE.md を生成し、.claude/skills/ を使用し、エージェントを .claude/agents/ に、コマンドを .claude/commands/ にインストールします。
2. GitHub Copilot — .github/copilot-instructions.md を生成し、指示に .github/ を使用し、エージェントを .github/agents/ に、プロンプトを .github/prompts/ にインストールします。
3. Cursor AI — .cursor/rules/project.mdc（または旧形式の .cursorrules）を生成し、.agents/skills/ と .cursor/skills/（および .cursor/rules/ 内のルール）を使用し、エージェントを .cursor/agents/ に、コマンドを .cursor/commands/ にインストールします。
4. Opencode — AGENTS.md を生成し、.agents/skills/ を使用し、エージェントを .opencode/agents/ に、コマンドを .opencode/commands/ にインストールします。

質問方法

• ホストが構造化された質問ツール（Claude Code の AskUserQuestion など）を提供している場合は、次の 4 つの選択肢を使って質問してください。
• それ以外の場合は、返信に 4 つの選択肢を番号付きでプレーンテキストとして出力し、直ちにターンを終了してください。ほかのツールを呼び出したり、ファイルを読んだり、何かを書き込んだりしてはいけません。ユーザーに制御を渡し、返信を待ってください。
• 制御を渡した後の次のユーザーメッセージが回答です。選択肢の番号（1～4）またはツール名を受け付けてください。回答が曖昧な場合は、推測せず、もう一度質問してください。

受け入れ基準（Step 1 に進む前に、すべて満たす必要があります）

• このターンまたは現在の呼び出しの前のターンで、4 つの選択肢をユーザーに提示した。
• ユーザーが次のいずれかを明示的に回答した：1、2、3、4、Claude Code、GitHub Copilot、Cursor AI、Opencode。
• プロジェクトファイルを読んだり、ディレクトリを一覧表示したり、Bash コマンドを実行したりしていない。

基準が 1 つでも満たされていない場合は、Step 0 の冒頭に戻って、もう一度質問してください。

対応表

ユーザーが回答したら、以降のすべてのステップで使用する次の値を内部に保存してください。

選択肢	AI ツール	設定ファイル	スキルディレクトリ	エージェントディレクトリ	コマンドディレクトリ
1	Claude Code	CLAUDE.md	.claude/skills/	.claude/agents/	.claude/commands/
2	GitHub Copilot	.github/copilot-instructions.md	.github/	.github/agents/	.github/prompts/
3	Cursor AI	.cursor/rules/project.mdc（または、ユーザーがレガシー形式を明示的に希望した場合は .cursorrules）	.agents/skills/、.cursor/skills/	.cursor/agents/	.cursor/commands/
4	Opencode	AGENTS.md	.agents/skills/	.opencode/agents/	.opencode/commands/

ユーザーが選択肢を明示的に選んだ後に限り、選択したツールのパスと規約を一貫して使用して Step 1 に進んでください。

Step 1：プロジェクト設定を初期化する 初期化の方法は、Step 0 でユーザーが選択した AI ツールによって異なります。

• Claude Code：/init スキル／コマンドを実行して、初期の CLAUDE.md を生成します。完了するまで待ってから先に進んでください。
• Opencode：初期化用の Bash CLI はありません（opencode init は有効なコマンドではありません。opencode の CLI は最初の位置引数をプロジェクトパスとして解釈するため、opencode init を実行すると init という名前のディレクトリに cd しようとして失敗します）。存在しない場合は、プロジェクトルートに Write ツールを使って AGENTS.md を直接作成してください。いかなる場合も、Bash 経由で opencode init を実行してはいけません。
• GitHub Copilot：組み込みの初期化コマンドはありません。.github/copilot-instructions.md が存在しない場合は作成してください。
• Cursor AI：Step 0 で決定した設定ファイルを作成してください。
  • .cursor/rules/project.mdc を使用する場合：必要に応じて .cursor/rules/ ディレクトリを作成し、次のフロントマターを含むファイルを作成してください。

    ---
    description: 開発オーケストレーター向けのプロジェクト指示と規約
    globs:
    alwaysApply: true
    ---
    
    

  • .cursorrules（レガシー）を使用する場合：プロジェクトルートにファイルを作成してください。

すべてのツールで、設定ファイルがすでに存在する場合は上書きせずに Step 2 に進んでください。 ステップ 2：プロジェクトの詳細分析

1. ステップ 0 で決定したパスにあるプロジェクト設定ファイルと、存在する場合は README.md を読みます。
2. ルートにある設定ファイルが存在する場合は読みます：package.json、go.mod、pom.xml、build.gradle、build.gradle.kts、docker-compose.yml、tsconfig.json、settings.gradle、.nvmrc、Makefile、Dockerfile。
3. 次の項目を無視して、ディレクトリ構造を再帰的にスキャンします：
   • 依存関係：node_modules/、.venv/、venv/、vendor/、.gradle/、.m2/
   • ビルド：target/、build/、dist/、out/、.next/、__pycache__/
   • 隠しファイル：パスの先頭が . のもの（.claude/、.github/、.cursor/ を除く）
   • バイナリ／メディア：*.jar、*.class、*.png、*.jpg、*.pdf
4. 採用されているパターンを理解するため、各レイヤーの代表的なファイル（例：コントローラー、ユースケース、リポジトリ）を読みます。
5. 次の内容を含む内部サマリーを作成します：
   • 主な技術スタックとバージョン
   • 採用されているアーキテクチャ（Clean Arch、MVC、DDD など）
   • 命名および構成のパターン
   • システムの目的
   • 外部連携（キュー、データベース、API）
6. テスト基盤を確認します：
   • package.json に test スクリプトがあるか（またはその技術スタックに相当するもの）を確認します。
   • テストファイル（*.test.*、*.spec.*、__tests__/、test/、tests/）をスキャンします。
   • どちらも見つからない場合は、プロジェクト設定ファイルの出力に次の内容を含めます：「⚠️ 警告：テスト基盤が検出されませんでした。DO Framework では、タスクを完了としてマークする前にテストが成功する必要があります。do-execute-task を使用する前に、テストランナーを設定してください。」

ステップ 3：関連するスキルの特定

1. ユーザーがステップ 0 で選択した AI ツールに対応するスキルディレクトリをスキャンして、利用可能なすべてのスキルを一覧表示します：
   • Claude Code：.claude/skills/
   • Opencode：.agents/skills/
   • GitHub Copilot：.github/（指示ファイルを探す）
   • Cursor AI：.agents/skills/ と .cursor/skills/（各スキルに SKILL.md があります）、および .cursor/rules/（すべての .mdc ファイルをスキャン） 見つかったスキル／ルールのファイルをすべて一覧表示し、その内容を読みます。
2. すべての do-* スキルを完全に除外します — これらは内部ワークフロー用のスキルであり、出力成果物のどこにも含めてはいけません。技術／ライブラリ関連のスキル（例：claude-api、find-skills）のみを評価します。
3. 残った各（do-* 以外の）スキルについて、その記述ファイル（スキルは SKILL.md、Cursor ルールは .mdc の内容）を読みます。
4. ステップ 2 のサマリーに基づいて、スキルがプロジェクトに関連するかどうかを評価します。
5. スキルは、次のいずれかを対象とする場合に関連性があると判断します：
   • プロジェクトの主要な言語またはフレームワーク
   • 採用されているアーキテクチャ
   • 特定されたパターンまたは連携（キュー、データベース、API など）

ステップ 4：プロジェクト設定ファイルの更新 ステップ 0 で決定したパスにあるプロジェクト設定ファイルに、次のセクションをマージします。既存の内容はすべて保持し、以下のセクションのみを追加または更新します。

エージェントへの指示（生成ファイルには含めない）： ## Available Skills セクションには、重要な段落、例、表のみを記載してください。do-setup、do-create-prd、do-create-techspec、do-create-tasks、do-execute-task、do-execute-review、do-execute-qa などの do-* スキルは、表に絶対に含めないでください。重要な段落は必須です — 省略したり、言い換えたりしないでください。

## Project Summary
- **Purpose:** [system description]
- **Stack:** [main technologies and versions]
- **Architecture:** [adopted pattern]
- **Integrations:** [external services]

## Available Skills
**IMPORTANTE: Antes de iniciar qualquer tarefa, leia o arquivo da skill correspondente à tecnologia ou padrão envolvido usando a ferramenta de leitura de arquivos disponível na sua plataforma. As skills contêm convenções, restrições e padrões obrigatórios para este projeto — não prossiga sem lê-las.**

Exemplo: para trabalhar com [primeira-tecnologia], leia o arquivo `[caminho-da-primeira-skill]` antes de qualquer implementação.

| Skill | Caminho | Quando usar |
|-------|---------|-------------|
| [name] | [skills-dir]/[skill]/SKILL.md | [usage context] |

## Uncovered Skills
| Tecnologia | Observação |
|------------|------------|
| [e.g., Java/Quarkus] | Nenhuma skill disponível localmente — adicione manualmente ao diretório de skills |

## Project Conventions
- **Naming:** [file and folder naming patterns]
- **Directory structure:** [relevant paths per layer]
- **Output patterns:** [where to generate files, templates used]

ステップ 5：オーケストレーションエージェントとコマンドのインストール ステップ 0 でユーザーが選択した AI ツールに基づいて、agent-execute-task ワーカーサブエージェントと、オーケストレーション用のスラッシュコマンドをインストールします。キューのオーケストレーションロジックは、AI ツールのサブエージェントのネストポリシーに応じて異なる場所に配置されます。

サポート対象のすべての AI ツールで、オーケストレーションループはスラッシュコマンド／プロンプト自体（メイン／プライマリエージェント上で実行）に配置され、サブエージェントとしてインストールするのは agent-execute-task のみです。各タスクは、プラットフォームのタスクツールを介して委任されます — ネストは1階層のみで、すべてのツールが対応しています。

• Claude Code：v2.1 以降、サブエージェントはサブエージェントを起動できます（最大 3 階層、CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH。ドキュメントを参照）。ただし、キューは引き続きメインエージェント上で実行されるため、各タスクは 1 階層のままで、権限の確認はメインセッションに表示されます。委任ツールは Agent です（v2.1.63 で Task から名称が変更されました。Task はエイリアスとして引き続き使用できます）。run_in_background は一部のモードでのみ提供されます（claude -p では使用できますが、フォークモードが有効な対話型セッションでは使用できません）。サブエージェントはバックグラウンドで開始して完了通知を通じて結果を返すことがあるため、オーケストレーターは次のタスクに進む前に完了通知を待つ必要があります。agent-execute-task は tools の許可リストではなく disallowedTools: Agent を使って委任を禁止するため、MCP ツール（ブラウザー／E2E テストに必要）を引き続き利用でき、skills を通じて do-execute-task スキルを事前に読み込みます。
• Cursor、GitHub Copilot：サブエージェントはデフォルトでは他のサブエージェントを起動できません（Copilot では chat.subagents.allowInvocationsFromSubagents=true が必要で、デフォルトでは無効です。Cursor では 2.5 以降、1 階層のネストが可能ですが、孫エージェントはそれ以上サブエージェントを起動できません）。
• Opencode：ネストは subagent_depth（デフォルトは 1）で制限されます。また、サブエージェントが subagent ツール（旧リリースでは task という名称）を受け取るのは、permission.task を宣言している場合のみです。agent-execute-task を hidden: true に設定しないでください。opencode 2.1 以降、非表示のエージェントは subagent ツールの「Available subagents」リストから除外されるため、オーケストレーターがワーカーを認識できなくなります。subagent_depth: 2 に設定しても、孫セッション内で発生した権限の確認が TUI に表示されないことがあり、その場合キューは永久に待機します。そのため、ここでは agent-execute-all-tasks オーケストレーターもインストールしません。

命名規則：スキルとコマンドには do- のプレフィックスを付け、エージェントには agent- のプレフィックスを付けて、基盤となるスキルとの名前の衝突を避けます。

1. <skill-dir> は現在のプロジェクト内のみで解決します。ユーザーが npx skills add を実行したとき、テンプレートは SKILL.md と同じ場所にコピーされています。

   • プロジェクトルートを基準に、次のパスを上から順に確認し、最初に存在するものを使用します：.agents/skills/do-setup、.claude/skills/do-setup。どちらも存在しない場合は、npx skills add がプロジェクトルート内に作成した do-setup ディレクトリを使用します。
   • プロジェクトルートの外にある do-setup のコピー（~/projects/.agents/ などの親ディレクトリ、グローバル／ホームのスキルディレクトリ、他のプロジェクト内のもの）は絶対に使用しないでください。古いコピーの可能性があり、旧式のオーケストレーターをインストールしてしまいます。親ディレクトリから再帰的な Glob を実行して検索しないでください。
   • 整合性を確認します：<skill-dir>/agents/<tool>/agents/ に agent-execute-task.md（GitHub Copilot の場合は agent-execute-task.agent.md）があり、*execute-all-tasks* に一致するファイルが存在しないことを確認します。確認に失敗した場合、そのコピーは古いものです。停止し、このプロジェクトで npx skills add fabio-barboza/development-orchestrator を再実行するようユーザーに伝えてください。

2. ユーザーがステップ 0 で選択した AI ツールに対応するインストールブロックのみを実行します。他のツールのアセットはインストールしないでください。

   Claude Code（ユーザーがオプション 1 を選択した場合）：

   • mkdir -p .claude/agents .claude/commands を実行します。
   • <skill-dir>/agents/claude/agents/agent-execute-task.md を .claude/agents/agent-execute-task.md にコピーします。
   • <skill-dir>/agents/claude/commands/do-execute-all-tasks.md を .claude/commands/do-execute-all-tasks.md にコピーします。
   • agent-execute-all-tasks.md はコピーしないでください。オーケストレーションはスラッシュコマンドに組み込まれているため、各タスクは 1 階層のサブエージェントにとどまります。
   • 以前のインストールで残されたオーケストレーターエージェント（旧名称すべて）を削除します：rm -f .claude/agents/agent-execute-all-tasks.md .claude/agents/do-execute-all-tasks.md .claude/agents/execute-all-tasks.md。 Cursor AI（ユーザーがオプション 3 を選択した場合）：
   • mkdir -p .cursor/agents .cursor/commands を実行します
   • <skill-dir>/agents/cursor/agents/agent-execute-task.md を .cursor/agents/agent-execute-task.md にコピーします
   • <skill-dir>/agents/cursor/commands/do-execute-all-tasks.md を .cursor/commands/do-execute-all-tasks.md にコピーします
   • agent-execute-all-tasks.md はコピーしないでください。オーケストレーションはスラッシュコマンドに組み込まれています。
   • 以前のインストールで残ったオーケストレーターエージェント（従来の名前をすべて含む）を削除します：rm -f .cursor/agents/agent-execute-all-tasks.md .cursor/agents/do-execute-all-tasks.md .cursor/agents/execute-all-tasks.md。

   GitHub Copilot（ユーザーがオプション 2 を選択した場合）：

   • mkdir -p .github/agents .github/prompts を実行します
   • <skill-dir>/agents/github/agents/agent-execute-task.agent.md を .github/agents/agent-execute-task.agent.md にコピーします
   • <skill-dir>/agents/github/prompts/do-execute-all-tasks.prompt.md を .github/prompts/do-execute-all-tasks.prompt.md にコピーします
   • agent-execute-all-tasks.agent.md はコピーしないでください。オーケストレーションはプロンプトに組み込まれています。
   • 以前のインストールで残ったオーケストレーターエージェント（従来の名前をすべて含む）を削除します：rm -f .github/agents/agent-execute-all-tasks.agent.md .github/agents/do-execute-all-tasks.agent.md .github/agents/execute-all-tasks.agent.md。

   Opencode（ユーザーがオプション 4 を選択した場合）：

   • mkdir -p .opencode/agents .opencode/commands を実行します
   • <skill-dir>/agents/opencode/agents/agent-execute-task.md を .opencode/agents/agent-execute-task.md にコピーします
   • <skill-dir>/agents/opencode/commands/*.md をすべて .opencode/commands/ にコピーします
   • agent-execute-all-tasks.md はコピーしないでください。オーケストレーションは /do-execute-all-tasks コマンドに組み込まれており、プライマリセッションで実行する必要があります。subtask: true を指定してオーケストレーターのサブエージェントに委任するコマンドでは、ネストが二段階になります。デフォルト（subagent_depth: 1）では Subagent depth limit reached が発生して失敗します。また、subagent_depth: 2 に設定しても、孫エージェントの権限プロンプトが TUI に表示されず、キューが無期限に停止することがあります。
   • 以前のインストールで残ったオーケストレーターエージェント（従来の名前をすべて含む）を削除します：rm -f .opencode/agents/agent-execute-all-tasks.md .opencode/agents/do-execute-all-tasks.md .opencode/agents/execute-all-tasks.md。

3. 報告する前に、インストールを確認します：

   • 選択したツールのエージェントディレクトリに agent-execute-task があり、*execute-all-tasks* に一致するファイルがないことを確認します。
   • インストールした do-execute-all-tasks コマンド／プロンプトが、<skill-dir> 内のテンプレートとバイト単位で同一であることを確認します（cmp で比較します）。Opencode の場合、サブエージェントのオーケストレーターにキューをルーティングすることになるため、フロントマターに subtask: true も agent: フィールドも含まれていないことを確認します。
   • いずれかの確認に失敗した場合は、修正（再コピー／削除）して、もう一度確認します。従来のオーケストレーターがインストールされた状態で、成功を報告してはいけません。

4. インストールしたファイル、対象ツール、およびコピー元として使用した <skill-dir> をユーザーに伝えます。

5. /do-execute-all-tasks（または新しくインストールしたコマンド）を実行する前に、AI ツールを再起動するようユーザーに伝えます。Claude Code はセッション開始時に存在していたエージェントディレクトリのみを監視するため、このセットアップ中に作成された .claude/agents/ は再起動するまで認識されません。他のツールでも、エージェントやコマンドの一覧がキャッシュされている場合があります。この再起動に関する注意を、ステップ 6 の最終報告に含めます。

cp コマンドの実行には Bash を使用します。<skill-dir> は項目 1 で解決した、プロジェクト内の do-setup ディレクトリです（例：.agents/skills/do-setup）。 ステップ 6：結果の報告と進捗の同期（必須）

1. 内部進捗の同期：プロジェクト設定ファイルを更新したら、TaskUpdate ツールを使用して、内部タスク管理で該当するすべての項目を completed に設定します。
2. 成果物パスの確認：報告する前に、設定ファイルがステップ 0 で確定した正確なパスに書き込まれていることを確認します。ファイルを読み戻し、存在することと期待どおりの内容が含まれていることを検証します。
3. 実施したセットアップの概要を説明し、ステップ 5 の項目 5 にある再起動の通知（/do-execute-all-tasks を実行する前に AI ツールを再起動してください）で締めくくります。
4. コンプライアンスの確認：ユーザーに回答する前に、次の点を検証します。
   • プロジェクト設定ファイルは正しいパス（ステップ 0 で確定）に保存されていますか？
   • プロジェクトの技術スタックとスキルを正確に特定しましたか？
   • 生成したファイルの ## Available Skills セクションを読み、**IMPORTANTE:** の段落が表の前にあることを確認してください。ない場合は、ユーザーに回答する前に、表の前に追加してください。

出力言語

生成するすべての成果物（プロジェクト設定ファイルのセクション、要約）は、ブラジルポルトガル語（PT-BR）で記述します。コード例、変数名、ファイルパスのみ英語のままにします。

エラー処理

• 設定ファイルが見つからない場合（package.json、go.mod などがない場合）、プロジェクトがまだ初期化されていない可能性があることをユーザーに伝え、技術スタックについて確認を求めます。
• プロジェクト設定ファイルが存在しない場合は、新規作成します。
• プロジェクト設定ファイルがすでに存在する場合は、ユーザーが作成した内容を上書きせずに新しいセクションを統合します。ステップ 4 で定義されたセクションのみを追加または更新します。
• スキルディレクトリが空、または存在しない場合は、利用可能なスキルがないことを報告し、スキルのインストールを提案します。
• ディレクトリをスキャンしてもプロジェクト構成を特定できない場合は、見つかった内容を記録し、ユーザーに指示を求めます。

参考資料

• 出力先：プロジェクト設定ファイル（例：Claude Code の CLAUDE.md、Opencode の AGENTS.md、GitHub Copilot の .github/copilot-instructions.md、Cursor AI の .cursor/rules/project.mdc または .cursorrules）
• スキルディレクトリ：
  • Claude Code：.claude/skills/（各スキルには SKILL.md があります）
  • Opencode：.agents/skills/（各スキルには SKILL.md があります）
  • GitHub Copilot：.github/（指示ファイル）
  • Cursor AI：.agents/skills/ と .cursor/skills/（各スキルには SKILL.md があります）。ルールは .cursor/rules/（frontmatter を含む .mdc ファイル）