Environment Setup

Edge Cases

Setup Workflow

flowchart TD
    A([Start: tech_stack + project_description + os_target]) --> B{Windows w/o WSL?}
    B -- Yes --> C[Generate PowerShell + Bash scripts]
    B -- No --> D
    C & D --> E{Use Docker?}
    E -- Yes --> F[docker-compose as primary\nmanual fallback]
    E -- No --> G[Manual setup as primary]
    F & G --> H[Prerequisites List\nTools + Versions + Install per OS]
    H --> I[Setup Script\nIdempotent + DB setup + Env copy + Health check]
    I --> J{External deps?}
    J -- Yes --> K[Include sandbox creds in .env.example]
    J -- No --> L
    K & L --> M[.env.example\nVars + Comments + Local examples + Markers]
    M --> N[README Setup Section\nSteps + Expected output + Troubleshooting]
    N --> O[Verification Steps\nService checks + Tests + Server check]
    O --> P([Output: Prerequisites + Setup script\n+ .env.example + README + Verification])

Examples

• Input Example
• Output Example

Quality Gate

1. Is the setup script idempotent?
2. Are all required variables documented?
3. Are OS-specific install commands included?
4. Is there a clear verification path?
5. is the README section concise?

MCP Dependencies

• @upstash/context7-mcp: Library documentation and examples.

Changelog