Skip to content

dean0x/devflow

Repository files navigation

DevFlow

npm version CI License: MIT Node.js 18+ Website

DevFlow init demo

The problem with AI-assisted development

Claude Code is powerful. But every session starts from scratch. Context evaporates between conversations. Code reviews are single-pass and shallow. Quality depends entirely on what you remember to ask for.

DevFlow fixes this. Install once, forget about it. Your code gets better automatically.

It watches every prompt, classifies intent, and orchestrates the right workflow — plan, implement, review, debug — loading the relevant skills. Simple questions get zero overhead. Complex tasks get an advanced TDD and EDD harness with quality gates at every step.

See it work

you: add rate limiting to the /api/upload endpoint

DevFlow: Ambient: IMPLEMENT/ORCHESTRATED
         → Created branch feat/42-rate-limit-upload
         → Exploring codebase... Planning... Coding...
         → Validator: build ✓ typecheck ✓ lint ✓ tests ✓
         → Simplifier: cleaned up 3 files
         → Scrutinizer: 9-pillar quality check passed
         → Shepherd: implementation matches request ✓
/code-review     → 18 reviewers examine your changes in parallel
/resolve         → all issues validated and fixed automatically

What you get

Ambient intelligence. DevFlow classifies every prompt into three tiers — QUICK (zero overhead), GUIDED (skill loading + main session), ORCHESTRATED (full agent pipelines). You never invoke it manually. Init and forget.

Memory that persists. Session context survives restarts, /clear, and context compaction. Your AI picks up exactly where it left off. Architectural decisions and known pitfalls accumulate in .memory/knowledge/ and inform every future session. No manual bookkeeping.

It learns how you work. A self-learning mechanism detects repeated workflows and procedural patterns across sessions, then creates reusable slash commands and skills automatically.

18 parallel code reviewers. Security, architecture, performance, complexity, consistency, regression, testing, and more. Each produces findings with severity, confidence scoring, and concrete fixes. Conditional reviewers activate when relevant (TypeScript for .ts files, database for schema changes). Every finding gets validated and resolved automatically.

34 skills grounded in expert material. Every skill is backed by peer-reviewed papers, canonical books, and industry standards — security (OWASP, Shostack), architecture (Parnas, Evans, Fowler), performance (Brendan Gregg), testing (Beck, Meszaros), design (Wlaschin, Hickey). 200+ sources total.

Skill shadowing. Override any built-in skill with your own version. Drop a file into ~/.devflow/skills/{name}/ and the installer uses yours instead of the default — same activation, your rules.

Full lifecycle. /implement takes a task from exploration through planning, coding, validation, and refinement. /specify defines features with clarification gates. /debug investigates bugs with competing hypotheses in parallel. /self-review runs Simplifier + Scrutinizer quality passes.

Everything is composable. 17 plugins (8 core + 9 language/ecosystem). Install only what you need. Six commands cover the entire development lifecycle.

HUD. A persistent status line updates on every prompt — project, branch, diff stats, context usage, model, session duration, cost, and configuration counts at a glance.

devflow · feat/auth-middleware* · 3↑ · v1.8.3 +5 · 12 files · +234 -56
Current Session ████░░░░ 42% · Session 5h ██░░░░░░ 18% · 7d █░░░░░░░ 8%
Opus 4.6 [1m] · 23m · $1.24 · 2 CLAUDE.md · 4 MCPs · 8 hooks · 34 skills

Security. Deny lists block dangerous tool patterns out of the box — configurable during init.

Quick Start

npx devflow-kit init

That's it. The interactive wizard handles plugin selection, feature configuration, and security settings. Ambient mode, working memory, and self-learning are on by default.

Commands

Command What it does
/specify Define a feature with clarification gates → GitHub issue
/implement Full lifecycle: explore → plan → code → validate → refine → PR
/code-review Multi-perspective parallel code review
/resolve Validate and fix all review issues
/debug Competing hypothesis investigation
/self-review Simplifier + Scrutinizer quality pass

See docs/commands.md for detailed usage.

Language Support

Optional plugins add language-specific patterns for TypeScript, React, Go, Python, Java, Rust, accessibility, and frontend design.

npx devflow-kit init --plugin=typescript,react

How it works

DevFlow is a plugin system for Claude Code. Each plugin installs commands, agents, and skills into your Claude Code environment. Skills are tiny markdown files that activate automatically based on context. Agents are specialized workers (reviewer, coder, resolver, etc.) with explicit model assignments — Opus for analysis, Sonnet for execution, Haiku for I/O. Commands orchestrate agent pipelines.

For deep dives: Working Memory | Self-Learning | CLI Reference | Commands

CLI Reference

npx devflow-kit init                    # Install (interactive wizard)
npx devflow-kit init --plugin=implement # Install specific plugin
npx devflow-kit list                    # List available plugins
npx devflow-kit ambient --enable        # Toggle ambient mode
npx devflow-kit learn --enable          # Toggle self-learning
npx devflow-kit uninstall               # Remove DevFlow

See docs/cli-reference.md for all options.

Part of the AI Development Stack

Tool Role What It Does
Skim Context Optimization Code-aware AST parsing, command rewriting, output compression
DevFlow Quality Orchestration Parallel reviewers, working memory, self-learning, composable plugins
Backbeat Agent Orchestration Karpathy optimization loops, multi-agent pipelines, DAG dependencies

Building from Source

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

Requirements

License

MIT

About

The most advanced agentic development toolkit for generating production-grade code. Ambient Orchestration, Working memory that never forgets. Self-learning workflows. Install once, forget about it. Your code gets better automatically.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors