dev-flow
Installation
SKILL.md
Dev Flow
Use this workflow for product code. Project instructions remain authoritative for repository-specific paths, commands, domain language, and architectural constraints.
Project companion documents are configuration, not a second copy of this workflow. Keep them limited to repository facts, local paths, commands, domain terms, architecture boundaries, and delivery constraints. Keep discovery, design, SOLID, design-quality, framework, quality-gate, and scope-verification rules here or in the references below.
Terms
- Phase — a point in the verification lifecycle: during implementation, review checkpoint, final checkpoint, or after commit hooks. The four phases are stack-agnostic and shared by every stack.
- Focused check — the smallest deterministic command that can fail on the current change (an affected unit test, typecheck, lint, or formatter run). It is run while the change is in flight.
- Gate — a full-project, thresholded command run at the final checkpoint. It fails when a metric or policy is violated.
- Scope trigger — a characteristic of a change (a route or template touched, a dependency manifest touched) that adds a specific check to a phase. A scope trigger is a condition, not a phase.
- Reference — a stack-specific rule file under
references/, loaded on demand when a change touches that stack. - Companion — the project's own workflow document. It holds only repository-specific paths, commands, thresholds, domain language, architecture boundaries, and delivery constraints.
- Enforcement, not presence — a tool, config, or command is evidence of a check only when it carries a non-empty rule set or an explicit threshold, is wired into a path that runs it (script, hook, or CI), and has been observed to fail on a deliberate violation. A tool that is merely present is
present-but-not-enforcingand is treated as absent in every report.
Initialization mode
When the user explicitly asks to initialize, set up, or bootstrap this workflow for a project, run this mode before the normal development workflow. A typical request is: Use dev-flow to initialize this project.