solo-setup

/setup

既存の PRD と CLAUDE.md からプロジェクトのワークフロー設定を自動生成します。対話形式の質問はありません。回答は、/scaffold の実行後にすでに存在するプロジェクトデータからすべて抽出されます。

使用するタイミング

/scaffold でプロジェクトを作成した後、/plan の実行前に使用します。/plan と /build が動作できるように docs/workflow.md を作成します。

MCP ツール（利用可能な場合に使用）

• project_info(name) — プロジェクトの詳細と検出されたスタックを取得します
• kb_search(query) — 開発原則、マニフェスト、スタックテンプレートを検索します
• codegraph_query(query) — コードグラフでプロジェクトの依存関係を確認します

MCP ツールが利用できない場合は、ローカルファイルの読み取りのみを行います。

手順

1. プロジェクトルートを検出します。

   • $ARGUMENTS が指定されている場合は、現在のディレクトリまたは ~/.solo-factory/defaults.yaml の projects_dir に、その名前のプロジェクトがあるかを確認します。
   • それ以外の場合は、現在の作業ディレクトリを使用します。
   • ディレクトリが存在し、CLAUDE.md があることを確認します。
   • 見つからない場合は、AskUserQuestion を使って質問します。

2. 初期化済みかどうかを確認します。

   • docs/workflow.md が存在する場合は、警告を表示して再生成するかどうかを尋ねます。

3. プロジェクトデータを読み取ります（並行して、すべてを一度に読み取ります）。

   • CLAUDE.md — 技術スタック、アーキテクチャ、コマンド、禁止事項と推奨事項
   • docs/prd.md — 課題、ユーザー、ソリューション、機能、指標、価格設定
   • package.json または pyproject.toml — 正確な依存関係のバージョン
   • Makefile — 利用可能なコマンド
   • リンター設定（.eslintrc*、eslint.config.*、.swiftlint.yml、ruff.toml、detekt.yml）

4. エコシステムの情報源を読み取ります（任意 — 品質が向上します）。

   • CLAUDE.md からスタック名を検出します（「Stack:」または技術セクション内のスタック名を確認します）。
   • MCP の kb_search が利用可能な場合は、スタックテンプレートと開発原則を検索します。
   • それ以外の場合は、.solo/ またはプラグインのテンプレートディレクトリ（アクセス可能な場合）から、stacks/<stack>.yaml と dev-principles.md + dev-principles-my.md（個人用の拡張）を探します。
   • どちらも利用できない場合は、CLAUDE.md とパッケージマニフェストからすべての情報を導き出します（これで十分です）。

5. パッケージマニフェストから言語を検出します。

   • package.json → TypeScript
   • pyproject.toml → Python
   • *.xcodeproj または Package.swift → Swift
   • build.gradle.kts → Kotlin

6. 必要に応じて docs ディレクトリを作成します。

   mkdir -p docs
   

7. docs/workflow.md を生成します。 開発原則（MCP/KB または組み込みのデフォルト設定）に基づきます。

   # Workflow — {ProjectName}
   
   ## TDD Policy
   **Moderate** — Tests encouraged but not blocking. Write tests for:
   - Business logic and validation
   - API route handlers
   - Complex algorithms
   Tests optional for: UI components, one-off scripts, prototypes.
   
   ## Test Framework
   {from package manifest devDeps: vitest/jest/pytest/xctest}
   
   ## Commit Strategy
   **Conventional Commits**
   Format: `<type>(<scope>): <description>`
   Types: feat, fix, refactor, test, docs, chore, perf, style
   
   ## Verification Checkpoints
   **After each phase completion:**
   1. Run tests — all pass
   2. Run linter — no errors
   3. Run build — successful (if applicable)
   4. Manual smoke test
   
   ## Branch Strategy
   - `main` — production-ready
   - `feat/<track-id>` — feature branches
   - `fix/<description>` — hotfixes
   

8. CLAUDE.md を更新します — 「Key Documents」セクションにワークフローへの参照がない場合は追加します。

9. 概要を表示し、次のステップを提案します。

   Setup complete for {ProjectName}!
   
   Created:
     docs/workflow.md — TDD moderate, conventional commits
   
   Next: /plan "Your first feature"
   

よくある問題

CLAUDE.md が見つからない

原因： プロジェクトがスキャフォールディングされていないか、誤ったディレクトリから実行しています。 対処法： 先に /scaffold を実行するか、CLAUDE.md があるプロジェクトルートにいることを確認してください。

workflow.md がすでに存在する

原因： 以前にセットアップされています。 対処法： スキルが警告を表示し、再生成するかどうかを尋ねます。上書きを確認しない限り、既存のファイルは保持されます。

誤ったテストフレームワークが検出される

原因： devDependencies に複数のテストフレームワークがあります。 対処法： スキルは最初に見つかったものを選びます。正しいフレームワークを指定するには、docs/workflow.md を手動で編集してください。