Spec to Repo

功能

• Generates code from natural language project specifications
• Supports stack-agnostic generation (Next.js, FastAPI, Go, Rust, etc.)
• Includes phases for parsing, architecture design, code generation, and validation
• Produces complete, runnable repositories with real code, not stubs
• Automatically generates essential project files like README, .env.example, and CI config

使用场景

• Use when a user provides a text description of an app and wants code
• Use when a user has requirements documentation and needs a codebase
• Use when a user says 'build me an app', 'scaffold this', or 'bootstrap a project'
• Use when a user wants a working starter repo, not just a file tree

非目标

• Not for generating SaaS apps with specific integrations like Stripe + Auth (use dedicated skills)
• Not for filling out existing templates; it interprets specifications to create new code
• Not for generating placeholder code; all functions have real implementations

工作流

1. Parse the natural language specification, extracting key fields like app name, features, tech stack, auth, database, and deploy target.
2. Present a structured interpretation of the spec to the user for confirmation, asking clarifying questions if needed.
3. Design the project architecture, selecting appropriate stack templates, defining the file tree, mapping features, and planning dependencies.
4. Generate all necessary files, ensuring real code, syntactic validity, matching imports, proper environment variable handling, and comprehensive README/CI.
5. Validate the generated project using a checklist and a dedicated script to catch common issues like missing files, secrets, or placeholders.

实践

• Code generation
• Specification interpretation
• Project scaffolding
• Stack selection