Updated 5mo ago
by evanklem
evanflow
A TDD-driven iterative feedback loop for software development. 16 cohesive Claude Code skills walk an idea from brainstorm → plan → execute → iterate, with checkpoints throughout.
418 GitHub stars (418)
Steady at 418 stars — no new stars in the 16 days since Sep 30.
- 16 skills (16 skills found in its SKILL.md files)
- 18 forks (18 forks)
- 5mo ago last update (Last updated 5mo ago)
Install
Skills CLI
npx skills add evanklem/evanflow
Asks which skills and agents to install. Just one: npx skills add evanklem/evanflow --skill evanflow-brainstorming — add -g for every project.
Claude Code
git clone https://github.com/evanklem/evanflowcp -r "evanflow/skills/evanflow-brainstorming" ~/.claude/skills/
Copies the evanflow-brainstorming skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add evanklem/evanflow
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
evanflow-brainstorming
Clarify intent, propose 2-3 approaches, embedded grill to stress-test the chosen path. Use before any creative work — new features, components, behavior changes, design questions. Mockup-only requests use mockup quick-mode (no spec/plan ceremony).
skills/evanflow-brainstorming/SKILL.md on GitHub (opens in a new tab) -
evanflow-coder-overseer
Orchestrate parallel implementation with coder/overseer pairs. Coders implement decomposed tasks using evanflow-tdd; overseers review each coder's output for bugs, gaps, errors, AND cohesion violations against a shared contract. A final integration overseer checks cross-coder cohesion. Use for plans with 3+ truly independent tasks that share an interface contract.
skills/evanflow-coder-overseer/SKILL.md on GitHub (opens in a new tab) -
evanflow-compact
Manage long-session context to prevent drift and degradation. Strategies for proactive summarization, branch isolation, and /clear decisions. Invoke when context feels heavy, when accuracy starts slipping, or proactively after a major phase boundary. Addresses the
skills/evanflow-compact/SKILL.md on GitHub (opens in a new tab) -
evanflow-debug
Root-cause discipline for bugs, test failures, and unexpected behavior. Embedded grill on the hypothesis before writing fix code. Use when encountering any bug, failing test, or behavior that doesn't match expectation.
skills/evanflow-debug/SKILL.md on GitHub (opens in a new tab) -
evanflow-design-interface
Design a module's interface using parallel sub-agents producing radically different designs ("design it twice"). Compare on depth, simplicity, and efficiency. Embedded grill on the synthesized choice. Use when designing a new API, exploring interface options, or deciding the shape of a refactor before writing code.
skills/evanflow-design-interface/SKILL.md on GitHub (opens in a new tab) -
evanflow-executing-plans
Execute a written implementation plan task-by-task with inline verification. Stop and ask on blockers. No forced sub-skill chains. Use when a plan exists and you're ready to implement.
skills/evanflow-executing-plans/SKILL.md on GitHub (opens in a new tab) -
evanflow-glossary
Extract canonical domain terms into CONTEXT.md. Flag ambiguities (same word, different meanings) and synonyms (different words, same meaning). Re-invoking updates the file in place. Use when authoring or updating CONTEXT.md, or when a new domain term emerges in conversation.
skills/evanflow-glossary/SKILL.md on GitHub (opens in a new tab) -
evanflow-go
Single entry-point orchestrator for the entire EvanFlow loop. The user says "let's evanflow this", "use evanflow", "evanflow this idea", "run this through evanflow", "implement with evanflow", or any similar phrasing — and you walk the full loop (brainstorm → plan → execute → tdd → iterate → STOP) end-to-end, announcing each step, respecting checkpoints, and stopping where the user retains contro…
skills/evanflow-go/SKILL.md on GitHub (opens in a new tab) -
evanflow-improve-architecture
Identify refactoring opportunities by surfacing architectural friction. Apply the deletion test, deep-modules vocabulary, and seams analysis. Each opportunity becomes its own evanflow-writing-plans cycle. Use when reviewing code for refactoring, when a file has grown too large, or when architecture concerns surface during feature work.
skills/evanflow-improve-architecture/SKILL.md on GitHub (opens in a new tab) -
evanflow-iterate
Iterative self-review loop after implementing a plan. Re-read changed code with fresh eyes, fix issues found, re-run quality checks, repeat until clean. For UI work, includes visual verification (view the rendered page). Use after evanflow-executing-plans completes; on success, report and stop — the user decides what's next.
skills/evanflow-iterate/SKILL.md on GitHub (opens in a new tab) -
evanflow-prd
Synthesize a PRD (Product Requirements Document) for a big new feature. Synthesis (not interview) — uses existing project context and explicit ADRs. Asks before gh issue create. Use when scoping a substantial new feature in PRD shape (e.g., before a sprint).
skills/evanflow-prd/SKILL.md on GitHub (opens in a new tab) -
evanflow-qa
Conversational bug discovery → issue draft. Light listening, background exploration, scope assessment. Asks before gh issue create — never auto-files. Use when conducting a QA session, triaging user-reported issues, or filing bugs.
skills/evanflow-qa/SKILL.md on GitHub (opens in a new tab) -
evanflow-review
Code review — both giving and receiving feedback. Verifying observed behavior over performative agreement. Use when reviewing a PR, requesting review on completed work, or processing review feedback you received.
skills/evanflow-review/SKILL.md on GitHub (opens in a new tab) -
evanflow-tdd
Vertical-slice TDD for any production code. One test → one impl → repeat. Tests verify behavior through public interfaces, not internals. Use when implementing any feature, bugfix, or behavior change.
skills/evanflow-tdd/SKILL.md on GitHub (opens in a new tab) -
evanflow-writing-plans
Turn a spec or requirements into a bite-sized implementation plan. File-structure-first (deep modules), embedded grill to stress-test, no forced sub-skill chains. Use when you have a spec or clear requirements and are ready to plan execution.
skills/evanflow-writing-plans/SKILL.md on GitHub (opens in a new tab) -
evanflow
Meta skill for the EvanFlow system. Loads the shared vocabulary (deep modules, deletion test, vertical slice, grill, mockup quick-mode, no-auto-commit) and describes when to invoke each evanflow-* skill. Use when starting a new task and unsure which evanflow skill applies, or when you need to ground reasoning in the shared vocabulary.
skills/evanflow/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.