DevFlow

Development workflows for Claude Code — spec, implement, review, debug in one command.

Why DevFlow

Claude Code is powerful but workflows are manual — you write ad-hoc prompts, lose context on every restart, and repeat the same review steps across projects.

DevFlow adds structured commands that handle the full lifecycle: specify features, implement with exploration and planning, review with multiple perspectives, and debug with parallel investigation. Session memory persists automatically across restarts and compaction.

Features

• Structured code review — multiple specialized reviewers (security, architecture, performance, and more)
• Full-lifecycle implementation — spec, explore, plan, code, validate, refine in one command
• Automatic session memory — survives restarts, /clear, and context compaction
• Parallel debugging — competing hypotheses investigated simultaneously
• 24 quality skills — 11 auto-activating, plus specialized review and agent skills

Quick Start

npx devflow-kit init

Then in Claude Code:

/review

Commands

Plugin	Command	Description
devflow-specify	/specify	Interactive feature specification with clarification gates
devflow-implement	/implement	Complete task lifecycle — explore, plan, code, validate, refine
devflow-review	/review	Multi-perspective code review with severity classification
devflow-resolve	/resolve	Process review issues — fix or defer to tech debt
devflow-debug	/debug	Parallel hypothesis debugging
devflow-self-review	/self-review	Self-review workflow (Simplifier + Scrutinizer)
devflow-core-skills	(auto)	Auto-activating quality enforcement skills

Command Details

/specify

Guides you through defining a feature with three mandatory gates:

1. Understanding Gate - Confirm the feature idea is understood
2. Scope Gate - Validate priorities and boundaries
3. Acceptance Gate - Confirm success criteria

Creates a GitHub issue with well-defined requirements ready for /implement.

/implement

Executes a single task through the complete development lifecycle:

1. Exploration — analyze codebase for relevant patterns and dependencies
2. Planning — design the implementation approach
3. Implementation — write code on a feature branch
4. Validation — run build, typecheck, lint, and tests
5. Refinement — simplify and review for quality
6. Alignment Check — verify implementation matches the original request

Creates a PR when complete.

/review

Multi-perspective code review with specialized reviewers:

• Core: Security, Architecture, Performance, Quality
• Conditional (activated when relevant): TypeScript, React, Accessibility, Database, Dependencies, Documentation
• Findings classified as must-fix, should-fix, or nit with severity and confidence levels

Provides actionable feedback with specific file locations and suggested fixes.

/debug

Investigates bugs using competing hypotheses:

1. Hypothesis Generation — identify 3-5 plausible explanations
2. Parallel Investigation — each hypothesis investigated independently
3. Evidence Evaluation — hypotheses ranked by supporting evidence
4. Root Cause — the best-supported explanation with fix recommendation

Produces a root cause analysis report with confidence level.

/resolve

Processes issues from /review:

• Validates each issue is real (not false positive)
• Assesses risk of fixing (low vs high)
• Fixes low-risk issues immediately
• Defers high-risk issues to tech debt backlog

Auto-Activating Skills

The devflow-core-skills plugin provides quality enforcement skills that activate automatically:

Skill	Triggers When
core-patterns	Implementing business logic, error handling
docs-framework	Creating documentation artifacts in .docs/
git-safety	Rebasing, force-pushing, merge conflicts
git-workflow	Staging files, creating commits, PRs
github-patterns	GitHub API operations, PR comments, releases
test-patterns	Writing or modifying tests
input-validation	Creating API endpoints
typescript	Working in TypeScript codebases
react	Working with React components
accessibility	Creating UI components, forms, interactive elements
frontend-design	Working with CSS, styling, visual design

Requirements

• Claude Code (latest)
• Node.js 18+

Installation

Install All Plugins

npx devflow-kit init

Install Specific Plugins

# List available plugins
npx devflow-kit list

# Install specific plugin(s)
npx devflow-kit init --plugin=implement
npx devflow-kit init --plugin=implement,review

Scopes

• --scope user (default) - Install for all projects (~/.claude/)
• --scope local - Install for current project only (.claude/)

Working Memory

DevFlow automatically preserves session context across restarts, /clear, and context compaction — zero ceremony required.

Three shell hooks run behind the scenes:

Hook	When	What
Stop	After each response	Updates .docs/WORKING-MEMORY.md with current focus, decisions, and progress. Throttled — skips if updated <2 min ago.
SessionStart	On startup, /clear, resume, compaction	Injects previous working memory + fresh git state as system context. Warns if memory is >1h stale.
PreCompact	Before context compaction	Backs up git state to JSON. Bootstraps a minimal working memory from git if none exists yet.

Working memory is per-project — scoped to each repo's .docs/ directory. Multiple sessions across different repos don't interfere.

Documentation Structure

DevFlow creates project documentation in .docs/:

.docs/
├── reviews/{branch}/         # Review reports per branch
├── design/                   # Implementation plans
├── WORKING-MEMORY.md         # Auto-maintained by Stop hook
└── working-memory-backup.json # Pre-compact git state snapshot

Workflow Examples

Implementing a Feature

/specify     # Define the feature with clarification gates
/implement   # Execute the full lifecycle

Debugging an Issue

/debug "login fails after session timeout"
/debug #42   # Investigate from GitHub issue

Before Creating a PR

/review      # Multi-perspective code review
/resolve     # Fix low-risk issues, defer high-risk to backlog

Session Continuity

Session context is saved and restored automatically via Working Memory hooks — no manual steps needed.

CLI Reference

Command	Description
npx devflow-kit init	Install all plugins
npx devflow-kit init --plugin=<names>	Install specific plugin(s)
npx devflow-kit list	List available plugins
npx devflow-kit uninstall	Remove DevFlow

Init Options

Option	Description
--plugin <names>	Comma-separated plugin names (e.g., implement,review)
--scope <user|local>	Installation scope (default: user)
--teams / --no-teams	Enable/disable experimental Agent Teams (default: off)
--verbose	Show detailed output

Uninstall Options

Option	Description
--scope <user|local>	Uninstall scope (default: user)
--keep-docs	Preserve .docs/ directory

Building from Source

git clone https://github.com/dean0x/devflow.git
cd devflow
npm install
npm run build
node dist/cli.js init

License

MIT