Skip to content

refactor: rename <dispatch> to <dispatch-command> and restructure navigator orchestration#69

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

refactor: rename <dispatch> to <dispatch-command> and restructure navigator orchestration#69
dbpolito wants to merge 2 commits intomainfrom
refactor/dispatch-command-syntax

Conversation

@dbpolito
Copy link
Copy Markdown
Contributor

Summary

This PR renames the <dispatch> tag to <dispatch-command> across all templates and documentation for clarity and consistency. It also restructures the navigator agent instructions to better describe its orchestration role.

Changes

Syntax Update

  • Renamed <dispatch agent="..."> to <dispatch-command agent="..."> in all command templates
  • Updated AGENTS.md documentation with the new syntax
  • Updated all references in command docs (ship, todo, ticket/dev)

Navigator Agent Restructuring

  • Clarified the navigator's role as an orchestrator rather than just a navigation specialist
  • Added explicit "Dispatch Commands" section with transformation examples
  • Emphasized that slash commands inside dispatch blocks should not be expanded
  • Updated ground rules to prevent the navigator from doing implementation work itself

Affected Commands

  • /ship - delegation to branch, commit, and PR creation
  • /todo - planning, implementation, and commit delegation
  • /ticket/dev - full ticket implementation workflow

Validation

All templates compile correctly and tests pass with the new syntax.

…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