subagent-dev-workflow

A right-sized, cross-harness subagent pipeline that takes a bounded coding task from research through a reviewed, working implementation:

research -> questionnaire -> plan -> implement -> review -> bounded fix loop -> report.

It matches subagent model tier to each stage's actual difficulty, pauses once for human clarification, and bounds its own retry loop instead of letting review/fix cycles run forever.

Supported harnesses

• Claude Code (skills/subagent-dev-workflow/references/claude-code.md)
• Codex CLI (skills/subagent-dev-workflow/references/codex.md)
• OpenCode (skills/subagent-dev-workflow/references/opencode.md)
• Pi (skills/subagent-dev-workflow/references/pi.md)

Install

Each harness below can install this repo directly as a plugin - GitHub, GitLab, Gitea, or any other git host works (all four commands accept a full git URL, not just GitHub shorthand), and a local path works too.

Claude Code

claude plugin marketplace add https://git.kree.gr/kreeger/subagent-dev-workflow.git
claude plugin install subagent-dev-workflow@subagent-driven-development

(<owner>/<repo> GitHub shorthand, e.g. kreeger/subagent-dev-workflow, works too if you're pulling from a GitHub mirror. The marketplace name after the @ comes from this repo's .claude-plugin/marketplace.json, not the repo name.)

Codex CLI

codex plugin marketplace add https://git.kree.gr/kreeger/subagent-dev-workflow.git
codex plugin install subagent-dev-workflow@subagent-dev-workflow

OpenCode

No manifest needed - OpenCode discovers skills/subagent-dev-workflow/SKILL.md by directory scan. Clone this repo (or a subset of it) into a location OpenCode scans for skills (project .opencode/ or its global config directory - confirm the exact path in your installed version).

Pi

pi install git:git.kree.gr/kreeger/subagent-dev-workflow

Pi discovers the skill via the pi.skills entry in this repo's package.json.

Manual copy

Any harness can also just load skills/subagent-dev-workflow/SKILL.md and its references/ directory directly from a checkout, without going through a plugin manager - see the matching reference file for where each harness expects that directory to live.

How it works

See SKILL.md for the full stage-by-stage pipeline definition.

License

MIT, see LICENSE.