Skip to content

feat: Add fleet mode to PAW agent#231

Draft
lossyrob wants to merge 1 commit into
mainfrom
feature/fleet-mode-integration
Draft

feat: Add fleet mode to PAW agent#231
lossyrob wants to merge 1 commit into
mainfrom
feature/fleet-mode-integration

Conversation

@lossyrob

@lossyrob lossyrob commented Feb 9, 2026

Copy link
Copy Markdown
Owner

Summary

When dispatched under fleet coordination, PAW switches from workflow executor to workflow definer — emitting SQL todos with todo_deps dependencies instead of executing activities directly. This ensures mandatory reviews cannot be structurally bypassed when PAW runs as a fleet subagent.

Changes

agents/PAW.agent.md (+14 lines):

  • Fleet detection check in Initialization section
  • New ## Fleet Mode section with:
    • Pre-planning todo chain (specspec-reviewcode-researchplanningplan-reviewexpand-phases)
    • Dynamic phase expansion from ImplementationPlan.md
    • Self-contained todo prompt rules for subagent execution

Design Decisions

  • Eager expansion: All phases emitted at once (expand-phases reads plan, inserts all implementation todos)
  • FAIL handling: Reviews fix-and-retry internally within the todo prompt (don't yield as failed)
  • Detection: Explicit fleet marker detection (fleet coordinator systemMessage or dispatch markers)
  • Token discipline: 2437 → 2643 tokens (+206, 8.5% increase — justified for major new capability)

Backward Compatibility

Purely additive — no existing direct-mode behavior is modified. Fleet mode only activates when fleet instructions are detected in session context.

Validation

  • ./scripts/lint-prompting.sh agents/PAW.agent.md
  • npm run lint
  • POC validation in poc/sdk/src/ confirmed fleet + PAW agent composition works via SDK

Closes #228

When dispatched under fleet coordination, PAW switches from workflow
executor to workflow definer — emitting SQL todos with dependencies
instead of executing activities directly. This ensures mandatory
reviews cannot be structurally bypassed.

- Fleet detection in Initialization section
- Pre-planning todo chain (spec through expand-phases)
- Dynamic phase expansion from ImplementationPlan.md
- Self-contained todo prompt rules for subagent execution

Token impact: 2437 → 2643 (+206, 8.5%)

Closes #228
@lossyrob lossyrob added the enhancement New feature or request label Feb 9, 2026
@lossyrob lossyrob marked this pull request as draft February 9, 2026 18:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fleet Mode Integration: Express PAW workflow as SQL todo graph

1 participant