OpenCode: Real-World Workflows
Workflows document real sessions where OpenCode’s multi-provider architecture delivered results. As the system matures, new workflows will be added here.
Workflow: Daily Operations Cadence (Planned)
Scenario
Start-of-day routine using OpenCode with multi-provider model selection for documentation work across domus-* repos.
Target Daily Flow
Session start (opencode)
├── onSessionStart plugin fires
│ ├── Displays active provider/model
│ ├── Shows theme (Catppuccin Mocha)
│ └── Reports Ollama status (GPU memory, loaded models)
│
├── /worklog # Skill (cross-compatible)
│ ├── Creates WRKLOG-YYYY-MM-DD.adoc
│ ├── Generates 8 standard partials
│ ├── Model: Ollama local (free)
│ └── Adds to nav.adoc
│
├── @carryover-updater # Agent (Ollama local)
│ ├── Scans all tracker partials
│ └── Increments day counters
│
├── [documentation work happens]
│ ├── Edit .adoc file → asciidoc-validator plugin fires
│ │ └── Validates {attributes} against antora.yml
│ ├── Edit .sh file → shellcheck-runner plugin fires
│ │ └── Runs ShellCheck validation
│ ├── Complex refactoring needed
│ │ └── Switch to Claude Sonnet (Ctrl+X → M)
│ └── Code generation
│ └── Switch to DeepSeek (Ctrl+X → M)
│
├── /deploy "docs: Today's updates" # Skill (cross-compatible)
│ ├── Commits with conventional format
│ ├── Pushes to origin
│ └── Triggers Cloudflare Pages rebuild
│
├── Build issues?
│ ├── @build-fixer # Agent (Claude Sonnet)
│ │ ├── Runs Antora build
│ │ ├── Parses all warnings
│ │ ├── Fixes each one
│ │ └── Verifies clean build
│ └── /undo if fix was wrong # Built-in (no Claude Code equivalent)
│
└── End of day
├── /session # Skill: log what happened
├── cost-tracker plugin → session cost summary
└── Provider breakdown: 70% Ollama, 20% DeepSeek, 10% Claude
Provider Selection Pattern
| Task | Provider | Rationale |
|---|---|---|
Worklog creation |
Ollama local |
Template-based, low complexity, free |
Carryover updates |
Ollama local |
Pattern matching + incrementing, free |
AsciiDoc editing |
Ollama local |
Routine edits, attribute insertion, free |
Complex refactoring |
Claude Sonnet |
Multi-file reasoning, best quality |
Code generation |
DeepSeek |
Strong coder at low cost |
Architecture review |
Gemini 2.5 Pro |
Large context window for multi-file analysis |
Quick fixes |
GitHub Copilot |
Already paying, fast completions |
Teaching Point
Provider-aware workflow design. The breakthrough is not having the best model — it is having the right model for each task. 70% of daily documentation work can run locally for free. The remaining 30% goes to cloud providers chosen by task type: DeepSeek for code, Claude for reasoning, Gemini for context. This is not cost optimization — it is resource matching.