From evanflow
Identifies refactoring opportunities by surfacing architectural friction using deletion test, deep-modules vocabulary, and seams analysis. For reviewing large files or architecture concerns.
npx claudepluginhub evanklem/evanflow --plugin evanflowThis skill uses the workspace's default tool permissions.
See `evanflow` meta-skill. Key terms: **module**, **interface**, **depth**, **seam**, **adapter**, **deletion test**.
Surfaces shallow modules, refactoring opportunities, seams, and tight coupling; proposes deepening refactors for testability and AI-navigability using precise vocabulary.
Identifies deepening opportunities in codebases by spotting shallow modules and tight coupling, informed by domain glossary and ADRs. Proposes refactors for better architecture, testability, and AI-navigability.
Identifies shallow modules and architectural friction in codebases, proposing deepening refactors for testability and AI-navigability using domain glossary and ADRs.
Share bugs, ideas, or general feedback.
See evanflow meta-skill. Key terms: module, interface, depth, seam, adapter, deletion test.
SKIP when: the user is doing a small, well-scoped change. Don't try to refactor adjacent code.
CONTEXT.md (if it exists) — for canonical domain languagedocs/adr/ — for prior architectural decisions you must respectWalk the codebase noting friction:
For each candidate module: "If I deleted this, where would the complexity go?"
Before proposing changes, stress-test:
CONTEXT.md, or are we inventing new terms?"For each, name:
CONTEXT.md)Prioritize. Recommend ONE to tackle next.
Each opportunity becomes its own evanflow-writing-plans cycle. Do not bundle multiple refactors into one plan — that's a horizontal-slice failure.
If the opportunity changes a public interface, route through evanflow-design-interface first.
CONTEXT.md and docs/adr/ before proposing changes. Domain language and prior decisions must inform the design.evanflow-design-interface (if interface changes) or evanflow-writing-plans (otherwise)evanflow-glossary to update CONTEXT.mddocs/adr/