opencode-workflow

An OpenCode plugin that brings the agent-skills engineering workflow library into OpenCode's runtime.

What it does

AI coding agents default to the shortest path — skipping specs, tests, and security reviews. This plugin enforces the structured workflows that production-quality engineering requires.

It packages 20 skills, 7 slash commands, 3 specialist agent personas, and 4 reference checklists directly into OpenCode, then injects a system prompt that maps every user intent to the right skill automatically.

  DEFINE        PLAN          BUILD         VERIFY        REVIEW        SHIP
 ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐
 │ Idea │ ---> │ Spec │ ---> │ Code │ ---> │ Test │ ---> │  QA  │ ---> │  Go  │
 │Refine│      │  PRD │      │ Impl │      │Debug │      │ Gate │      │ Live │
 └──────┘      └──────┘      └──────┘      └──────┘      └──────┘      └──────┘

How it works

The plugin registers three things with OpenCode:

1. Skills directory — 20 SKILL.md files, each a structured workflow with steps, verification gates, and anti-rationalization tables. OpenCode's skill tool loads them on demand.
2. Slash commands — 7 commands (/spec, /plan, /build, /test, /review, /code-simplify, /ship) that map to the development lifecycle.
3. System prompt patch — injects intent-to-skill mapping rules so skills activate automatically (e.g. designing an API triggers api-and-interface-design, building UI triggers frontend-ui-engineering).

Skills

Phase	Skill
Define	idea-refine, spec-driven-development
Plan	planning-and-task-breakdown
Build	incremental-implementation, test-driven-development, context-engineering, source-driven-development, frontend-ui-engineering, api-and-interface-design
Verify	browser-testing-with-devtools, debugging-and-error-recovery
Review	code-review-and-quality, code-simplification, security-and-hardening, performance-optimization
Ship	git-workflow-and-versioning, ci-cd-and-automation, deprecation-and-migration, documentation-and-adrs, shipping-and-launch

Agent Personas

Three specialist personas for targeted reviews, available as OpenCode subagents:

• code-reviewer — Senior Staff Engineer; five-axis code review
• test-engineer — QA Specialist; test strategy and coverage analysis
• security-auditor — Security Engineer; vulnerability detection and OWASP assessment

Tech stack

• TypeScript, ESM, Node.js, pnpm
• @opencode-ai/plugin — plugin host API
• tsdown — bundler
• oxlint + oxfmt — linting and formatting
• agent-skills — git submodule

Development

pnpm install       # install dependencies
pnpm start         # build (outputs to dist/)
pnpm test          # run tests
pnpm lint          # lint
pnpm fmt           # format

License

MIT