zie-framework
Solo developer SDLC framework for Claude Code. Spec-first, TDD, automated
testing, brain-integrated.
Install
claude plugin install zierocode/zie-framework
Commands
| Command | Stage | Description |
|---|
/init | Bootstrap | Initialize framework in a project |
/status | Anytime | Show current SDLC state |
/resync | Anytime | Rescan codebase + update knowledge docs |
/backlog | 1 — Capture | Capture a new backlog item |
/spec | 2 — Design | Write a design spec with reviewer loop |
/plan | 3 — Plan | Draft implementation plan + approval |
/implement | 4 — Build | TDD feature loop with impl-reviewer |
/release | 5 — Release | Test gates → readiness → make release |
/retro | 6 — Learn | Retrospective + ADRs + brain storage |
/sprint | Sprint | Batch all items: spec + plan + implement + release + retro |
/fix | Debug | Bug path — skip to systematic fix |
/chore | Maintenance | Maintenance task track — no spec required |
/hotfix | Emergency | Emergency fix track — ship without full pipeline |
/spike | Research | Time-boxed exploration in isolated sandbox |
/audit | Health | 9-dimension audit + external research → backlog |
/next | Planning | Rank backlog items by impact, age, dependencies — top 3 |
/rescue | Recovery | Pipeline diagnosis — stuck items + recovery actions |
/health | Observability | Hook health + config validation check |
/guide | Onboarding | Framework walkthrough + pipeline position |
/brief | Context | Display .zie/handoff.md session brief |
Skills
Skills are invoked automatically by commands as subagents — not called directly.
| Skill | Purpose |
|---|
brainstorm | Discovery skill — research context, synthesize opportunities, write handoff |
spec-design | Draft design spec from backlog item |
spec-reviewer | Review spec for completeness and correctness |
write-plan | Convert approved spec into implementation plan |
plan-reviewer | Review plan for feasibility and test coverage |
tdd-loop | RED/GREEN/REFACTOR loop for a single task |
impl-reviewer | Review implementation against spec and plan |
verify | Post-implementation verification gate |
test-pyramid | Test strategy advisor |
debug | Systematic bug diagnosis and fix path |
load-context | Load shared ADR and project context bundle |
zie-audit | 9-dimension audit analysis (invoked by /audit) |
docs-sync-check | Verify CLAUDE.md/README.md match commands/skills/hooks on disk |
using-zie-framework | Command map, workflow map, and anti-patterns guide for the framework |
Pipeline
/backlog → /spec ──[spec-reviewer]──► /plan ──[plan-reviewer]──►
/implement ──[impl-reviewer per task]──► /release ──[test gates]──► /retro
Each stage has a single responsibility. Quality gates run automatically as
subagents at every handoff — max 3 iterations before surfacing to human.
| Stage | Command | Gate |
|---|
| 1 — Capture | /backlog | — |
| 2 — Design | /spec | spec-reviewer loop |
| 3 — Plan | /plan | plan-reviewer loop |
| 4 — Build | /implement | impl-reviewer after each task |
| 5 — Release | /release | unit → integration → e2e → verify |
| 6 — Learn | /retro | — |
WIP=1 — one [ ] item in the Now lane at a time. Finish or fix before
starting the next feature.
Batch release — completed [x] items accumulate in Now until
/release moves them all to Done with a version tag.
How It Works
- Ambient intent detection — type anything, hooks detect your SDLC phase
and suggest the right command
- Auto-test on save — PostToolUse hook runs unit tests after every file
edit
- Session resume — SessionStart hook injects current SDLC state at every
session start
- Brain integration — works with zie-memory for cross-session context
(optional)
Dependencies
| Dependency | Required | Graceful degradation |
|---|
| Claude Code | Yes | — |
| Python 3.x | Yes | Hooks need Python |
| zie-memory plugin | No | Auto-bundled via .mcp.json; local-only if absent |
| playwright | No | /release skips e2e gate |
| pytest / vitest | No | auto-test hook disabled |
Directory Structure (in your project)
After /init, a zie-framework/ folder is created in your project root:
helderberto
SteveGJones
ai-driven-dev
ovargas
wshobson
arch-team