記して、形にして、
磨き続ける。

ここでは、すでに開発を進めているランディングページ（LP）のリポジトリ landing-page に、SpecDojo を後から加える例で進めます。landing-page は npm で開発していて、npm run dev で表示を確かめ、npm run build でビルドできるものとします。landing-page とは別に、記録を置くプロジェクト用のリポジトリを作り、SpecDojo を開発用の依存として入れます。

mkdir landing-page-workspace
mkdir landing-page-workspace/landing-page-specdojo
git -C landing-page-workspace/landing-page-specdojo init
cd landing-page-workspace/landing-page-specdojo
npm init -y
npm install --save-dev specdojo

質問に答えると、設定（プロジェクト ID は prj-0001）、登録簿、人と AI の名簿、AI に実行させるための設定、オーケストレーターを起動する npm script がまとめて作られます。使う AI ツール（provider）と、AI に実行させるか（exec）を尋ねられたら、Claude Code の場合は claude と「はい」を選びます。

npx specdojo init

SpecDojo には、会話を CLI の操作に置き換えてくれる対話型オーケストレーターが入っています。初期設定で追加された script で起動します。ほかの provider を選んだ場合は、次の script で起動します。

npm run orch:opus

やりたいことを、そのまま伝えます。オーケストレーターがコマンドに置き換え、実行する前に内容を見せて確認を求めます。

• あなた

  問い合わせで同じ質問が続いている。LP によくある質問の節を加えたいので、todo として起票して。

• オーケストレーター

  次を実行します。よろしいですか。

  npx specdojo register add --project prj-0001 --type todo \
    --title "LP によくある質問（FAQ）の節を加える"

• あなた

  お願いします。

作業だけでなく、気づいた問題（issue）や決めたいこと（decision）も、思いついたときに起票できます。起票した項目は個票（Markdown）として保存され、一覧にまとまります。「今の状況は？」と聞けば、状況の確認もできます。

• あなた

  そういえば、SNS で共有したときの画像もない。issue として記録して、一覧を作って。

• オーケストレーター

  次を実行します。よろしいですか。

  npx specdojo register add --project prj-0001 --type issue \
    --title "SNS で共有したときに表示される画像（OGP）がない"
  npx specdojo register build --project prj-0001

• あなた

  お願いします。

開発中の LP（landing-page）を、設定の repos に宣言します。宣言したリポジトリだけを、AI が読み書きできます。追加したらオーケストレーターを起動し直します。AI の作業は commit 済みの内容から作る作業領域で行うため、ここまでの設定と個票は commit しておきます。

• あなた

  LP のリポジトリ ../landing-page を、このプロジェクトにつないで。

• オーケストレーター

  specdojo.config.json の repos に landing-page を追加します。よろしいですか。

• あなた

  お願いします。

完了条件が、そのまま AI への指示になります。作業はタスクごとの作業領域（git worktree）で行うので、失敗しても手元の LP は汚れません。実装した AI とは別の AI が検証の結果から報告をまとめます。成功すると、landing-page には FAQ の変更が、プロジェクトのリポジトリには計画・報告・状態の記録が、それぞれ commit されて統合されます。

• あなた

  FAQ の完了条件は、料金・導入期間・サポートなど問い合わせの多い 5 つの質問に答えていること、ページ上部のメニューから FAQ へ移動できること、npm run build が通ること。書けたら AI に実行させて。

• オーケストレーター

  個票に完了条件を書き、次を実行します。よろしいですか。

  npx specdojo exec run --project prj-0001 --register PJR-XXXX --worktree \
    --executor-by claude-executor --reporter-by claude-reporter

• あなた

  お願いします。

• オーケストレーター

  成功しました。landing-page とプロジェクトのリポジトリの両方に、exec(register PJR-XXXX) の commit が入っています。項目は確認待ち（review）です。

AI がまとめた報告で完了条件ごとの検証結果を読み、landing-page を手元で動かして FAQ の表示を確かめます。

• あなた

  報告を見せて。

• オーケストレーター

  完了条件ごとの結果です。5 つの質問への回答、メニューからの移動、npm run build のいずれも満たしています。表示は npm --prefix ../landing-page run dev で確かめられます。

確かめて気づいた改善点を次の項目として起票し、FAQ の項目は完了にします。どちらもプロジェクトのリポジトリに commit されます。起票から実行、確認、完了までの経過は、決めた理由と一緒に同じ台帳に残り、次の周回は手順 2 から回せます。始める手順で記録した OGP 画像の issue も、同じ流れで取りかかれます。

• あなた

  FAQ は条件どおり。ただ、スマートフォンだと回答が長くて読みにくい。改善を todo として起票して、FAQ のほうは完了にして。

• オーケストレーター

  次を実行します。よろしいですか。

  npx specdojo register add --project prj-0001 --type todo \
    --title "FAQ の回答をスマートフォンで読みやすくする" --commit
  npx specdojo register close --project prj-0001 --id PJR-XXXX \
    --conclusion "FAQ の節を加え、問い合わせの多い 5 つの質問に答えた" --commit

• あなた

  お願いします。