@thierrynakoa/fire-flow 12.2.2 → 13.0.1

package/templates/ASSUMPTIONS.md

@@ -2,7 +2,7 @@
 
 > **Origin:** Dominion Flow v2.0 - Assumption tracking and validation.
 > **Enhanced in v3.2:** Added cross-phase contradiction detection, phase-gate validation,
-> and deferred-item impact analysis. Research basis: Gap analysis found assumptions
+> and deferred-item impact analysis.
 > accumulate across phases without systematic tracking, leading to contradictions.
 > See: references/research-improvements.md (GAP-1, GAP-2, BLIND-SPOT-B)
 

package/templates/DECISION_LOG.md

@@ -1,7 +1,6 @@
 # DECISION_LOG.md Template
 
 > **Origin:** Dominion Flow v3.2 - Research-backed improvement.
-> **Research basis:** Gap analysis found architectural decisions are implicit in git history;
 > cross-phase contradictions occur when rationale is buried in old handoffs.
 > See: references/research-improvements.md (GAP-1, GAP-3, BLIND-SPOT-A)
 

package/templates/phase-prompt.md

@@ -39,7 +39,7 @@ Output: [What artifacts will be created]
 </objective>
 
 <execution_context>
-@~/.claude/plugins/fire-flow/templates/summary.md
+@~/.claude/plugins/dominion-flow/templates/summary.md
 </execution_context>
 
 <honesty_precheck>

package/templates/phoenix-comparison.md

@@ -1,11 +1,11 @@
-# PHOENIX-COMPARISON.md — {Project Name}
+# RESURRECTION-COMPARISON.md — {Project Name}
 
 ---
 generated_at: "{ISO timestamp}"
-generated_by: fire-phoenix
+generated_by: fire-resurrect
 source_path: "{source absolute path}"
 target_path: "{target absolute path}"
-phoenix_score: "{0-100}%"
+resurrection_score: "{0-100}%"
 verdict: "{APPROVED | CONDITIONAL | REJECTED}"
 ---
 
@@ -23,7 +23,7 @@ verdict: "{APPROVED | CONDITIONAL | REJECTED}"
 | Test Files | {N} | {N} | {±N} |
 | Test Coverage | {N}% | {N}% | {±N}pp |
 
-## Phoenix Verification Checks
+## Resurrection Verification Checks
 
 | Check | Weight | Score | Details |
 |-------|--------|-------|---------|
@@ -32,7 +32,7 @@ verdict: "{APPROVED | CONDITIONAL | REJECTED}"
 | PX-3: Dependency Compatibility | 20% | {0-100}% | {N}/{total} external services connected |
 | PX-4: Accidental Complexity Removal | 15% | {0-100}% | {N}/{total} anti-patterns absent from rebuild |
 | PX-5: Architecture Improvement | 10% | {0-100}% | File structure, separation, naming |
-| **Phoenix Score** | **100%** | **{weighted}%** | **{APPROVED / CONDITIONAL / REJECTED}** |
+| **Resurrection Score** | **100%** | **{weighted}%** | **{APPROVED / CONDITIONAL / REJECTED}** |
 
 ## Feature Parity Detail (PX-1)
 
@@ -72,7 +72,7 @@ verdict: "{APPROVED | CONDITIONAL | REJECTED}"
 ## Verdict
 
 ```
-Phoenix Score: {score}% — {APPROVED | CONDITIONAL | REJECTED}
+Resurrection Score: {score}% — {APPROVED | CONDITIONAL | REJECTED}
 
   90%+ = APPROVED    — Rebuild is production-ready
   75-89% = CONDITIONAL — Rebuild needs minor fixes before replacing source

package/templates/skill-api-integration.md

@@ -0,0 +1,106 @@
+---
+name: {{SKILL_NAME}}
+category: {{CATEGORY}}
+type: api-integration
+version: 1.0.0
+contributed: {{DATE}}
+contributor: {{PROJECT}}
+last_updated: {{DATE}}
+tags: [{{TAGS}}]
+difficulty: {{DIFFICULTY}}
+usage_count: 0
+success_rate: 100
+---
+
+# {{TITLE}}
+
+## Problem
+
+[What API integration challenge does this solve?]
+
+## API Overview
+
+| Property | Value |
+|----------|-------|
+| **Service** | [Service name] |
+| **Auth Type** | [OAuth2 / API Key / Bearer / etc.] |
+| **Base URL** | `https://api.example.com/v1` |
+| **Rate Limit** | [X requests per minute/hour] |
+| **Docs** | [Link to official docs] |
+
+## Environment Variables
+
+```env
+# Required
+SERVICE_API_KEY=YOUR_API_KEY
+SERVICE_API_SECRET=YOUR_API_SECRET
+
+# Optional
+SERVICE_BASE_URL=https://api.example.com/v1
+SERVICE_TIMEOUT_MS=5000
+```
+
+## Solution Pattern
+
+### Client Setup
+
+```{{LANGUAGE}}
+{{CLIENT_SETUP_CODE}}
+```
+
+### Core Integration
+
+```{{LANGUAGE}}
+{{INTEGRATION_CODE}}
+```
+
+### Error Handling
+
+```{{LANGUAGE}}
+{{ERROR_HANDLING_CODE}}
+```
+
+## Retry & Resilience
+
+```{{LANGUAGE}}
+// Exponential backoff with jitter for rate limits
+{{RETRY_CODE}}
+```
+
+## Webhook Handling (if applicable)
+
+```{{LANGUAGE}}
+// Signature verification + idempotency
+{{WEBHOOK_CODE}}
+```
+
+## Testing
+
+```{{LANGUAGE}}
+// Mock setup for tests
+{{TEST_MOCK_CODE}}
+```
+
+## Common Pitfalls
+
+1. **[Pitfall 1]** - [How to avoid]
+2. **[Pitfall 2]** - [How to avoid]
+3. **[Pitfall 3]** - [How to avoid]
+
+## When to Use
+
+- [Scenario 1]
+- [Scenario 2]
+
+## When NOT to Use
+
+- [Anti-pattern 1]
+
+## Related Skills
+
+- [related-skill] - [description]
+
+## References
+
+- [Official API docs](https://example.com/docs)
+- Contributed from: {{PROJECT}}

package/templates/skill-architecture-pattern.md

@@ -0,0 +1,92 @@
+---
+name: {{SKILL_NAME}}
+category: {{CATEGORY}}
+type: architecture-pattern
+version: 1.0.0
+contributed: {{DATE}}
+contributor: {{PROJECT}}
+last_updated: {{DATE}}
+tags: [{{TAGS}}]
+difficulty: {{DIFFICULTY}}
+usage_count: 0
+success_rate: 100
+---
+
+# {{TITLE}}
+
+## Problem
+
+[What architectural challenge does this pattern address?]
+
+**Consequences of Ignoring:**
+[What happens if you don't apply this pattern — tech debt, scaling issues, etc.]
+
+## Architecture Diagram
+
+```mermaid
+{{MERMAID_DIAGRAM}}
+```
+
+## Solution Pattern
+
+### Core Concept
+
+[1-2 paragraph explanation of the architectural approach and WHY it works]
+
+### Key Principles
+
+1. **[Principle 1]** - [Explanation]
+2. **[Principle 2]** - [Explanation]
+3. **[Principle 3]** - [Explanation]
+
+### Implementation
+
+```{{LANGUAGE}}
+{{IMPLEMENTATION_CODE}}
+```
+
+### Directory Structure
+
+```
+project/
+├── src/
+│   ├── [layer-1]/     # [Purpose]
+│   ├── [layer-2]/     # [Purpose]
+│   └── [layer-3]/     # [Purpose]
+├── config/
+└── tests/
+```
+
+## Trade-offs
+
+| Benefit | Cost |
+|---------|------|
+| [Benefit 1] | [Cost 1] |
+| [Benefit 2] | [Cost 2] |
+| [Benefit 3] | [Cost 3] |
+
+## Migration Path
+
+If adopting this pattern in an existing codebase:
+
+1. **Phase 1:** [Incremental first step]
+2. **Phase 2:** [Second step]
+3. **Phase 3:** [Final step]
+
+## Decision Criteria
+
+Apply this pattern when:
+- [Criterion 1]
+- [Criterion 2]
+
+Skip this pattern when:
+- [Anti-criterion 1]
+- [Anti-criterion 2]
+
+## Related Skills
+
+- [related-skill] - [description]
+
+## References
+
+- Contributed from: {{PROJECT}}

package/templates/skill-debug-pattern.md

@@ -0,0 +1,98 @@
+---
+name: {{SKILL_NAME}}
+category: {{CATEGORY}}
+type: debug-pattern
+version: 1.0.0
+contributed: {{DATE}}
+contributor: {{PROJECT}}
+last_updated: {{DATE}}
+tags: [{{TAGS}}]
+difficulty: {{DIFFICULTY}}
+usage_count: 0
+success_rate: 100
+---
+
+# {{TITLE}}
+
+## Problem
+
+**Symptoms:**
+- [What the developer sees / error message]
+- [Observable behavior that indicates the bug]
+
+**Root Cause:**
+[The actual underlying issue, not just symptoms]
+
+**Why It's Tricky:**
+[What makes this hard to debug — misleading errors, race conditions, etc.]
+
+## Detection
+
+How to confirm you're hitting this exact bug:
+
+```{{LANGUAGE}}
+// Diagnostic check — run this to confirm
+{{DIAGNOSTIC_CODE}}
+```
+
+Expected output when bug is present:
+```
+{{EXPECTED_BAD_OUTPUT}}
+```
+
+## Solution Pattern
+
+### Before (Broken)
+
+```{{LANGUAGE}}
+{{BEFORE_CODE}}
+```
+
+### After (Fixed)
+
+```{{LANGUAGE}}
+{{AFTER_CODE}}
+```
+
+### Why This Works
+
+[Explain the mechanism — not just "this fixes it" but WHY]
+
+## Elimination Checklist
+
+Before applying this fix, rule out these other causes:
+
+- [ ] [Alternative cause 1 — how to check]
+- [ ] [Alternative cause 2 — how to check]
+- [ ] [Alternative cause 3 — how to check]
+
+## Verification
+
+After applying the fix, verify with:
+
+```{{LANGUAGE}}
+{{VERIFICATION_CODE}}
+```
+
+Expected output:
+```
+{{EXPECTED_GOOD_OUTPUT}}
+```
+
+## When to Use
+
+- [Scenario 1]
+- [Scenario 2]
+
+## When NOT to Use
+
+- [Anti-pattern 1]
+- [Anti-pattern 2]
+
+## Related Skills
+
+- [related-skill] - [description]
+
+## References
+
+- Contributed from: {{PROJECT}}

package/templates/skill-devops-recipe.md

@@ -0,0 +1,107 @@
+---
+name: {{SKILL_NAME}}
+category: {{CATEGORY}}
+type: devops-recipe
+version: 1.0.0
+contributed: {{DATE}}
+contributor: {{PROJECT}}
+last_updated: {{DATE}}
+tags: [{{TAGS}}]
+difficulty: {{DIFFICULTY}}
+usage_count: 0
+success_rate: 100
+---
+
+# {{TITLE}}
+
+## Problem
+
+[What infrastructure/deployment/CI challenge does this solve?]
+
+## Prerequisites
+
+- [ ] [Tool/service 1] installed (version X+)
+- [ ] [Tool/service 2] configured
+- [ ] [Access/permissions] granted
+
+## Environment Variables
+
+```env
+# Required
+{{REQUIRED_ENV_VARS}}
+
+# Optional
+{{OPTIONAL_ENV_VARS}}
+```
+
+## Solution
+
+### Step 1: [Setup]
+
+```bash
+{{SETUP_COMMANDS}}
+```
+
+### Step 2: [Configuration]
+
+```yaml
+# config-file.yml
+{{CONFIG_FILE}}
+```
+
+### Step 3: [Deployment/Execution]
+
+```bash
+{{DEPLOY_COMMANDS}}
+```
+
+## Verification
+
+```bash
+# Verify the setup works
+{{VERIFICATION_COMMANDS}}
+```
+
+Expected output:
+```
+{{EXPECTED_OUTPUT}}
+```
+
+## Rollback Plan
+
+If something goes wrong:
+
+```bash
+{{ROLLBACK_COMMANDS}}
+```
+
+## Monitoring
+
+What to watch after applying:
+
+| Metric | Normal Range | Alert Threshold |
+|--------|-------------|----------------|
+| [Metric 1] | [Range] | [Threshold] |
+| [Metric 2] | [Range] | [Threshold] |
+
+## Common Failures
+
+1. **[Failure 1]** - Cause: [X] - Fix: [Y]
+2. **[Failure 2]** - Cause: [X] - Fix: [Y]
+
+## When to Use
+
+- [Scenario 1]
+- [Scenario 2]
+
+## When NOT to Use
+
+- [Anti-pattern 1]
+
+## Related Skills
+
+- [related-skill] - [description]
+
+## References
+
+- Contributed from: {{PROJECT}}

package/templates/skill-general.md

@@ -0,0 +1,65 @@
+---
+name: {{SKILL_NAME}}
+category: {{CATEGORY}}
+type: general
+version: 1.0.0
+contributed: {{DATE}}
+contributor: {{PROJECT}}
+last_updated: {{DATE}}
+tags: [{{TAGS}}]
+difficulty: {{DIFFICULTY}}
+usage_count: 0
+success_rate: 100
+---
+
+# {{TITLE}}
+
+## Problem
+
+[What problem does this skill solve?]
+[Be specific about symptoms, error messages, or scenarios]
+
+## Solution Pattern
+
+[The recommended approach]
+[Explain the "why" behind the solution]
+
+## Code Example
+
+```{{LANGUAGE}}
+// Before (problematic)
+{{BEFORE_CODE}}
+
+// After (solution)
+{{AFTER_CODE}}
+```
+
+## Implementation Steps
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+## When to Use
+
+- [Scenario 1 where this applies]
+- [Scenario 2 where this applies]
+- [Signs that this skill is needed]
+
+## When NOT to Use
+
+- [Anti-pattern 1 — when this would be wrong]
+- [Anti-pattern 2 — alternative situations]
+
+## Common Mistakes
+
+- [Mistake 1 to avoid]
+- [Mistake 2 to avoid]
+
+## Related Skills
+
+- [related-skill-1] - [brief description]
+
+## References
+
+- Contributed from: {{PROJECT}}

package/templates/skill-ui-component.md

@@ -0,0 +1,113 @@
+---
+name: {{SKILL_NAME}}
+category: {{CATEGORY}}
+type: ui-component
+version: 1.0.0
+contributed: {{DATE}}
+contributor: {{PROJECT}}
+last_updated: {{DATE}}
+tags: [{{TAGS}}]
+difficulty: {{DIFFICULTY}}
+usage_count: 0
+success_rate: 100
+---
+
+# {{TITLE}}
+
+## Problem
+
+[What UI/UX challenge does this component pattern solve?]
+
+**User Impact:**
+[How the user experience suffers without this pattern]
+
+## Visual Reference
+
+```
++----------------------------------+
+|  [ASCII wireframe of component]  |
+|                                  |
+|  [Show key interactive states]   |
++----------------------------------+
+```
+
+## Solution Pattern
+
+### Component Structure
+
+```{{LANGUAGE}}
+{{COMPONENT_CODE}}
+```
+
+### Styling
+
+```{{LANGUAGE}}
+{{STYLING_CODE}}
+```
+
+### State Management
+
+```{{LANGUAGE}}
+{{STATE_CODE}}
+```
+
+## Accessibility
+
+- [ ] Keyboard navigation: [Tab, Enter, Escape behavior]
+- [ ] Screen reader: [ARIA roles and labels]
+- [ ] Focus management: [Focus trap, return focus]
+- [ ] Color contrast: [WCAG AA minimum]
+- [ ] Reduced motion: [prefers-reduced-motion handling]
+
+```{{LANGUAGE}}
+// Accessibility implementation
+{{A11Y_CODE}}
+```
+
+## Responsive Behavior
+
+| Breakpoint | Behavior |
+|-----------|----------|
+| Mobile (<640px) | [Description] |
+| Tablet (640-1024px) | [Description] |
+| Desktop (>1024px) | [Description] |
+
+## Props / API
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `variant` | `string` | `'default'` | [Description] |
+| `size` | `string` | `'md'` | [Description] |
+| `onAction` | `function` | - | [Description] |
+
+## Usage Example
+
+```{{LANGUAGE}}
+// Basic usage
+{{BASIC_USAGE}}
+
+// Advanced usage with all props
+{{ADVANCED_USAGE}}
+```
+
+## Common Mistakes
+
+1. **[Mistake 1]** - [Correct approach]
+2. **[Mistake 2]** - [Correct approach]
+
+## When to Use
+
+- [Scenario 1]
+- [Scenario 2]
+
+## When NOT to Use
+
+- [Use alternative-component instead when...]
+
+## Related Skills
+
+- [related-skill] - [description]
+
+## References
+
+- Contributed from: {{PROJECT}}

package/version.json

@@ -1,7 +1,11 @@
 {
-  "version": "12.2.0",
+  "version": "13.0.0",
   "commit": "local",
   "branch": "main",
-  "updatedAt": "2026-03-06T00:00:00Z",
-  "installMethod": "local"
+  "updatedAt": "2026-03-12T22:00:00Z",
+  "installMethod": "local",
+  "changelog": {
+    "13.0.0": "17 research-backed changes across 3 waves: Societies of Thought plan critique, Spec-Driven verification, SE-Agent TDD + Implied Scenarios, FoldAgent cross-turn compression, Variation Injection, CNCF taxonomy, Frequency-Ranked Core Learnings, Background Agent Execution, Multi-Agent Reflexion, Adversarial Judge separation, Magentic-UI confidence escalation",
+    "12.6.0": "Unified /fire-skill CLI, 6 skill templates, import/validate/stats scripts"
+  }
 }

package/workflows/handoff-session.md

@@ -268,7 +268,7 @@ next_action: "{what to do next}"
 ### Important Paths
 - **Project Root:** {absolute path}
 - **Planning Docs:** {path}/.planning/
-- **Skills Library:** ~/.claude/plugins/fire-flow/skills-library/
+- **Skills Library:** ~/.claude/plugins/dominion-flow/skills-library/
 - **Handoffs:** ~/.claude/warrior-handoffs/
 
 ---
@@ -607,7 +607,7 @@ Before finalizing handoff, verify:
 ║                                                                              ║
 ║  No .planning/CONSCIENCE.md found.                                                ║
 ║                                                                              ║
-║  Action: Run `/fire-1-new` to initialize project first.                     ║
+║  Action: Run `/fire-1a-new` to initialize project first.                     ║
 ║                                                                              ║
 ╚══════════════════════════════════════════════════════════════════════════════╝
 ```

package/workflows/new-project.md

@@ -476,7 +476,7 @@ status: ready_to_plan
 
 **Purpose:** Ensure automatic context loading on session start.
 
-The Fire Flow plugin includes SessionStart hooks that:
+The Dominion Flow plugin includes SessionStart hooks that:
 1. Load CONSCIENCE.md context automatically
 2. Remind about WARRIOR handoffs
 3. Display last activity and next action
@@ -484,7 +484,7 @@ The Fire Flow plugin includes SessionStart hooks that:
 **Verify hook configuration:**
 ```bash
 # Check hooks.json exists in plugin
-ls ~/.claude/plugins/fire-flow/hooks/hooks.json
+ls ~/.claude/plugins/dominion-flow/hooks/hooks.json
 ```
 
 ---

package/workflows/plan-phase.md

@@ -36,7 +36,7 @@ Before executing this workflow, load:
 # Check required files exist
 if [ ! -f ".planning/CONSCIENCE.md" ]; then
   echo "ERROR: No .planning/CONSCIENCE.md found"
-  echo "Run /fire-1-new to initialize project first"
+  echo "Run /fire-1a-new to initialize project first"
   exit 1
 fi