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.