Skip to content

refactor(dispatch-command): rename <dispatch> to <dispatch-command> syntax#70

Closed
dbpolito wants to merge 2 commits intomainfrom
refactor/dispatch-command-syntax
Closed

refactor(dispatch-command): rename <dispatch> to <dispatch-command> syntax#70
dbpolito wants to merge 2 commits intomainfrom
refactor/dispatch-command-syntax

Conversation

@dbpolito
Copy link
Copy Markdown
Contributor

Summary

Renames the dispatch command syntax from <dispatch> to <dispatch-command> across all templates, documentation, and tests for clarity and explicitness.

Changes

  • Syntax rename: Updated all <dispatch> tags to <dispatch-command> in command templates
  • Navigator agent: Restructured documentation to clarify dispatch command forwarding rules
  • Commands updated: /ship, /ticket/dev, /todo, and related workflow commands
  • Documentation: Updated AGENTS.md and all reference docs to reflect new syntax
  • Tests: Updated test assertions to match new tag format and navigator behavior

Rationale

The more explicit <dispatch-command> tag name better communicates that these blocks represent literal subagent calls that should be forwarded without expansion or interpretation. This reduces ambiguity in command documentation and makes the orchestration contract clearer.

Notable Implementation Details

  • All placeholder substitution rules remain unchanged
  • Dispatch blocks continue to support the agent attribute for target subagent selection
  • No functional changes to workflow execution—purely a naming/documentation refactor
  • Generated OpenCode artifacts in packages/opencode/.opencode/ have been updated accordingly

…cross all templates and docs

- Update agent syntax from <dispatch> to <dispatch-command> in all command templates
- Simplify navigator agent role to focus on orchestration
- Change ticket/dev command agent from worker to navigator
- Update tests to reflect new navigator behavior expectations
- Sync generated opencode output with core template changes
- Update documentation to match new dispatch-command syntax
- Reorganize dispatch commands section with clearer subsections
- Add explicit "How to forward" step-by-step instructions
- Add example transformation showing literal command forwarding
- Clarify critical rules about not expanding slash commands
- Update test assertion to match new prompt wording
@dbpolito dbpolito closed this Mar 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant