specsmd 0.0.0-dev.9 → 0.0.0-dev.90

package/flows/fire/agents/orchestrator/skills/project-init/templates/testing-standards.md.hbs

@@ -0,0 +1,94 @@
+# Testing Standards
+
+## Overview
+
+{{overview}}
+
+## Testing Framework
+
+**Framework**: {{framework}}
+**Runner**: {{runner}}
+
+## Test Types
+
+| Type | Tool | Location | When to Use |
+|------|------|----------|-------------|
+{{#each test_types}}
+| {{this.type}} | {{this.tool}} | `{{this.location}}` | {{this.when}} |
+{{/each}}
+
+## Coverage Requirements
+
+**Target**: {{coverage_target}}%
+**Enforcement**: {{coverage_enforcement}}
+
+**Critical paths that MUST have coverage:**
+{{#each critical_paths}}
+- {{this}}
+{{/each}}
+
+## Test Naming
+
+**Pattern**: `{{naming_pattern}}`
+
+**Examples**:
+{{#each naming_examples}}
+- `{{this.name}}` — {{this.description}}
+{{/each}}
+
+## Test Structure
+
+```{{language}}
+{{test_structure}}
+```
+
+## Mock Strategy
+
+**Approach**: {{mock_approach}}
+
+**Guidelines**:
+{{#each mock_guidelines}}
+- {{this}}
+{{/each}}
+
+## Test Data
+
+**Strategy**: {{test_data_strategy}}
+
+**Guidelines**:
+{{#each test_data_guidelines}}
+- {{this}}
+{{/each}}
+
+## Running Tests
+
+```bash
+# Run all tests
+{{run_all_command}}
+
+# Run with coverage
+{{run_coverage_command}}
+
+# Run specific test file
+{{run_single_command}}
+
+# Run in watch mode
+{{run_watch_command}}
+```
+
+## CI/CD Integration
+
+{{#if ci_enabled}}
+**Pipeline**: {{ci_pipeline}}
+**Trigger**: {{ci_trigger}}
+
+**Required gates**:
+{{#each ci_gates}}
+- {{this}}
+{{/each}}
+{{else}}
+CI/CD integration not configured.
+{{/if}}
+
+---
+*Generated by specs.md - fabriqa.ai FIRE Flow*

package/flows/fire/agents/orchestrator/skills/route/SKILL.md

@@ -0,0 +1,146 @@
+---
+name: route
+description: Analyze project state and route user to the appropriate agent based on current context.
+version: 1.0.0
+---
+
+<objective>
+Analyze project state and route user to the appropriate agent.
+</objective>
+
+<triggers>
+  - User runs `/specsmd-fire` on initialized project
+  - After any agent completes its task
+</triggers>
+
+<llm critical="true">
+  <mandate>ALWAYS scan file system for intents/work-items not in state.yaml</mandate>
+  <mandate>FILE SYSTEM is source of truth — state.yaml may be incomplete</mandate>
+  <mandate>Route based on VERIFIED state, not assumptions</mandate>
+</llm>
+
+<flow>
+  <step n="1" title="Discover and Read State">
+    <action>Read .specs-fire/state.yaml</action>
+
+    <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>
+  </step>
+
+  <step n="2" title="Check Active Run">
+    <check if="runs.active is not empty">
+      <output>
+        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
+      </output>
+      <route_to>builder-agent (run-execute)</route_to>
+      <stop/>
+    </check>
+  </step>
+
+  <step n="3" title="Check Pending Work Items">
+    <action>Find work items with status == pending across all intents</action>
+    <check if="pending work items exist">
+      <output>
+        **{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>
+  </step>
+
+  <step n="4" title="Check Active Intent">
+    <action>Find intents with status == in_progress</action>
+    <check if="active intent has no work items">
+      <output>
+        Intent "{intent.title}" needs decomposition.
+        Routing to Planner to create work items.
+      </output>
+      <route_to>planner-agent (work-item-decompose)</route_to>
+      <stop/>
+    </check>
+    <check if="all work items completed">
+      <action>Mark intent as completed</action>
+      <output>
+        Intent "{intent.title}" completed!
+
+        Work items delivered:
+        {list completed work items}
+
+        Ready for next intent? [Y/n]
+      </output>
+    </check>
+  </step>
+
+  <step n="5" title="No Active Work">
+    <output>
+      No active work. Ready for a new intent.
+
+      What do you want to build?
+    </output>
+    <route_to>planner-agent (intent-capture)</route_to>
+  </step>
+</flow>
+
+<routing_decision_tree>
+
+  ```
+  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)
+  ```
+
+</routing_decision_tree>
+
+<context_passed_to_agents>
+  **To Planner:**
+
+  ```yaml
+  context:
+    action: intent-capture | work-item-decompose
+    intent_id: {if decomposing}
+  ```
+
+  **To Builder:**
+
+  ```yaml
+  context:
+    action: run-plan | run-execute | resume
+    pending_items: [{list of pending work items}]  # for run-plan
+    run_id: {if resuming}
+  ```
+
+</context_passed_to_agents>
+
+<success_criteria>
+  <criterion>File system scanned for untracked intents/work-items</criterion>
+  <criterion>State reconciled with file system</criterion>
+  <criterion>Correct agent selected based on state</criterion>
+  <criterion>Context passed to target agent</criterion>
+</success_criteria>