@thierrynakoa/fire-flow 10.0.0 → 12.2.1

package/commands/fire-research.md

@@ -1,246 +1,246 @@
-# /fire-research
-
-> Daily AI research-to-upgrade pipeline — search papers, score findings, implement in waves
-
----
-
-## Purpose
-
-Systematic daily workflow for finding, evaluating, and implementing AI research improvements into dominion-flow. Eliminates the need to explain the process each session — any fresh agent follows this pipeline autonomously.
-
-**Proven track record:** 7 successful executions (v3.2 through v8.0), producing 70+ implemented enhancements from 200+ papers analyzed.
-
----
-
-## Arguments
-
-```yaml
-arguments:
-  focus:
-    required: false
-    type: string
-    description: "Research focus area (e.g., 'memory consolidation', 'failure taxonomy')"
-    example: "/fire-research agent confidence calibration"
-
-optional_flags:
-  --scan-only: "Research and score papers but don't implement (reconnaissance mode)"
-  --from-deferred: "Start from deferred candidates of last version"
-  --quick: "Single agent search instead of parallel (faster, less thorough)"
-```
-
----
-
-## Process
-
-### Step 1: Load the Research Pipeline Skill
-
-Read the full methodology skill — it contains scoring matrices, wave templates, and citation formats refined across 7 versions:
-
-```
-@skills-library/methodology/RESEARCH_BACKED_WORKFLOW_UPGRADE.md
-```
-
-**This is MANDATORY.** The skill contains the paper scoring matrix, gap taxonomy, wave grouping rules, and citation format. Do not skip.
-
-### Step 2: Determine Focus Area
-
-**If arguments provided:** Use as focus area directly.
-
-**If `--from-deferred`:** Check MEMORY.md and recent handoffs for deferred candidates:
-```bash
-cd ~/.claude/memory
-npm run search -- "deferred candidate" --type handoff --limit 5
-```
-
-**If no arguments:** Ask user:
-
-```
-What area should we research today?
-
-Recent deferred candidates from previous versions:
-1. [List from memory search]
-2. [List from memory search]
-
-Or describe a new focus area:
-> [User input]
-```
-
-### Step 3: Launch Parallel Research Agents
-
-Launch 3-4 agents in a SINGLE message for true parallelism:
-
-```
-Agent 1: Academic Papers (arXiv, ACL, NeurIPS, ICML, ICLR — 2024-2026)
-  - Search: "[focus area] AI agent 2025 2026"
-  - Extract per paper: title, venue, date, key finding, measurable result,
-    how it maps to our workflow, specific file/step it would modify
-  - Return: Top 15 papers ranked by APPLICABILITY
-
-Agent 2: Community Patterns + Industry Tools
-  - Search: Manus AI, Replit Agent, Cursor, Devin, SWE-Agent, Claude Code
-  - Focus: What do production AI coding tools do that we don't?
-  - Return: Top 10 patterns with source links
-
-Agent 3: Internal Gap Analysis (Explore subagent)
-  - Read: All workflow files in the dominion-flow plugin directory
-  - Classify each gap: MEMORY | REFLECTION | PLANNING | ACTION | SYSTEM
-  - Return: Top 10 gaps ranked by impact
-
-Agent 4 (optional): Failure Pattern Mining
-  - Search Qdrant: debug_resolution + failure_pattern source types
-  - Find recurring failures indicating systemic gaps
-  - Return: Top 5 failure patterns
-```
-
-### Step 4: Score Papers With Matrix
-
-When agents return, evaluate each finding:
-
-| Criterion | Weight | Scoring |
-|-----------|--------|---------|
-| Recency | 15% | 2026=5, 2025=4, 2024=3, older=1 |
-| Measurable Results | 25% | Has numbers=5, qualitative=3, none=1 |
-| Applicability | 30% | Maps to specific file=5, general=3, tangential=1 |
-| Novelty | 15% | Don't do this at all=5, partial=3, already done=0 |
-| Implementation Cost | 15% | <10 lines=5, <50 lines=3, architectural=1 |
-
-**Threshold:** Score < 3.0 = deferred. Score > 4.0 = Wave 1.
-
-Present scored results to user:
-
-```
-=============================================================
-            RESEARCH RESULTS — [Focus Area]
-=============================================================
-
-Papers/Patterns Analyzed: [N]
-Above threshold (≥3.0): [N]
-Wave 1 candidates (≥4.0): [N]
-
--------------------------------------------------------------
-TOP FINDINGS (sorted by score)
--------------------------------------------------------------
-
-1. [Paper Name] ([Venue] [Year]) — Score: 4.7
-   Finding: [key result]
-   Maps to: [specific file/step]
-
-2. [Paper Name] ([Venue] [Year]) — Score: 4.3
-   ...
-
--------------------------------------------------------------
-INTERNAL GAPS (from Agent 3)
--------------------------------------------------------------
-
-1. [GAP-MEMORY] [description] — Score: 4.5
-2. [GAP-PLANNING] [description] — Score: 3.8
-
--------------------------------------------------------------
-DEFERRED (< 3.0, tracked for next version)
--------------------------------------------------------------
-
-- [Paper] — Score: 2.7 — Reason: [why deferred]
-
-=============================================================
-```
-
-**If `--scan-only`:** Stop here. Save findings to handoff.
-
-### Step 5: Group Into Waves
-
-Not tiers (priority) — WAVES (dependency order):
-
-```
-Wave 1: Foundation (no dependencies)
-  - [changes that can be implemented immediately]
-
-Wave 2: Intelligence (builds on Wave 1)
-  - [logic that USES Wave 1 structures]
-
-Wave 3: Decision (builds on Wave 2)
-  - [higher-order patterns integrating Wave 1+2]
-```
-
-Confirm wave plan with user before implementing.
-
-### Step 6: Implement Wave by Wave
-
-For each wave:
-1. Implement changes with inline citations:
-   ```
-   > **Research basis (vX.Y):** [Paper] ([Venue] [Year]) — [finding].
-   > Applied: [what changed and why].
-   ```
-2. Verify wave works before starting next
-3. Track deferred candidates
-
-### Step 7: Post-Implementation
-
-After all waves complete:
-
-- [ ] **Version bump** — Update plugin version (semver minor for additions)
-- [ ] **Generate report** — Save to `~/Documents/Claude Reports/`
-- [ ] **Index into Qdrant** — `cd your-memory-repo && npm run index`
-- [ ] **Update MEMORY.md** — Add concise entry with paper count, changes, key insight
-- [ ] **Track deferred** — Add to handoff for next session's `/fire-research --from-deferred`
-
-### Completion Display
-
-```
-=============================================================
-            FIRE RESEARCH COMPLETE
-=============================================================
-
-Version: [old] → [new]
-Papers Analyzed: [N] from [N] parallel agents
-Findings Above Threshold: [N]
-Changes Implemented: [N] across [N] waves
-
--------------------------------------------------------------
-WAVE SUMMARY
--------------------------------------------------------------
-
-Wave 1: [N] changes — [brief description]
-Wave 2: [N] changes — [brief description]
-
-Files Modified: [N]
-Key Insight: [one sentence]
-
--------------------------------------------------------------
-DEFERRED TO NEXT VERSION
--------------------------------------------------------------
-
-- [paper/pattern] — [reason]
-
--------------------------------------------------------------
-NEXT STEPS
--------------------------------------------------------------
-
--> Run `/fire-4-verify` to validate changes
--> Run `/fire-5-handoff` to save session state
--> Tomorrow: `/fire-research --from-deferred`
-
-=============================================================
-```
-
----
-
-## Success Criteria
-
-- [ ] Research pipeline skill loaded
-- [ ] Focus area determined (from args, deferred, or user)
-- [ ] 3-4 parallel research agents launched
-- [ ] Papers scored with 5-criterion matrix
-- [ ] Findings grouped into dependency-ordered waves
-- [ ] Each change has inline research citation
-- [ ] Deferred candidates tracked
-- [ ] Version bumped, report generated, memory indexed
-
----
-
-## Related Commands
-
-- `/fire-search` — Search existing skills library
-- `/fire-add-new-skill` — Contribute individual skill from session
-- `/fire-4-verify` — Verify changes after implementation
-- `/fire-5-handoff` — Save session state with deferred candidates
+# /fire-research
+
+> Daily AI research-to-upgrade pipeline — search papers, score findings, implement in waves
+
+---
+
+## Purpose
+
+Systematic daily workflow for finding, evaluating, and implementing AI research improvements into fire-flow. Eliminates the need to explain the process each session — any fresh agent follows this pipeline autonomously.
+
+**Proven track record:** 7 successful executions (v3.2 through v8.0), producing 70+ implemented enhancements from 200+ papers analyzed.
+
+---
+
+## Arguments
+
+```yaml
+arguments:
+  focus:
+    required: false
+    type: string
+    description: "Research focus area (e.g., 'memory consolidation', 'failure taxonomy')"
+    example: "/fire-research agent confidence calibration"
+
+optional_flags:
+  --scan-only: "Research and score papers but don't implement (reconnaissance mode)"
+  --from-deferred: "Start from deferred candidates of last version"
+  --quick: "Single agent search instead of parallel (faster, less thorough)"
+```
+
+---
+
+## Process
+
+### Step 1: Load the Research Pipeline Skill
+
+Read the full methodology skill — it contains scoring matrices, wave templates, and citation formats refined across 7 versions:
+
+```
+@skills-library/methodology/RESEARCH_BACKED_WORKFLOW_UPGRADE.md
+```
+
+**This is MANDATORY.** The skill contains the paper scoring matrix, gap taxonomy, wave grouping rules, and citation format. Do not skip.
+
+### Step 2: Determine Focus Area
+
+**If arguments provided:** Use as focus area directly.
+
+**If `--from-deferred`:** Check MEMORY.md and recent handoffs for deferred candidates:
+```bash
+cd ~/.claude/memory
+npm run search -- "deferred candidate" --type handoff --limit 5
+```
+
+**If no arguments:** Ask user:
+
+```
+What area should we research today?
+
+Recent deferred candidates from previous versions:
+1. [List from memory search]
+2. [List from memory search]
+
+Or describe a new focus area:
+> [User input]
+```
+
+### Step 3: Launch Parallel Research Agents
+
+Launch 3-4 agents in a SINGLE message for true parallelism:
+
+```
+Agent 1: Academic Papers (arXiv, ACL, NeurIPS, ICML, ICLR — 2024-2026)
+  - Search: "[focus area] AI agent 2025 2026"
+  - Extract per paper: title, venue, date, key finding, measurable result,
+    how it maps to our workflow, specific file/step it would modify
+  - Return: Top 15 papers ranked by APPLICABILITY
+
+Agent 2: Community Patterns + Industry Tools
+  - Search: Manus AI, Replit Agent, Cursor, Devin, SWE-Agent, Claude Code
+  - Focus: What do production AI coding tools do that we don't?
+  - Return: Top 10 patterns with source links
+
+Agent 3: Internal Gap Analysis (Explore subagent)
+  - Read: All workflow files in the fire-flow plugin directory
+  - Classify each gap: MEMORY | REFLECTION | PLANNING | ACTION | SYSTEM
+  - Return: Top 10 gaps ranked by impact
+
+Agent 4 (optional): Failure Pattern Mining
+  - Search Qdrant: debug_resolution + failure_pattern source types
+  - Find recurring failures indicating systemic gaps
+  - Return: Top 5 failure patterns
+```
+
+### Step 4: Score Papers With Matrix
+
+When agents return, evaluate each finding:
+
+| Criterion | Weight | Scoring |
+|-----------|--------|---------|
+| Recency | 15% | 2026=5, 2025=4, 2024=3, older=1 |
+| Measurable Results | 25% | Has numbers=5, qualitative=3, none=1 |
+| Applicability | 30% | Maps to specific file=5, general=3, tangential=1 |
+| Novelty | 15% | Don't do this at all=5, partial=3, already done=0 |
+| Implementation Cost | 15% | <10 lines=5, <50 lines=3, architectural=1 |
+
+**Threshold:** Score < 3.0 = deferred. Score > 4.0 = Wave 1.
+
+Present scored results to user:
+
+```
+=============================================================
+            RESEARCH RESULTS — [Focus Area]
+=============================================================
+
+Papers/Patterns Analyzed: [N]
+Above threshold (≥3.0): [N]
+Wave 1 candidates (≥4.0): [N]
+
+-------------------------------------------------------------
+TOP FINDINGS (sorted by score)
+-------------------------------------------------------------
+
+1. [Paper Name] ([Venue] [Year]) — Score: 4.7
+   Finding: [key result]
+   Maps to: [specific file/step]
+
+2. [Paper Name] ([Venue] [Year]) — Score: 4.3
+   ...
+
+-------------------------------------------------------------
+INTERNAL GAPS (from Agent 3)
+-------------------------------------------------------------
+
+1. [GAP-MEMORY] [description] — Score: 4.5
+2. [GAP-PLANNING] [description] — Score: 3.8
+
+-------------------------------------------------------------
+DEFERRED (< 3.0, tracked for next version)
+-------------------------------------------------------------
+
+- [Paper] — Score: 2.7 — Reason: [why deferred]
+
+=============================================================
+```
+
+**If `--scan-only`:** Stop here. Save findings to handoff.
+
+### Step 5: Group Into Waves
+
+Not tiers (priority) — WAVES (dependency order):
+
+```
+Wave 1: Foundation (no dependencies)
+  - [changes that can be implemented immediately]
+
+Wave 2: Intelligence (builds on Wave 1)
+  - [logic that USES Wave 1 structures]
+
+Wave 3: Decision (builds on Wave 2)
+  - [higher-order patterns integrating Wave 1+2]
+```
+
+Confirm wave plan with user before implementing.
+
+### Step 6: Implement Wave by Wave
+
+For each wave:
+1. Implement changes with inline citations:
+   ```
+   > **Research basis (vX.Y):** [Paper] ([Venue] [Year]) — [finding].
+   > Applied: [what changed and why].
+   ```
+2. Verify wave works before starting next
+3. Track deferred candidates
+
+### Step 7: Post-Implementation
+
+After all waves complete:
+
+- [ ] **Version bump** — Update plugin version (semver minor for additions)
+- [ ] **Generate report** — Save to `~/Documents/Claude Reports/`
+- [ ] **Index into Qdrant** — `cd your-memory-repo && npm run index`
+- [ ] **Update MEMORY.md** — Add concise entry with paper count, changes, key insight
+- [ ] **Track deferred** — Add to handoff for next session's `/fire-research --from-deferred`
+
+### Completion Display
+
+```
+=============================================================
+            FIRE RESEARCH COMPLETE
+=============================================================
+
+Version: [old] → [new]
+Papers Analyzed: [N] from [N] parallel agents
+Findings Above Threshold: [N]
+Changes Implemented: [N] across [N] waves
+
+-------------------------------------------------------------
+WAVE SUMMARY
+-------------------------------------------------------------
+
+Wave 1: [N] changes — [brief description]
+Wave 2: [N] changes — [brief description]
+
+Files Modified: [N]
+Key Insight: [one sentence]
+
+-------------------------------------------------------------
+DEFERRED TO NEXT VERSION
+-------------------------------------------------------------
+
+- [paper/pattern] — [reason]
+
+-------------------------------------------------------------
+NEXT STEPS
+-------------------------------------------------------------
+
+-> Run `/fire-4-verify` to validate changes
+-> Run `/fire-5-handoff` to save session state
+-> Tomorrow: `/fire-research --from-deferred`
+
+=============================================================
+```
+
+---
+
+## Success Criteria
+
+- [ ] Research pipeline skill loaded
+- [ ] Focus area determined (from args, deferred, or user)
+- [ ] 3-4 parallel research agents launched
+- [ ] Papers scored with 5-criterion matrix
+- [ ] Findings grouped into dependency-ordered waves
+- [ ] Each change has inline research citation
+- [ ] Deferred candidates tracked
+- [ ] Version bumped, report generated, memory indexed
+
+---
+
+## Related Commands
+
+- `/fire-search` — Search existing skills library
+- `/fire-add-new-skill` — Contribute individual skill from session
+- `/fire-4-verify` — Verify changes after implementation
+- `/fire-5-handoff` — Save session state with deferred candidates

package/commands/fire-search.md

@@ -73,7 +73,7 @@ Type: [keyword | category | tag | problem]
 ### Search Skills Library
 
 Search across all skill files in:
-- `~/.claude/plugins/dominion-flow/skills-library/`
+- `~/.claude/plugins/fire-flow/skills-library/`
 
 Categories to search (15 total):
 1. `database-solutions/` - Database patterns, queries, optimization

package/commands/fire-skills-diff.md

@@ -102,7 +102,7 @@ else:
 Fetch content for both versions:
 
 ```bash
-cd ~/.claude/plugins/dominion-flow/skills-library
+cd ~/.claude/plugins/fire-flow/skills-library
 
 # Get v1 content
 v1_content=$(git show {v1_ref}:{category}/{skill-name}.md)
@@ -111,7 +111,7 @@ v1_content=$(git show {v1_ref}:{category}/{skill-name}.md)
 v2_content=$(git show {v2_ref}:{category}/{skill-name}.md)
 
 # For project vs global comparison
-v1_content=$(cat ~/.claude/plugins/dominion-flow/skills-library/{category}/{skill-name}.md)
+v1_content=$(cat ~/.claude/plugins/fire-flow/skills-library/{category}/{skill-name}.md)
 v2_content=$(cat ~/.claude/fire-skills-global/{category}/{skill-name}.md)
 ```
 </step>
@@ -450,7 +450,7 @@ Output includes library-specific information:
 Skill: database-solutions/n-plus-1
 
 PROJECT LIBRARY:
-  Path:    ~/.claude/plugins/dominion-flow/skills-library/
+  Path:    ~/.claude/plugins/fire-flow/skills-library/
   Version: v2.1.0
   Updated: 2026-01-22
 

package/commands/fire-skills-history.md

@@ -27,7 +27,7 @@ View the complete version history, changelogs, and contributors for any skill.
 ## Prerequisites
 
 The skills library must be git-versioned:
-- `~/.claude/plugins/dominion-flow/skills-library/.git/`
+- `~/.claude/plugins/fire-flow/skills-library/.git/`
 - `~/.claude/fire-skills-global/.git/` (for global library)
 
 ## Arguments
@@ -64,7 +64,7 @@ Check if the skill file exists:
 
 ```bash
 # Check project library
-ls ~/.claude/plugins/dominion-flow/skills-library/{category}/{skill-name}.md
+ls ~/.claude/plugins/fire-flow/skills-library/{category}/{skill-name}.md
 
 # Check global library (if --global)
 ls ~/.claude/fire-skills-global/{category}/{skill-name}.md
@@ -88,7 +88,7 @@ Search for skills: /fire-search "{skill-name}"
 Query git log for the skill file:
 
 ```bash
-cd ~/.claude/plugins/dominion-flow/skills-library
+cd ~/.claude/plugins/fire-flow/skills-library
 
 git log --follow --format="%H|%ai|%an|%s" -- {category}/{skill-name}.md
 ```

package/commands/fire-skills-rollback.md

@@ -31,7 +31,7 @@ Restore a skill to a previous version from the git-backed skills library.
 ## Prerequisites
 
 The skills library must be git-versioned:
-- `~/.claude/plugins/dominion-flow/skills-library/.git/`
+- `~/.claude/plugins/fire-flow/skills-library/.git/`
 
 ## Arguments
 
@@ -68,10 +68,10 @@ Verify skill and version exist:
 
 ```bash
 # Check skill exists
-ls ~/.claude/plugins/dominion-flow/skills-library/{category}/{skill-name}.md
+ls ~/.claude/plugins/fire-flow/skills-library/{category}/{skill-name}.md
 
 # Find version in git history
-cd ~/.claude/plugins/dominion-flow/skills-library
+cd ~/.claude/plugins/fire-flow/skills-library
 git log --oneline -- {category}/{skill-name}.md | grep -i "v{version}"
 ```
 
@@ -201,7 +201,7 @@ Proceed with rollback?
 Upon confirmation:
 
 ```bash
-cd ~/.claude/plugins/dominion-flow/skills-library
+cd ~/.claude/plugins/fire-flow/skills-library
 
 # Checkout the target version
 git show {commit-hash}:{category}/{skill-name}.md > {category}/{skill-name}.md
@@ -262,7 +262,7 @@ Changes reverted:
   - {change 3 that was undone}
 
 Skill file updated:
-  ~/.claude/plugins/dominion-flow/skills-library/{category}/{skill-name}.md
+  ~/.claude/plugins/fire-flow/skills-library/{category}/{skill-name}.md
 
 SKILLS-INDEX.md updated:
   - Rollback recorded in history
@@ -357,7 +357,7 @@ If you need to undo a rollback:
 /fire-skills-sync --pull --skill {skill}
 
 # Option 3: Git reset (advanced)
-cd ~/.claude/plugins/dominion-flow/skills-library
+cd ~/.claude/plugins/fire-flow/skills-library
 git revert HEAD  # Reverts the rollback commit
 ```
 
@@ -388,7 +388,7 @@ Available versions: v2.1.0, v2.0.0, v1.2.0, v1.1.0, v1.0.0
 **Git not initialized:**
 ```
 Error: Skills library is not git-versioned
-Initialize with: cd ~/.claude/plugins/dominion-flow/skills-library && git init
+Initialize with: cd ~/.claude/plugins/fire-flow/skills-library && git init
 ```
 
 **Uncommitted changes:**

package/commands/fire-skills-sync.md

@@ -30,7 +30,7 @@ Synchronize skills between the project skills library and the global skills libr
 
 | Library | Path | Purpose |
 |---------|------|---------|
-| **Project** | `~/.claude/plugins/dominion-flow/skills-library/` | Plugin-bundled skills |
+| **Project** | `~/.claude/plugins/fire-flow/skills-library/` | Plugin-bundled skills |
 | **Global** | `~/.claude/fire-skills-global/` | User's personal skills across all projects |
 
 ## Arguments
@@ -136,7 +136,7 @@ For each skill in global library:
                     SKILLS SYNC REPORT
 =============================================================
 
-Project Library: ~/.claude/plugins/dominion-flow/skills-library/
+Project Library: ~/.claude/plugins/fire-flow/skills-library/
 Global Library:  ~/.claude/fire-skills-global/
 
 -------------------------------------------------------------
@@ -307,7 +307,7 @@ Based on direction:
 **Push (project -> global):**
 ```bash
 # For each new/updated skill
-cp ~/.claude/plugins/dominion-flow/skills-library/{category}/{skill}.md \
+cp ~/.claude/plugins/fire-flow/skills-library/{category}/{skill}.md \
    ~/.claude/fire-skills-global/{category}/{skill}.md
 
 # Update global index
@@ -323,13 +323,13 @@ git commit -m "sync: Push {N} skills from {project-name}"
 ```bash
 # For each new/updated skill
 cp ~/.claude/fire-skills-global/{category}/{skill}.md \
-   ~/.claude/plugins/dominion-flow/skills-library/{category}/{skill}.md
+   ~/.claude/plugins/fire-flow/skills-library/{category}/{skill}.md
 
 # Update project index
 # Merge entries into SKILLS-INDEX.md
 
 # Git commit if skills-library is versioned
-cd ~/.claude/plugins/dominion-flow/skills-library
+cd ~/.claude/plugins/fire-flow/skills-library
 git add .
 git commit -m "sync: Pull {N} skills from global library"
 ```