Skip to content
← all systems

Claude Workflow Framework

8-phase spec-driven SDLC framework that AI assistants follow on every project - with the rule that AI never commits code.

8 phases · 6 reusable templates

role
Author
stack
Claude Code · workflow framework · templates
status
oss

// 01 - PROBLEM

AI-assisted development without structure produces inconsistent patterns, undocumented decisions, repeated mistakes and incomplete implementations. This framework gives the assistant a disciplined process to follow instead of improvising.

// 02 - APPROACH

  • An 8-phase cycle: session init, discovery, requirements, planning, implementation, testing, documentation, review.
  • 6 reusable templates: ADR, lessons learned, testing strategy, component docs, project overview, manual test checklist.
  • Lessons-learned tracking: failed approaches get documented so they are not repeated.

// 03 - ARCHITECTURE

AI never commits code
Git stays under human control. The assistant proposes; the human owns the history - the governance principle that makes the rest trustworthy.

// 04 - PRODUCTION-GRADE

  • Battle-tested across real client and personal projects
  • Playwright plus manual testing strategy built into the phases
  • Documentation is a phase, not an afterthought

// 05 - ARTIFACTS