/init

• ~/.solo-factory/defaults.yaml

  — org-level (bundle IDs, GitHub org, Apple Team ID). Shared across all projects.

• .solo/

  in project — founder philosophy, dev principles, STREAM calibration, selected stacks. Per-project but usually the same.

solo-factory/templates/

Output Structure

~/.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

  reads

  defaults.yaml

  for

  <org_domain>

  ,

  <apple_dev_team>

  placeholders +

  .solo/stacks/

  for stack templates

• /validate

  reads

  manifest.md

  for manifesto alignment check

• /setup

  reads

  dev-principles.md

  for workflow config

• /stream

  reads

  stream-framework.md

  for decision framework

Steps

1. Check existing config

• Read

  ~/.solo-factory/defaults.yaml

  — if exists, show current values
• Check if

  .solo/

  exists in project path
• If both exist, ask: "Reconfigure from scratch?" or "Keep existing and skip?"
• If neither exists, continue to step 2

2. Determine project path

$ARGUMENTS

3. Ask org defaults (AskUserQuestion, 5 questions)

references/questions.md

4. Create org defaults

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. Ask Round 1 — Philosophy & Values (AskUserQuestion, 4 questions)

references/questions.md

6. Ask Round 2 — Development Preferences (AskUserQuestion, 4 questions)

references/questions.md

7. Ask Round 3 — Decision Style & Stacks (AskUserQuestion, 3 questions)

references/questions.md

8. Load default templates + generate personalized files

references/generation-rules.md

• Template source locations
• Output file structure (defaults.yaml, manifest.md, stream-framework.md, dev-principles.md, stacks/)
• Personalization rules per file (how answers map to generated content)
• Stack template mapping (answer → YAML file)

10. Verify Solograph MCP (optional check)

• Try running

  uvx solograph --help

  or check if MCP tools are available
• If available: "Solograph detected — code graph ready"
• If not: "Tip: install Solograph for code search across projects (

  pip install solograph

  or

  uvx solograph

  )"

11. Summary

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

Edge cases

references/generation-rules.md

Common Issues

Templates directory not found

solo-factory/templates/

Stacks not copied to .solo/

templates/stacks/

/init

defaults.yaml already exists