specsmd 0.0.0-dev.43 → 0.0.0-dev.44

package/flows/fire/README.md

@@ -2,129 +2,18 @@
 
 **Fast Intent-Run Engineering** — A simplified AI-native development methodology.
 
-## Overview
+For getting started, see [quick-start.md](./quick-start.md).
 
-FIRE reduces the complexity of AI-assisted development by flattening the hierarchy:
+## Summary
 
-```
-Intent → Work Item → Run
-```
+- **Hierarchy**: Intent → Work Item → Run
+- **Checkpoints**: 0-2 (adaptive based on complexity)
+- **Agents**: Orchestrator, Planner, Builder
 
-Unlike traditional methodologies with 10-26 checkpoints, FIRE uses adaptive checkpoints (0-2) based on work item complexity.
+## Commands
 
-## Quick Start
-
-```bash
-# Initialize FIRE in your project
-/specsmd-fire
-
-# Or directly invoke specific agents
-/specsmd-fire-planner    # For planning work
-/specsmd-fire-builder    # For executing work
-```
-
-## Execution Modes
-
-| Mode | Checkpoints | Complexity | Use For |
-|------|-------------|------------|---------|
-| **Autopilot** | 0 | Low | Bug fixes, minor updates |
-| **Confirm** | 1 | Medium | Standard features |
-| **Validate** | 2 | High | Security, payments, architecture |
-
-## Project Structure
-
-When initialized, FIRE creates:
-
-```
-.specs-fire/
-├── state.yaml           # Central state (source of truth)
-├── intents/             # Intent briefs and work items
-│   └── {intent-id}/
-│       ├── brief.md
-│       └── work-items/
-│           └── {work-item-id}.md
-├── runs/                # Run logs and walkthroughs
-│   └── {run-id}/
-│       ├── run.md
-│       └── walkthrough.md
-└── standards/           # Project standards
-    ├── tech-stack.md
-    └── coding-standards.md
-```
-
-## Agents
-
-### Orchestrator (`/specsmd-fire`)
-
-Routes users based on project state:
-- New project → Initialize
-- No intent → Capture intent
-- No work items → Decompose
-- Pending work → Execute
-
-### Planner (`/specsmd-fire-planner`)
-
-Handles planning:
-- **intent-capture** — Capture user intent through conversation
-- **work-item-decompose** — Break intent into executable work items
-- **design-doc-generate** — Create design docs for Validate mode
-
-### Builder (`/specsmd-fire-builder`)
-
-Handles execution:
-- **run-execute** — Execute work items with mode-appropriate checkpoints
-- **walkthrough-generate** — Generate implementation documentation
-- **run-status** — Show current run progress
-
-## Flow Directory Structure
-
-```
-src/flows/fire/
-├── agents/
-│   ├── orchestrator/
-│   │   ├── agent.md
-│   │   └── skills/
-│   │       ├── project-init/
-│   │       ├── route/
-│   │       └── status/
-│   ├── planner/
-│   │   ├── agent.md
-│   │   └── skills/
-│   │       ├── intent-capture/
-│   │       ├── work-item-decompose/
-│   │       └── design-doc-generate/
-│   └── builder/
-│       ├── agent.md
-│       └── skills/
-│           ├── run-execute/
-│           ├── walkthrough-generate/
-│           └── run-status/
-├── commands/
-│   ├── fire.md
-│   ├── fire-planner.md
-│   └── fire-builder.md
-├── templates/
-│   ├── intents/
-│   ├── runs/
-│   └── standards/
-├── fire-config.yaml
-└── README.md
-```
-
-## Comparison with AI-DLC
-
-| Aspect | AI-DLC | FIRE |
-|--------|--------|------|
-| Hierarchy | Intent → Unit → Story | Intent → Work Item |
-| Checkpoints | 10-26 per feature | 0-2 per work item |
-| Phases | Inception → Construction → Operations | Plan → Execute |
-| Artifacts | Extensive | Minimal |
-| Best for | Large initiatives, teams | Rapid delivery, individuals |
-
-## Configuration
-
-See `fire-config.yaml` for:
-- Artifact paths
-- Naming conventions
-- Execution modes
-- Agent ownership
+| Command | Purpose |
+|---------|---------|
+| `/specsmd-fire` | Main entry point (orchestrator) |
+| `/specsmd-fire-planner` | Planning and decomposition |
+| `/specsmd-fire-builder` | Execution and walkthroughs |

package/flows/fire/agents/builder/skills/run-execute/SKILL.md

@@ -4,6 +4,31 @@ Execute a work item based on its assigned mode (autopilot, confirm, validate).
 
 ---
 
+## Prerequisites
+
+Before executing scripts, ensure required dependencies are installed:
+
+```xml
+<prerequisite-check>
+  <step n="1" title="Check yaml Package">
+    <action>Run: npm list yaml --depth=0 2>/dev/null || echo "NOT_FOUND"</action>
+    <check if="output contains NOT_FOUND">
+      <output>
+        Installing required dependency: yaml
+      </output>
+      <action>Run: npm install yaml</action>
+    </check>
+  </step>
+</prerequisite-check>
+```
+
+**Required packages:**
+| Package | Purpose | Install Command |
+|---------|---------|-----------------|
+| `yaml` | Parse/stringify state.yaml | `npm install yaml` |
+
+---
+
 ## Trigger
 
 - Pending work item ready for execution

package/flows/fire/quick-start.md

@@ -0,0 +1,130 @@
+# FIRE Flow
+
+**Fast Intent-Run Engineering** — A simplified AI-native development methodology.
+
+## Overview
+
+FIRE reduces the complexity of AI-assisted development by flattening the hierarchy:
+
+```
+Intent → Work Item → Run
+```
+
+Unlike traditional methodologies with 10-26 checkpoints, FIRE uses adaptive checkpoints (0-2) based on work item complexity.
+
+## Quick Start
+
+```bash
+# Initialize FIRE in your project
+/specsmd-fire
+
+# Or directly invoke specific agents
+/specsmd-fire-planner    # For planning work
+/specsmd-fire-builder    # For executing work
+```
+
+## Execution Modes
+
+| Mode | Checkpoints | Complexity | Use For |
+|------|-------------|------------|---------|
+| **Autopilot** | 0 | Low | Bug fixes, minor updates |
+| **Confirm** | 1 | Medium | Standard features |
+| **Validate** | 2 | High | Security, payments, architecture |
+
+## Project Structure
+
+When initialized, FIRE creates:
+
+```
+.specs-fire/
+├── state.yaml           # Central state (source of truth)
+├── intents/             # Intent briefs and work items
+│   └── {intent-id}/
+│       ├── brief.md
+│       └── work-items/
+│           └── {work-item-id}.md
+├── runs/                # Run logs and walkthroughs
+│   └── {run-id}/
+│       ├── run.md
+│       └── walkthrough.md
+└── standards/           # Project standards
+    ├── tech-stack.md
+    └── coding-standards.md
+```
+
+## Agents
+
+### Orchestrator (`/specsmd-fire`)
+
+Routes users based on project state:
+- New project → Initialize
+- No intent → Capture intent
+- No work items → Decompose
+- Pending work → Execute
+
+### Planner (`/specsmd-fire-planner`)
+
+Handles planning:
+- **intent-capture** — Capture user intent through conversation
+- **work-item-decompose** — Break intent into executable work items
+- **design-doc-generate** — Create design docs for Validate mode
+
+### Builder (`/specsmd-fire-builder`)
+
+Handles execution:
+- **run-execute** — Execute work items with mode-appropriate checkpoints
+- **walkthrough-generate** — Generate implementation documentation
+- **run-status** — Show current run progress
+
+## Flow Directory Structure
+
+```
+src/flows/fire/
+├── agents/
+│   ├── orchestrator/
+│   │   ├── agent.md
+│   │   └── skills/
+│   │       ├── project-init/
+│   │       ├── route/
+│   │       └── status/
+│   ├── planner/
+│   │   ├── agent.md
+│   │   └── skills/
+│   │       ├── intent-capture/
+│   │       ├── work-item-decompose/
+│   │       └── design-doc-generate/
+│   └── builder/
+│       ├── agent.md
+│       └── skills/
+│           ├── run-execute/
+│           ├── walkthrough-generate/
+│           └── run-status/
+├── commands/
+│   ├── fire.md
+│   ├── fire-planner.md
+│   └── fire-builder.md
+├── templates/
+│   ├── intents/
+│   ├── runs/
+│   └── standards/
+├── memory-bank.yaml
+└── quick-start.md
+```
+
+## Comparison with AI-DLC
+
+| Aspect | AI-DLC | FIRE |
+|--------|--------|------|
+| Hierarchy | Intent → Unit → Story | Intent → Work Item |
+| Checkpoints | 10-26 per feature | 0-2 per work item |
+| Phases | Inception → Construction → Operations | Plan → Execute |
+| Artifacts | Extensive | Minimal |
+| Best for | Large initiatives, teams | Rapid delivery, individuals |
+
+## Configuration
+
+See `memory-bank.yaml` for:
+- Artifact paths
+- Naming conventions
+- Execution modes
+- Agent ownership

package/lib/constants.js

@@ -17,6 +17,11 @@ const FLOWS = {
         description: 'AI-Driven Development Life Cycle - Best for greenfield projects with AI-native development',
         path: 'aidlc'
     },
+    fire: {
+        name: 'FIRE',
+        description: 'Fast Intent-Run Engineering - Lightweight flow for quick iterations with minimal overhead',
+        path: 'fire'
+    },
     simple: {
         name: 'Simple',
         description: 'Spec-driven development - Best for quick feature specs without full methodology overhead',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.0.0-dev.43",
+  "version": "0.0.0-dev.44",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {