solo-init

/init

初回のみの創業者オンボーディングです。重要な質問を行い、パーソナライズされた設定ファイルを生成します。すべて読みやすい Markdown/YAML 形式で保存され、いつでも編集できます。

設定は 2 層構成です。

• ~/.solo-factory/defaults.yaml — 組織レベルの設定（バンドル ID、GitHub 組織、Apple Team ID）。すべてのプロジェクトで共有されます。
• プロジェクト内の .solo/ — 創業者の理念、開発原則、STREAM の調整内容、選択したスタック。プロジェクトごとの設定ですが、通常はどのプロジェクトでも同じです。

solo-factory/templates/ のテンプレートはデフォルトです。このスキルは回答に基づいてテンプレートをパーソナライズします。

solo-factory のインストール後に一度実行してください。再実行しても問題ありません。現在の値を表示し、更新できます。

出力構成

~/.solo-factory/
└── defaults.yaml              # Org defaults (bundle IDs, GitHub, Team ID)

.solo/
├── manifest.md                # Your founder manifesto (generated from answers)
├── stream-framework.md         # STREAM calibrated to your risk/decision style
├── dev-principles.md          # Dev principles tuned to your preferences
└── stacks/                    # Only your selected stack templates
    ├── nextjs-supabase.yaml
    └── python-api.yaml

ほかのスキルは次の情報を読み取ります。

• /scaffold は defaults.yaml から <org_domain>、<apple_dev_team> のプレースホルダーを、.solo/stacks/ からスタックのテンプレートを読み取ります
• /validate はマニフェストとの整合性チェックのために manifest.md を読み取ります
• /setup はワークフロー設定のために dev-principles.md を読み取ります
• /stream は意思決定フレームワークのために stream-framework.md を読み取ります

手順

1. 既存の設定を確認する

• ~/.solo-factory/defaults.yaml を読み取ります。存在する場合は現在の値を表示します
• プロジェクトのパスに .solo/ が存在するか確認します
• 両方存在する場合は、「最初から再設定しますか？」または「既存の設定を維持してスキップしますか？」と尋ねます
• どちらも存在しない場合は、手順 2 に進みます

2. プロジェクトのパスを決定する

$ARGUMENTS にパスが含まれている場合は、それを使用します。それ以外の場合は、現在の作業ディレクトリを使用します。

3. 組織のデフォルト設定を尋ねる（AskUserQuestion、5 問）

質問の詳細については、references/questions.md →「Round 0: Org Defaults」を参照してください。

4. 組織のデフォルト設定を作成する

mkdir -p ~/.solo-factory

~/.solo-factory/defaults.yaml に書き込みます。

# Solo Factory — org defaults
# Used by /scaffold and other skills for placeholder replacement.
# Re-run /init to update these values.

org_domain: "<answer from 3.1>"
apple_dev_team: "<answer from 3.2>"
github_org: "<answer from 3.3>"
projects_dir: "<answer from 3.4>"
knowledge_base_repo: "<answer from 3.5>"

5. Round 1 — 理念と価値観を尋ねる（AskUserQuestion、4 問）

質問の詳細については、references/questions.md →「Round 1: Philosophy & Values」を参照してください。

6. Round 2 — 開発の希望を尋ねる（AskUserQuestion、4 問）

質問の詳細については、references/questions.md →「Round 2: Development Preferences」を参照してください。

7. Round 3 — 意思決定のスタイルとスタックを尋ねる（AskUserQuestion、3 問）

質問の詳細については、references/questions.md →「Round 3: Decision Style & Stacks」を参照してください。

8. デフォルトのテンプレートを読み込み、パーソナライズされたファイルを生成する

以下については、references/generation-rules.md を参照してください。

• テンプレートのソースの場所
• 出力ファイルの構成（defaults.yaml、manifest.md、stream-framework.md、dev-principles.md、stacks/）
• ファイルごとのパーソナライズルール（回答を生成コンテンツに反映する方法）
• スタックテンプレートの対応付け（回答 → YAML ファイル）

10. Solograph MCP を確認する（任意）

• uvx solograph --help の実行を試すか、MCP ツールが利用可能か確認します
• 利用可能な場合：「Solograph を検出しました — コードグラフを利用できます」
• 利用できない場合：「ヒント：プロジェクト横断のコード検索には Solograph をインストールしてください（pip install solograph または uvx solograph）」

11. まとめ

Solo Factory initialized!

Org config:
  Config:         ~/.solo-factory/defaults.yaml
  org_domain:     <value>
  apple_dev_team: <value>
  github_org:     <value>
  projects_dir:   <value>

Founder profile:
  Manifest:       .solo/manifest.md
  Dev Principles: .solo/dev-principles.md
  STREAM:          .solo/stream-framework.md
  Stacks:         .solo/stacks/ (N stacks)

These files are yours — edit anytime.
Other skills read from .solo/ automatically.

Next steps:
  /validate "your idea"          — validate with your manifest
  /scaffold app nextjs-supabase  — scaffold with your stack

例外的なケース

一覧については、references/generation-rules.md →「Edge Cases」を参照してください。

よくある問題

Templates directory not found

原因： solo-factory がサブモジュールとしてインストールされていないか、テンプレートが移動されています。 解決方法： テンプレートが見つからない場合、このスキルは埋め込みの知識から生成します。恒久的に解決するには、solo-factory/templates/ が存在することを確認してください。

Stacks not copied to .solo/

原因： スタックの選択内容がテンプレートファイルに対応していません。 解決方法： templates/stacks/ で利用可能なスタックを確認してください。/init を再実行し、一覧から選択してください。

defaults.yaml already exists

原因： 以前に初期化されています。 解決方法： このスキルは既存の設定を検出し、再設定するかどうかを尋ねます。上書きするには「最初から再設定」を選択してください。