route - SKILL.md Agent Skill

name: route description: Analyze project state and route user to the appropriate agent based on current context. version: 1.0.0

Analyze project state and route user to the appropriate agent. - User runs `/specsmd-fire` on initialized project - After any agent completes its task ALWAYS scan file system for intents/work-items not in state.yaml FILE SYSTEM is source of truth — state.yaml may be incomplete Route based on VERIFIED state, not assumptions Read .specs-fire/state.yaml

<file_system_scan critical="true">
  Use these EXACT glob patterns:

  <pattern purpose="Find intent briefs">
    .specs-fire/intents/*/brief.md
  </pattern>

  <pattern purpose="Find work items">
    .specs-fire/intents/*/work-items/*.md
  </pattern>

  Work items are {work-item-id}.md files directly in work-items/ folder.
</file_system_scan>

<action>Reconcile: add discovered items to state as pending</action>
<action>Parse current project state</action>

Resuming active run: {runs.active[0].id} Scope: {runs.active[0].scope} Current item: {runs.active[0].current_item} Progress: {completed_count}/{total_count} items builder-agent (run-execute) Find work items with status == pending across all intents **{pending_count} pending work items** found across {intent_count} intent(s).

    Plan run scope and start execution? [Y/n]
  </output>
  <check if="response == y">
    <route_to>builder-agent (run-plan)</route_to>
  </check>
  <stop/>
</check>

Find intents with status == in_progress Intent "{intent.title}" needs decomposition. Routing to Planner to create work items. planner-agent (work-item-decompose) Mark intent as completed Intent "{intent.title}" completed!

    Work items delivered:
    {list completed work items}

    Ready for next intent? [Y/n]
  </output>
</check>

No active work. Ready for a new intent.

  What do you want to build?
</output>
<route_to>planner-agent (intent-capture)</route_to>

state.yaml + file system scan
    │
    ├── runs.active? ─────────────> Builder (run-execute, resume)
    │
    ├── pending work items? ──────> Builder (run-plan, then execute)
    │
    ├── intent without work items? > Planner (work-item-decompose)
    │
    └── no active intents ────────> Planner (intent-capture)

**To Planner:**

context:
  action: intent-capture | work-item-decompose
  intent_id: {if decomposing}

To Builder:

context:
  action: run-plan | run-execute | resume
  pending_items: [{list of pending work items}]  # for run-plan
  run_id: {if resuming}

File system scanned for untracked intents/work-items State reconciled with file system Correct agent selected based on state Context passed to target agent