Files
ECC/.opencode/commands/orchestrate.md
Gaurav Dubey 9d1ecb0754 fix(opencode): resolve command agent ids to registered opencode agents (#2477)
The `.opencode/commands/*.md` frontmatter referenced agents with the Claude
Code plugin namespace (`agent: everything-claude-code:<name>`), but ECC's
opencode integration registers its agents unscoped in `opencode.json`'s
`agent` map (`code-reviewer`, `planner`, ...), and that file's own `command`
section already references them unscoped. The `everything-claude-code:` scope
resolves under no opencode config (the opencode plugin package is
`ecc-universal`, and inline-config agents are bare), so subtask commands like
`/code-review` hard-fail with `Agent not found: everything-claude-code:code-reviewer`.
Non-subtask commands fall back to the default agent and appear to work — which
is why only some commands failed.

Strip the `everything-claude-code:` prefix from all 30 command frontmatter
agent ids so they match the registered agents, fix the MIGRATION.md example,
and replace the test that enforced the broken scoped invariant with one that
asserts each command agent id is a registered opencode agent (fails on the old
scoped ids, passes on the fix).

Fixes #2477
2026-07-10 09:46:40 +05:30

2.4 KiB

description, agent, subtask
description agent subtask
Orchestrate multiple agents for complex tasks planner true

Orchestrate Command

Orchestrate multiple specialized agents for this complex task: $ARGUMENTS

Your Task

  1. Analyze task complexity and break into subtasks
  2. Identify optimal agents for each subtask
  3. Create execution plan with dependencies
  4. Coordinate execution - parallel where possible
  5. Synthesize results into unified output

Available Agents

Agent Specialty Use For
planner Implementation planning Complex feature design
architect System design Architectural decisions
code-reviewer Code quality Review changes
security-reviewer Security analysis Vulnerability detection
tdd-guide Test-driven dev Feature implementation
build-error-resolver Build fixes TypeScript/build errors
e2e-runner E2E testing User flow testing
doc-updater Documentation Updating docs
refactor-cleaner Code cleanup Dead code removal
go-reviewer Go code Go-specific review
go-build-resolver Go builds Go build errors
database-reviewer Database Query optimization

Orchestration Patterns

Sequential Execution

planner → tdd-guide → code-reviewer → security-reviewer

Use when: Later tasks depend on earlier results

Parallel Execution

┌→ security-reviewer
planner →├→ code-reviewer
└→ architect

Use when: Tasks are independent

Fan-Out/Fan-In

         ┌→ agent-1 ─┐
planner →├→ agent-2 ─┼→ synthesizer
         └→ agent-3 ─┘

Use when: Multiple perspectives needed

Execution Plan Format

Phase 1: [Name]

  • Agent: [agent-name]
  • Task: [specific task]
  • Depends on: [none or previous phase]

Phase 2: [Name] (parallel)

  • Agent A: [agent-name]
    • Task: [specific task]
  • Agent B: [agent-name]
    • Task: [specific task]
  • Depends on: Phase 1

Phase 3: Synthesis

  • Combine results from Phase 2
  • Generate unified output

Coordination Rules

  1. Plan before execute - Create full execution plan first
  2. Minimize handoffs - Reduce context switching
  3. Parallelize when possible - Independent tasks in parallel
  4. Clear boundaries - Each agent has specific scope
  5. Single source of truth - One agent owns each artifact

NOTE: Complex tasks benefit from multi-agent orchestration. Simple tasks should use single agents directly.