do-flow

Orchestrates the DoFlow spec-driven workflow chain from brainstorm through review with runtime-validated gates.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/khoavu882/do-flow --skill do-flow-khoavu882
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: do-flow
Source: https://github.com/khoavu882/do-flow/tree/main/core/shared/skills/do-flow
Command: npx skills add https://github.com/khoavu882/do-flow --skill do-flow-khoavu882

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Running a spec-driven feature lifecycle manually means invoking each phase skill (/do-brainstorm, /do-design, /do-plan, /do-implement, /do-test, /do-code-review) one at a time and remembering where to stop for approvals. This Skill automates that orchestration: it classifies the task, resolves the correct workflow from the DoFlow runtime, runs each stage in order, and pauses only at declared approval gates. ## Core Features & Use Cases - Runtime-validated task classification: Proposes one of nine task classes (feature, bug, refactor, review, research, documentation, dependency-change, operations, trivial-edit) and validates it through the DoFlow runtime before any stage runs, rejecting mismatched classes instead of defaulting to the feature chain. - End-to-end stage orchestration: Executes the resolved workflow's stages in order, resuming feature work from the first missing artifact (requirement.md, design.md, plan.md) and honoring optional stages and readiness checks. - Approval gate management: Stops at workflow-declared gates (post-discovery clarifications, pre-implementation checkpoint, post-review handoff), records each decision via the orchestrate command, and never proceeds on ambiguous answers. - Use Case: Tell the assistant "build this feature end-to-end" and it will classify the work, run brainstorm through code review automatically, pause for your approval before implementation, and hand off to /do-git for commit once the final gate clears. ## Quick Start Ask the assistant to take your feature idea from idea to implementation using the do-flow skill, for example by saying "run the doflow chain to add OAuth login support".

Frequently Asked Questions about do-flow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a spec-driven feature workflow end-to-end?▼

Invoke /do-flow with a feature description and it auto-chains brainstorm, design, plan, implement, test, and review stages. It pauses only at declared approval gates, such as the pre-implementation checkpoint, and resumes from the first missing artifact if work already exists.

How does do-flow decide which workflow to run for a task?▼

It proposes exactly one task class from nine options (feature, bug, refactor, review, research, documentation, dependency-change, operations, trivial-edit) based on request cues, then validates the proposal through the DoFlow runtime's classify command. Rejected classes are never silently replaced with the feature default.

Can I restart a workflow from a specific phase like plan or test?▼

Yes, pass --from with a phase name such as brainstorm, design, plan, implement, test, or review to deliberately re-run that stage. If the phase matches no stage in the resolved workflow, the run stops and lists the available stage ids.

What happens if the DoFlow runtime is not installed?▼

The skill searches for the doflow-run binary in .doflow directories walking up from the current path, then in the home directory. If none is found, it prints an error naming every searched path and instructs you to run npx @khoavu882/doflow install.

When should I not use do-flow for a task?▼

Avoid it for single-phase work where invoking the specific /do-* skill directly is simpler, and for setting repo-level rules, which belongs to the standalone do-constitution skill. Classes like review or research also terminate before implementation by design.