{"id":31537698,"url":"https://github.com/dean0x/devflow","last_synced_at":"2026-04-01T22:35:20.973Z","repository":{"id":316979606,"uuid":"1065526914","full_name":"dean0x/devflow","owner":"dean0x","description":"Agentic Development Toolkit for Claude Code — adversarial reviews, session memory, quality enforcement.","archived":false,"fork":false,"pushed_at":"2026-03-07T14:18:06.000Z","size":1934,"stargazers_count":6,"open_issues_count":22,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-07T19:52:59.115Z","etag":null,"topics":["agent-teams","ai","claude-code","cli","code-review","developer-tools","devtools","plugins","typescript"],"latest_commit_sha":null,"homepage":"https://dean0x.github.io/x/devflow/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dean0x.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-27T22:47:11.000Z","updated_at":"2026-03-05T15:40:59.000Z","dependencies_parsed_at":"2026-01-30T02:02:28.982Z","dependency_job_id":null,"html_url":"https://github.com/dean0x/devflow","commit_stats":null,"previous_names":["dean0x/devflow"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/dean0x/devflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dean0x%2Fdevflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dean0x%2Fdevflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dean0x%2Fdevflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dean0x%2Fdevflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dean0x","download_url":"https://codeload.github.com/dean0x/devflow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dean0x%2Fdevflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30240268,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-08T00:58:18.660Z","status":"ssl_error","status_checked_at":"2026-03-08T00:55:48.608Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-teams","ai","claude-code","cli","code-review","developer-tools","devtools","plugins","typescript"],"created_at":"2025-10-04T08:10:10.358Z","updated_at":"2026-04-01T22:35:20.952Z","avatar_url":"https://github.com/dean0x.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DevFlow\n\n[![npm version](https://img.shields.io/npm/v/devflow-kit)](https://www.npmjs.com/package/devflow-kit)\n[![CI](https://github.com/dean0x/devflow/actions/workflows/ci.yml/badge.svg)](https://github.com/dean0x/devflow/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Node.js 18+](https://img.shields.io/badge/node-18%2B-brightgreen.svg)](https://nodejs.org/)\n[![Website](https://img.shields.io/badge/Website-dean0x.github.io%2Fx%2Fdevflow-blue)](https://dean0x.github.io/x/devflow/)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\".github/assets/devflow-init.gif\" alt=\"DevFlow init demo\" width=\"720\" /\u003e\n\u003c/p\u003e\n\n## The problem with AI-assisted development\n\nClaude 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.\n\nDevFlow fixes this. Install once, forget about it. Your code gets better automatically.\n\nIt 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.\n\n## See it work\n\n```\nyou: add rate limiting to the /api/upload endpoint\n\nDevFlow: Ambient: IMPLEMENT/ORCHESTRATED\n         → Created branch feat/42-rate-limit-upload\n         → Exploring codebase... Planning... Coding...\n         → Validator: build ✓ typecheck ✓ lint ✓ tests ✓\n         → Simplifier: cleaned up 3 files\n         → Scrutinizer: 9-pillar quality check passed\n         → Shepherd: implementation matches request ✓\n```\n\n```\n/code-review     → 18 reviewers examine your changes in parallel\n/resolve         → all issues validated and fixed automatically\n```\n\n## What you get\n\n**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.\n\n**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.\n\n**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.\n\n**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.\n\n**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.\n\n**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.\n\n**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.\n\n**Everything is composable.** 17 plugins (8 core + 9 language/ecosystem). Install only what you need. Six commands cover the entire development lifecycle.\n\n**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.\n\n```\ndevflow · feat/auth-middleware* · 3↑ · v1.8.3 +5 · 12 files · +234 -56\nCurrent Session ████░░░░ 42% · Session 5h ██░░░░░░ 18% · 7d █░░░░░░░ 8%\nOpus 4.6 [1m] · 23m · $1.24 · 2 CLAUDE.md · 4 MCPs · 8 hooks · 34 skills\n```\n\n**Security.** Deny lists block dangerous tool patterns out of the box — configurable during init.\n\n## Quick Start\n\n```bash\nnpx devflow-kit init\n```\n\nThat's it. The interactive wizard handles plugin selection, feature configuration, and security settings. Ambient mode, working memory, and self-learning are on by default.\n\n## Commands\n\n| Command | What it does |\n|---------|-------------|\n| `/specify` | Define a feature with clarification gates → GitHub issue |\n| `/implement` | Full lifecycle: explore → plan → code → validate → refine → PR |\n| `/code-review` | Multi-perspective parallel code review |\n| `/resolve` | Validate and fix all review issues |\n| `/debug` | Competing hypothesis investigation |\n| `/self-review` | Simplifier + Scrutinizer quality pass |\n\nSee [docs/commands.md](docs/commands.md) for detailed usage.\n\n## Language Support\n\nOptional plugins add language-specific patterns for TypeScript, React, Go, Python, Java, Rust, accessibility, and frontend design.\n\n```bash\nnpx devflow-kit init --plugin=typescript,react\n```\n\n## How it works\n\nDevFlow 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.\n\nFor deep dives: [Working Memory](docs/working-memory.md) | [Self-Learning](docs/self-learning.md) | [CLI Reference](docs/cli-reference.md) | [Commands](docs/commands.md)\n\n## CLI Reference\n\n```bash\nnpx devflow-kit init                    # Install (interactive wizard)\nnpx devflow-kit init --plugin=implement # Install specific plugin\nnpx devflow-kit list                    # List available plugins\nnpx devflow-kit ambient --enable        # Toggle ambient mode\nnpx devflow-kit learn --enable          # Toggle self-learning\nnpx devflow-kit uninstall               # Remove DevFlow\n```\n\nSee [docs/cli-reference.md](docs/cli-reference.md) for all options.\n\n## Part of the AI Development Stack\n\n| Tool | Role | What It Does |\n|------|------|-------------|\n| **[Skim](https://github.com/dean0x/skim)** | Context Optimization | Code-aware AST parsing, command rewriting, output compression |\n| **DevFlow** | Quality Orchestration | Parallel reviewers, working memory, self-learning, composable plugins |\n| **[Backbeat](https://github.com/dean0x/backbeat)** | Agent Orchestration | Karpathy optimization loops, multi-agent pipelines, DAG dependencies |\n\n## Building from Source\n\n```bash\ngit clone https://github.com/dean0x/devflow.git\ncd devflow \u0026\u0026 npm install \u0026\u0026 npm run build\nnode dist/cli.js init\n```\n\n## Requirements\n\n- [Claude Code](https://claude.ai/download) (latest)\n- Node.js 18+\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdean0x%2Fdevflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdean0x%2Fdevflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdean0x%2Fdevflow/lists"}