Build real products, really fast, without losing control.

flowchart TD
    idea(["idea"]) --> analysis["idea-analysis<br/>product.md check, then<br/>build, investigate, analyze, or<br/>set creative direction first?<br/>plan mode — wait for go-ahead"]
    idea -. "any time" .-> handoff["handoff<br/>export context to a<br/>new session/agent"]

    analysis -->|"bug, unknown cause"| investigate["investigate"]
    investigate --> findings["./investigations/&lt;name&gt;/findings.md"]
    findings --> back1["back to idea-analysis —<br/>scopes the fix into its own<br/>./spec/&lt;name&gt;/ folder"]
    back1 --> tier{"Tier?"}

    analysis -->|"existing app/design/art/product,<br/>understand it first"| explore["app-analysis /<br/>design-analysis /<br/>art-analysis /<br/>product-analysis"]
    explore --> findings2["./analysis/&lt;name&gt;/<br/>*-findings.md, art-bible.md, product.md"]
    findings2 --> back2["back to idea-analysis —<br/>scopes the work (Design-First)<br/>into its own ./spec/&lt;name&gt;/ folder"]
    back2 --> tier

    analysis -->|"need to originate new<br/>design/art direction"| direct["design-direction /<br/>art-direction<br/>(pre-production)"]
    direct --> predocs["./pre-production/&lt;name&gt;/<br/>design-system.md, art-bible.md"]
    predocs --> back3["back to idea-analysis —<br/>scopes the work into its own<br/>./spec/&lt;name&gt;/ folder"]
    back3 --> tier

    analysis -->|"genuinely new product,<br/>no product.md yet"| proddir["product-design<br/>(dialogue, not delegated<br/>autonomy)"]
    proddir --> proddoc["./spec/&lt;founding&gt;/product.md"]
    proddoc --> back4["back to idea-analysis —<br/>continues scoping with<br/>product.md in hand"]
    back4 --> tier

    analysis -->|"clear feature or fix"| tier

    tier -->|"Light — default"| plan["spec-plan<br/>implementation_plan.md<br/>draft → approve"]
    tier -->|"Full — rare"| fulltier{"Requirements-First or<br/>Design-First?"}

    req["spec-requirements"]
    fulltier -->|"blank slate"| req
    fulltier -->|"existing app/design/art<br/>to ground it in"| explore2["app-analysis /<br/>design-analysis /<br/>art-analysis /<br/>product-analysis<br/>(if not already run)"]
    explore2 --> req

    subgraph full["Full tier — new app / major architecture"]
        direction LR
        req --> tech["spec-tech"] --> design["spec-design"] --> tasks["spec-tasks"]
    end
    tasks -. "spec-sync after edits" .-> sync(("sync"))

    plan --> implement["implement-tasks<br/>implement → verify → check off → commit"]
    full -->|"plan approved"| implement

    implement --> wrap["wrap-up<br/>walkthrough.md, README,<br/>CHANGELOG under Unreleased"]
    wrap --> release["prepare-release — on request<br/>semver bump, cuts Unreleased into a version,<br/>RELEASE_NOTES.md"]