/scaffold

Scaffold a complete project from PRD + stack template. Creates directory structure, configs, CLAUDE.md, git repo, and pushes to GitHub. Studies existing projects via SoloGraph for consistent patterns, uses Context7 for latest library versions.

Steps

1. Parse arguments from $ARGUMENTS — extract <project-name> and <stack-name>.

   • If not provided or incomplete, use AskUserQuestion to ask for missing values.
   • Show available stacks from templates/stacks/*.yaml (source of truth). If MCP project_info available, also show detected stacks from active projects. List stack names with one-line descriptions from each YAML's description field.
   • Project name should be kebab-case.

2. Load org defaults from ~/.solo-factory/defaults.yaml:

   • Read org_domain (e.g. com.mycompany), apple_dev_team, github_org, projects_dir
   • If file doesn't exist, ask via AskUserQuestion:
     • "What is your reverse-domain prefix for bundle IDs?" (e.g. com.mycompany)
     • "Apple Developer Team ID?" (optional, leave empty if no iOS)
   • Create ~/.solo-factory/defaults.yaml with answers for future runs
   • Replace <org_domain>, <apple_dev_team>, <github_org> placeholders in all generated files

3. Load stack + PRD + principles:

   • Look for stack YAML: search for stacks/<stack>.yaml in plugin templates (via kb_search or Glob).
   • If stack YAML not found, use built-in knowledge of the stack (packages, structure, deploy).
   • Check if PRD exists: docs/prd.md or search current directory for prd.md
     • If not: generate a basic PRD template
   • Look for dev principles: search for dev-principles.md or use built-in SOLID/DRY/KISS/TDD principles.

4. Study existing projects via SoloGraph (learn from your own codebase — critically):

   Before generating code, study active projects with the same stack. Don't blindly copy — existing projects may have legacy patterns or mistakes. Evaluate what's actually useful.

   a. Find sibling projects — use project_info() to list active projects, filter by matching stack. Example: for ios-swift, find existing projects with matching stack.

   b. Architecture overview — codegraph_explain(project="<sibling>") for each sibling. Gives: directory layers, key patterns (base classes, protocols, CRUD), top dependencies, hub files.

   c. Search for reusable patterns — project_code_search(query="<pattern>", project="<sibling>"):

   • Search for stack-specific patterns: "MVVM ViewModel", "SwiftData model", "AVFoundation recording"
   • Search for shared infrastructure: "Makefile", "project.yml", ".swiftlint.yml"
   • Search for services: "Service protocol", "actor service"

   d. Check shared packages — codegraph_query("MATCH (p:Project)-[:DEPENDS_ON]->(pkg:Package) WHERE p.name = '<sibling>' RETURN pkg.name"). Collect package versions for reference (but verify with Context7 for latest).