bootstrap

ブートストラップ

価値： コミュニケーション — 作業を始める前に、環境、機能、ワークフローについて共通認識を確立します。

目的

あらゆるハーネスで SDLC ワークフローを設定するための単一のエントリーポイントです。プロジェクト環境とハーネスの機能を検出し、TDD モード（ガイド付きまたは自動）を設定して、ハーネスに適した指示ファイルを生成し、スキルを推奨します。確認なしに何かをインストールしたり変更したりすることはありません。

プラクティス

ステップ 1：環境を検出する

質問をする前に、プロジェクトのコンテキストをユーザーに気づかれない形で収集します。

!test -f package.json && echo "js" || true
!test -f Cargo.toml && echo "rust" || true
!test -f pyproject.toml && echo "python" || true
!test -f go.mod && echo "go" || true
!test -f mix.exs && echo "elixir" || true
!git rev-parse --is-inside-work-tree 2>/dev/null && echo "git" || true
!ls skills/*/SKILL.md 2>/dev/null | sed 's|skills/||;s|/SKILL.md||' || true

検出した言語、git の利用可否、すでにインストールされているスキルを記録します。言語ファイルが見つからない場合は「なし」と記録し、ステップ 5 でユーザーに尋ねます。

ステップ 2：ハーネスの機能を検出する

委譲のプリミティブ（references/capability-detection.md を参照）の有無を調べます。Agent ツールとスキルの連鎖を確認します（いずれも常に利用可能です）。

ステップ 3：ハーネスの種類を検出する

適切な指示ファイルを生成できるよう、ハーネスを特定します。

シグナル	ハーネス
CLAUDE.md の規約、Claude Code ツール	Claude Code
AGENTS.md の規約、Codex ツール	Codex
.cursor/rules ディレクトリ	Cursor / Windsurf
いずれにも該当しない	汎用（AGENTS.md のみ）

ステップ 4：TDD モードを設定する

検出した機能に合わせて戦略を選びます。

検出された機能	戦略	デフォルトモード
Agent ツール	サブエージェント	自動
どちらもなし	連鎖	自動

連鎖は常に利用可能で、単一のコンテキスト内で TDD の全フェーズを順番に実行します。ガイド付きモード（/tdd red、/tdd green など）は、ユーザーが操作する代替手段として常に利用できます。ユーザーが上書きできるようにします。

Claude Code が検出され、ユーザーが最大限の強制力を望む場合は、skills/tdd/references/hooks/ のオプションのフックテンプレートをインストールするよう提案します。

ステップ 4b：ファクトリーモードを検出する

pipeline スキルがインストールされているか（skills/pipeline/SKILL.md が存在するか）確認します。検出された場合、ファクトリーパイプラインモードを利用でき、ステップ 5 に追加の質問が含まれます。

ステップ 5：ユーザーに尋ねる

質問 1：何をしようとしていますか？

• 「新しいプロジェクトを開始する」— Understand + Decide + Build の各フェーズを推奨します
• 「機能を追加する、またはバグを修正する」— Build + Ship の各フェーズを推奨します
• 「チームのワークフローを設定する」— すべてのフェーズに加えて、アンサンブルチームを推奨します

質問 2：プロセスの構造化をどの程度にしますか？

• 「最小限」— tdd、domain-modeling を推奨します
• 「標準」— コアスキル + ship スキルを推奨します
• 「フル」— すべてのスキルを推奨します（pipeline が検出された場合はファクトリーパイプラインのスキルを含めます）

質問 3（pipeline が検出された場合のみ）：自律性のレベルはどれにしますか？ 保守的／標準／フル。選択したレベルで .factory/config.yaml を生成します。スキルの一覧は references/skill-recommendations.md を参照してください。

ステップ 6：タスク追跡の規約

生成する指示ファイルには、単純に見えるタスクであっても、エージェントがタスクリスト（TaskCreate、TaskList、または同等のハーネスツール）を使用して作業を追跡するよう記載します。単純なタスクからサブタスクが見つかることはよくあります。また、タスクリストを可視化することで進捗の透明性を保ち、手順の見落としを防げます。

この規約は AGENTS.md の「Conventions」セクションに記載します（references/agents-md.md を参照）。task-management スキルがインストールされている場合は、そのスキルを参照します。インストールされていない場合は、基本的な規約を直接記載します。

Step 7: スキルごとの AGENTS.md への追加内容を収集する

インストール済みのスキルの中には、AGENTS.md に追加する内容を指定した references/agents-md-setup.md ファイルを含むものがあります。このファイルを含むスキルがインストールされているか、すべて確認します。

!for skill in skills/*/; do
  test -f "${skill}references/agents-md-setup.md" && echo "${skill}"
done

このファイルを含むスキルごとに、その agents-md-setup.md を読み、該当スキル用の管理マーカー（``）を使って、指定された内容を AGENTS.md に取り込みます。セットアップファイルには、追加または追記するセクションと、内容のテンプレートが記載されています。

サイズ上限： AGENTS.md 全体を 32 KiB 未満に保つ必要があります。スキルごとの追加内容は、箇条書き数項目か短いセクションにまとめてください。追加内容の合計が上限を超える場合は、内容を要約し、詳細については該当スキルを参照するよう案内してください。

Step 8: 指示ファイルを生成する

ハーネスに適したファイルを生成します。Claude Code の場合、単一の信頼できる情報源を保ち、重複を避けるため、CLAUDE.md ではシンボリックリンクや内容の埋め込みではなく、@AGENTS.md 参照を使用します。AGENTS.md のベストプラクティス（小規模なルーティング文書、段階的な情報開示、管理マーカー）については references/agents-md.md を、ハーネスごとの生成ルールについては references/harness-files.md を参照してください。

Step 9: アンサンブルチーム（任意）

ユーザーが「チームワークフローをセットアップ」または「フル」を選択した場合は、3 つのプリセット（solo-plus、lean、full）を備えた ensemble-team スキルを提案します。

Step 10: コミットして表示する

生成したファイルをステージングし、説明的なメッセージを付けてコミットしてから、以下を表示します。

• 設定した内容（ハーネス、TDD モード、推奨スキル）
• 次のステップ（TDD サイクルを開始する /tdd、またはフェーズ固有のコマンド）
• アンサンブルチームを設定した場合は、プリセットとメンバー数

適用に関する注意

すべてのモードで助言のみを行います。Bootstrap は検出して推奨しますが、通知せずに変更を加えることはありません。ユーザーの明示的な確認 [H] なしに、スキルや設定がインストールされることはありません。

制約

• 「通知せずにインストールしない」 [H]：「上書き」とは、ユーザーが「X をインストールしてください」と明示することを意味します。文脈から許可を推測してはいけません。
• AGENTS.md の 32 KiB 上限：目標ではなく厳守すべき上限です。上限内に収まるよう要約してください。

検証

• 質問する前に環境を検出した
• ハーネスの機能を確認した（推測していない）
• 質問数が 2～3 問を超えていない
• TDD 戦略が検出された機能に適合している（Step 4 の表を参照）
• 生成ファイルに、再実行しても安全な管理マーカーを使用している
• 生成された AGENTS.md にタスク追跡の規約が含まれている
• スキルごとの AGENTS.md への追加内容を収集して取り込んだ
• ユーザーの確認なしに何もインストールしていない

依存関係

このスキルは単独で動作します。他のスキルを推奨しますが、必須ではありません。 TDD ワークフロー向けに tdd スキルを参照する設定を生成します。