OpenCode Workflow Templates

Reusable workflow templates for the OpenCode AI coding agent.

What is this?

A collection of structured workflows that guide OpenCode through collaborative planning and execution:

• Agile Workflow - Develop features from idea to implementation
• Refactoring Workflow - Systematically refactor code with safety rails

Installation

Quick Install

# Clone or download this repository
cd opencode-workflows

# Run the installer
./install.sh

Manual Install

Copy commands and skills to your OpenCode config directory:

# Commands go to ~/.config/opencode/commands/
cp commands/*.md ~/.config/opencode/commands/

# Skills go to ~/.config/opencode/skills/
cp -r skills/* ~/.config/opencode/skills/

Usage

Start an Agile Workflow

/agile "I want to build user notifications"

This guides you through:

1. Epic Brief - Define problem and context
2. Core Flows - Map user journeys
3. Tech Plan - Design architecture
4. Ticket Breakdown - Create implementation plan
5. Execute - Implement the feature
6. Implementation Validation - Verify the implementation

Start a Refactoring Workflow

/refactor "refactor legacy authentication code"

This guides you through:

1. Analysis - Map dependencies and risks
2. Approach - Design safe refactoring strategy
3. Execute - Implement in controlled steps
4. Verification - Verify implementation matches plan

Continue a Workflow

/continue

Proceeds to the next stage of your current workflow.

Workflow Artifacts

During a workflow, documents are generated in your workspace:

Document	Purpose
epic-brief.md	Problem definition and context
core-flows.md	User journeys and interactions
tech-plan.md	Technical architecture
tickets.md	Implementation tickets
refactoring-analysis.md	Dependency and risk map
refactoring-approach.md	Refactoring strategy

Available Commands

Command	Description
/workflow	Show available workflows
/agile	Start agile workflow
/refactor	Start refactoring workflow
/continue	Continue current stage

Available Skills

Agents can call these skills during workflow execution:

Skill	Purpose
epic-brief	Define problem and context
core-flows	Map user journeys
tech-plan	Design architecture
ticket-breakdown	Create implementation tickets
execute	Execute implementation
implementation-validation	Validate implementation
refactoring-analysis	Analyze refactoring impact
refactoring-approach	Design refactoring approach
verification	Verify refactoring

Requirements

• OpenCode AI coding agent (https://opencode.ai)
• Node.js 18+ (for installation script)

License

MIT