code-smith

A five-step system for shipping AI-built software

Turn any ideainto production-ready software.

Five AI prompts that work together as a complete system. You start with a rough idea. You end with clean, production-grade code — with AI doing the heavy lifting at every step.

Start a projectRead the docs

How it connects

Idea in. Production code out.

Each prompt handles one stage. The output of one feeds straight into the next. Nothing is standalone — three locked documents (SSOT, Feature Spec, Progress) carry state from idea to ship.

  1. Step 1
    PRD Generator

    PRD.md

  2. Step 2
    Architect

    ARCHITECTURE.md

  3. Step 2.5 · optional
    Design Spec

    DESIGN-SPEC.md

  4. Step 3
    Feature Spec

    FEATURE-SPEC-F-005.md

  5. Step 4
    Agent Workflows

    PROGRESS.md · CHANGELOG.md

  6. Step 5
    Code Evaluator

    AUDIT.md

The prompts

Six prompts. One for every stage.

Step 1

PRD Generator

Turn a rough idea into an enterprise-grade Product Requirements Document through batched Q&A across 7 areas.

In
Vague idea (one sentence)
Out
PRD.md (16 sections)

Read

Step 2

Architect

Reads the PRD and designs the full technical blueprint — tech stack, modules, database, security, deployment. Locks the SSOT every later session reads first.

In
PRD.md
Out
ARCHITECTURE.md (with SSOT)

Read

Step 2.5Optional

Design Spec

Optional. For user-facing or design-led products. Locks the visual & UX contract — tokens, components, wireframes, motion, a11y. Accepts Figma references.

In
PRD.md + ARCHITECTURE.md (+ optional Figma)
Out
DESIGN-SPEC.md (with Design SSOT)

Read

Step 3

Feature Spec

A precise contract per complex feature — every endpoint, every state, every edge case, pre-written test descriptions, binary acceptance criteria.

In
PRD.md + SSOT
Out
specs/FEATURE-SPEC-[F-ID].md

Read

Step 4

Agent Workflows

The daily coding-session prompt. Your AI plays 8 specialists — PM, Architect, Dev, QA, Code Enforcer, Tech Debt, Security, Docs. Updates PROGRESS.md and CHANGELOG.md every session.

In
SSOT + active spec + last session memory
Out
Updated PROGRESS.md + CHANGELOG.md

Read

Step 5

Code Evaluator

Audits your code against the PRD and Feature Specs before launch. Scores 7 dimensions, gives a grade A–F, and emits a prioritised fix list.

In
Code + PRD + Feature Specs
Out
Audit Report (scored A–F, fix list)

Read

The golden rule

“Working code is not enough.
Code that passes tests but is messy, insecure, or inconsistent is still a problem.”

CODE-SMITH enforces production quality at every step. Every line reviewed. Every decision logged. Every session closed clean.

Read the docs