dev-workflow-agents

dev-workflow-agents

Agentic development workflow for Claude Code, VS Code Copilot, OpenCode, and GitHub Copilot CLI.

Orchestrates a Coordinator → Executor → Verifier pipeline with an adaptive fix loop. Quality-first: the Verifier reviews code with fresh eyes, without knowledge of implementation decisions.

---

Requirements

Platform	Requirement
Claude Code	Claude Code CLI installed
VS Code Copilot	VS Code + active GitHub Copilot subscription
OpenCode	OpenCode + any LLM provider
GitHub Copilot CLI	Copilot CLI installed

---

Quick Install

Claude Code

curl -fsSL https://raw.githubusercontent.com/kzzalews/dev-workflow-agents/main/install-claude-code.sh | bash

Installs agents to ~/.claude/agents/ and registers the /dev-workflow skill via claude plugins.

VS Code Copilot

curl -fsSL https://raw.githubusercontent.com/kzzalews/dev-workflow-agents/main/install-vscode.sh | bash

Installs agents to the VS Code user data agents/ directory and ~/.claude/agents/.

OpenCode

curl -fsSL https://raw.githubusercontent.com/kzzalews/dev-workflow-agents/main/install-opencode.sh | bash

Installs agents to ~/.config/opencode/agents/.

GitHub Copilot CLI

curl -fsSL https://raw.githubusercontent.com/kzzalews/dev-workflow-agents/main/install-github-copilot-cli.sh | bash

Installs agents to ~/.copilot/agents/ and registers the /dev-workflow skill via copilot plugin.

---

Usage

Claude Code

Type /dev-workflow in Claude Code to start. You will see:

╔══════════════════════════════════════════╗
║  dev-workflow — configuration            ║
╠══════════════════════════════════════════╣
║  Coordinator : claude-sonnet-latest      ║
║  Executor    : claude-haiku-latest       ║
║  Verifier    : claude-sonnet-latest      ║
╠══════════════════════════════════════════╣
║  Project complexity?                     ║
║    simple  — skip Verifier               ║
║    complex — full pipeline (default)     ║
╠══════════════════════════════════════════╣
║  Override a model? (optional)            ║
║  Syntax: role=model                      ║
║  Example: verifier=claude-opus-latest    ║
╚══════════════════════════════════════════╝

VS Code Copilot

Select dev-workflow from the agent dropdown to start. It guides you through the entire pipeline — tells you which agent to switch to at each step and what to send.

Agent	Role
dev-workflow	Entry point — collects requirements, guides the pipeline
dev-coordinator	Planning, pre-check approval, fix routing
dev-executor	Code analysis and implementation
dev-verifier	Fresh-eyes code review

Custom agents use the dropdown selector — they are NOT invoked via @mention. The @mention syntax only works for built-in chat participants (like @github or @terminal).

OpenCode

Press Tab (or use your switch_agent keybind) to switch to the dev-workflow agent. Describe your task — the guide walks you through the pipeline using @mention for subagents within the same session.

Agent	Mode	Role
dev-workflow	primary	Entry point — guides the full pipeline
dev-coordinator	subagent	Planning, pre-check approval, fix routing
dev-executor	subagent	Code analysis and implementation
dev-verifier	subagent	Fresh-eyes code review

Optional: configure per-agent models in ~/.config/opencode/opencode.json:

{
  "agent": {
    "dev-coordinator": { "model": "openrouter/anthropic/claude-sonnet-4-5" },
    "dev-executor":    { "model": "openrouter/anthropic/claude-haiku-4-5" },
    "dev-verifier":    { "model": "openrouter/anthropic/claude-sonnet-4-5" }
  }
}

GitHub Copilot CLI

Type /dev-workflow to start the skill. Or switch to the dev-workflow custom agent with copilot --agent dev-workflow.

The pipeline agents (dev-coordinator, dev-executor, dev-verifier, dev-workflow) are loaded automatically from ~/.copilot/agents/.

---

Default Models

Role	Claude Code	VS Code Copilot	OpenCode	GitHub Copilot CLI
Coordinator	claude-sonnet-latest	claude-sonnet-latest	global config	claude-sonnet-latest
Executor	claude-haiku-latest	claude-haiku-latest	global config	claude-haiku-latest
Verifier	claude-sonnet-latest	claude-sonnet-latest	global config	claude-sonnet-latest

Claude Code, VS Code Copilot, and GitHub Copilot CLI use *-latest aliases — automatically upgrades to the newest model version.

OpenCode agents inherit the globally configured model by default. Override per-agent via opencode.json (see Usage above).

Override models at runtime (Claude Code only)