harness-flow

HarnessFlow

English | Chinese

Spec-anchored SDD, gated TDD, and evidence-based workflow control for AI coding agents.

HarnessFlow packages the practices behind disciplined AI-assisted engineering into self-contained Markdown skills: discovery, specs, design, tasks, TDD implementation, independent reviews, gates, and closeout.

---

Commands

Claude Code gets 7 slash commands. OpenCode and Cursor use the same intents through natural language plus using-hf-workflow.

What you're doing	Command	Key principle
Enter or resume HF	/hf	Route from artifacts
Define what to build	/spec	Spec before code
Plan how to build it	/plan	Design then tasks
Build one task	/build	One active task
Review before moving on	/review	Author/reviewer separation
Close engineering work	/ship	Gates before closeout
Cut a release pack	/release	Version docs, not deploys

Every command is a bias, not a bypass. The router still checks repository evidence before choosing the next node, except /release, which directly invokes the standalone release skill.

---

Quick Start

Claude Code

Install from the marketplace:

/plugin marketplace add https://github.com/hujianbest/harness-flow.git
/plugin install harness-flow@hujianbest-harness-flow

OpenCode and Cursor

Vendor HarnessFlow into your project with the install script:

git clone https://github.com/hujianbest/harness-flow.git /path/to/harness-flow

# OpenCode
bash /path/to/harness-flow/install.sh --target opencode --host /path/to/your/project

# Cursor
bash /path/to/harness-flow/install.sh --target cursor --host /path/to/your/project

# Both
bash /path/to/harness-flow/install.sh --target both --host /path/to/your/project

The script copies or symlinks skills/, agents/, OpenCode command assets, and Cursor agent mirrors, places client-specific rules, and writes .harnessflow-install-manifest.json so uninstall can remove only HF-managed files.

Try it

Use HarnessFlow from this repo. Start with `using-hf-workflow` and route me through the correct HF workflow.
I want to add rate limiting to our notifications API.
Do not jump straight to code.

More setup detail:

• Claude Code setup
• OpenCode setup
• Cursor setup

---

See It Work

You:    Use HarnessFlow from this repo. Start with `using-hf-workflow`.
        I want to add rate limiting to our notifications API.

HF:     Reads repository artifacts, chooses the right entry point, and routes
        into discovery or `hf-specify` instead of jumping straight to code.

You:    Use HarnessFlow to plan the approved spec.

HF:     Produces architecture with `hf-design`, adds `hf-ui-design` only when
        the spec declares a UI surface, then breaks the design into reviewed
        tasks with `hf-tasks`.

You:    Use HarnessFlow to build the current active task.

HF:     Locks one `Current Active Task`, writes the test design, records the
        approval, runs RED -> GREEN -> REFACTOR, updates `tasks.progress.json`,
        and writes a wisdom-notebook delta for cross-task learning.

You:    Use HarnessFlow to verify and close this work.

HF:     Runs test, code, and traceability reviews. If the task touches a
        frontend surface, `hf-browser-testing` captures DOM / console / network
        evidence before the gates decide what happens next.

You:    Use HarnessFlow to ship the completed workflow.

HF:     Runs regression, doc-freshness, and completion gates, then `hf-finalize`
        writes `closeout.md` plus the closeout HTML companion. For a vX.Y.Z
        release, `hf-release` can aggregate closed workflows into a tag-ready
        release pack; it still does not deploy to production.

If the architect explicitly asks for auto mode, hf-ultrawork can continue through canonical next actions, write approval records, and keep a fast-lane audit trail while preserving Fagan reviews, gate verdicts, closeout, and hard stops.

---

All 30 Skills

HarnessFlow currently ships 29 hf-* skills plus the using-hf-workflow entry skill.

Meta and routing

Skill	What it does	Use when
using-hf-workflow	Public entry shell for choosing direct invoke vs router handoff	Starting a session or expressing a high-level HF intent
hf-workflow-router	Evidence-based runtime router and recovery controller	Continuing from repository artifacts or consuming review/gate outcomes

Discover and define