claymork

Stamp a Claude-driven Django project. Push it. Walk away. Come back to a built MVP.

claymork init my-project
cd my-project
gh repo create me/my-project --source . --private --push

# inside Claude Code:
/prd                  # interactive PRD authoring → docs/PRD.md
/roadmap-from-prd     # decomposes PRD into GitHub issues + pinned roadmap

# back in shell:
./autopilot.sh --verbose

That's it. Claude reads the roadmap, picks the next unblocked issue, plans → codes → tests → reviews → merges, ticks the box, exits, and the loop spawns a fresh Claude for the next one. Stops when the roadmap is empty.

Install

git clone https://github.com/robert197/claymork ~/.claymork
ln -s ~/.claymork/bin/claymork /usr/local/bin/claymork
claymork doctor

You need git, gh, docker, claude on your PATH.

What gets stamped

my-project/
├── CLAUDE.md            stack, conventions, design tokens — your single source of truth
├── Makefile             docker-first dev CLI (up, migrate, test, lint, validate)
├── autopilot.sh         the loop: fresh Claude process per issue
├── .ralph/PROMPT.md     loop contract: assess → plan → work → review → compound → ship
├── .claude/skills/      9 bundled skills (see below)
└── docs/                plans/, solutions/, brainstorms/, roadmap-template.md

Bundled skills

Run from inside Claude Code with /skill-name.

/prd	Interactive PRD authoring → docs/PRD.md.
/roadmap-from-prd	Decompose PRD into GitHub issues + pinned roadmap, rewire project files.
/next-issue	Pick next unblocked roadmap item, branch it.
/done-issue	Validate, PR, merge, tick roadmap, return to main.
/status	Where the build stands.
/validate	make lint && make test && make manage CMD=check.
/brainstorm	Capture intent before /ce:plan.
/estimation	RICE + Fibonacci sizing.
/new-django-app	Scaffold a Django app.
/new-model	Model + admin + migration + factory + tests.
/new-view	View + URL + template + tests.

Plus the compound-engineering plugin's /ce:plan, /ce:work, /ce:review, /ce:compound.

How the loop works

roadmap (pinned issue with - [ ] items + ← #deps)
        ↓
   autopilot.sh ── fresh `claude` process every iteration
        ↓
 .ralph/PROMPT.md
   1. assess + recover from any crash
   2. resume in-progress branch
   3. pick next unblocked roadmap item
   4. /ce:plan      → docs/plans/
   5. /ce:work      → TDD, tests after every change
   6. /ce:review    → multi-agent
   7. /ce:compound  → docs/solutions/ if non-obvious
   8. ship          → push, PR, merge, tick roadmap
   9. exit          → loop spawns fresh process
        ↓
   0 issues → <promise>MVP_COMPLETE</promise>

Fresh process per iteration = bounded context, predictable cost, clean recovery. State lives in git, the roadmap issue, and docs/ — not in Claude's memory.

Customize

Everything stamped is plain text. Edit CLAUDE.md for stack & tokens, .ralph/PROMPT.md for the loop contract, any .claude/skills/*/SKILL.md for per-project workflows. The framework gets out of the way once stamped — your project has zero runtime dependency on claymork.

Docs

• Quickstart
• Ralph loop — mechanics, fresh-process rationale, circuit breakers
• Compound engineering — the 5-step pipeline
• Skills — bundled + writing your own
• Customizing — change stack, swap skills, add hooks
• Architecture — deeper why

CLI

claymork init <slug>     stamp a new project
claymork upgrade         re-copy bundled skills + ralph contract into existing project
claymork skills          list bundled skills
claymork doctor          check toolchain
claymork --version

Credits

Distilled from real Django builds — misscrowd (crowdfunding) and baky (property inspections).

License

MIT.