@thierrynakoa/fire-flow 10.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,64 @@
+{
+  "name": "dominion-flow",
+  "version": "10.0.0",
+  "description": "Dominion Flow is a comprehensive orchestration platform that empowers your Claude agent. It gives Claude a complete, structured workflow for taking projects from idea to production — with parallel execution, 190+ reusable skills, session memory across handoffs, 70-point quality verification, autonomous mode, E2E testing, and a circuit breaker to prevent stuck loops. Includes 39 slash commands organized into 7 tiers covering planning, execution, verification, debugging, skills management, and milestone tracking.",
+  "author": {
+    "name": "Thierry",
+    "email": ""
+  },
+  "repository": "https://github.com/ThierryN/dominion-flow",
+  "license": "MIT",
+  "keywords": [
+    "workflow",
+    "dominion-flow",
+    "warrior",
+    "sdlc",
+    "skills-library",
+    "validation",
+    "handoff",
+    "project-management",
+    "automation",
+    "testing",
+    "git-flow",
+    "blocker-tracking",
+    "metrics",
+    "auto-skill-extraction",
+    "breath-execution",
+    "parallel-agents",
+    "uat-testing",
+    "codebase-mapping",
+    "circuit-breaker",
+    "error-classification",
+    "context-engineering",
+    "decision-time-guidance",
+    "approach-rotation",
+    "recitation-pattern",
+    "playwright-e2e",
+    "e2e-testing",
+    "visual-regression",
+    "plan-aware-debugging",
+    "decision-log",
+    "assumptions-registry",
+    "handoff-validator",
+    "task-recitation",
+    "cross-phase-validation",
+    "confidence-scoring",
+    "worktree-isolation",
+    "model-split",
+    "parallelizability-routing",
+    "context-compression",
+    "error-preservation",
+    "issue-to-pr",
+    "skills-validation",
+    "post-verification-routing"
+  ],
+  "commands": "./commands/",
+  "agents": "./agents/",
+  "hooks": "./hooks/hooks.json",
+  "capabilities": {
+    "commands": true,
+    "skills": true,
+    "hooks": true,
+    "agents": true
+  }
+}

package/ARCHITECTURE-DIAGRAM.md

@@ -0,0 +1,440 @@
+# Dominion Flow Architecture Diagrams
+
+Visual representations of the Dominion Flow system architecture.
+
+---
+
+## System Layer Architecture
+
+```
++=========================================================================+
+|                         DOMINION FLOW UNIFIED SYSTEM                       |
++=========================================================================+
+
++-------------------------------------------------------------------------+
+|                        Dominion Flow orchestration SHELL                          |
+|                                                                         |
+|   /fire-1-new  -->  /fire-2-plan  -->  /fire-3-execute              |
+|         |                  |                    |                       |
+|         v                  v                    v                       |
+|   [Project Init]    [Phase Planning]    [Breath Execution]               |
+|         |                  |                    |                       |
+|         v                  v                    v                       |
+|   /fire-4-verify  <--  /fire-5-handoff  <--  /fire-6-resume         |
+|         |                  |                    |                       |
+|   [Validation]      [Session Save]       [Context Load]                |
+|                                                                         |
++-------------------------------------------------------------------------+
+                                    |
+                                    | Integrates
+                                    v
++-------------------------------------------------------------------------+
+|                       WARRIOR CORE FOUNDATION                           |
+|                                                                         |
+|   +-------------------+  +-------------------+  +-------------------+   |
+|   |  SKILLS LIBRARY   |  | HONESTY PROTOCOLS |  |   VALIDATION      |   |
+|   |                   |  |                   |  |   FRAMEWORK       |   |
+|   | - 190+ patterns   |  | - No false claims |  | - 70-point check  |   |
+|   | - 15 categories   |  | - Admit unknowns  |  | - Must-haves      |   |
+|   | - Versioned       |  | - Evidence-based  |  | - Goal-backward   |   |
+|   | - Searchable      |  | - Flag assumptions|  | - Auto-verify     |   |
+|   +-------------------+  +-------------------+  +-------------------+   |
+|                                                                         |
++-------------------------------------------------------------------------+
+                                    |
+                                    | Stores/Reads
+                                    v
++-------------------------------------------------------------------------+
+|                     SHARED STATE & CONTEXT LAYER                        |
+|                                                                         |
+|   .planning/                                                            |
+|   +------------------------------------------------------------------+ |
+|   | CONSCIENCE.md          | Living project memory, current status         | |
+|   +------------------------------------------------------------------+ |
+|   | VISION.md        | Phase overview, milestones, timeline          | |
+|   +------------------------------------------------------------------+ |
+|   | phases/           | Detailed plans, summaries, breath trackers      | |
+|   |   01-phase/       |                                               | |
+|   |     BLUEPRINT.md       |                                               | |
+|   |     RECORD.md    |                                               | |
+|   +------------------------------------------------------------------+ |
+|   | POWER-HANDOFF-*.md| Session continuity, context preservation      | |
+|   +------------------------------------------------------------------+ |
+|                                                                         |
++-------------------------------------------------------------------------+
+```
+
+---
+
+## Data Flow: Planning Phase
+
+```
+                              /fire-2-plan N
+                                    |
+                                    v
+                    +-------------------------------+
+                    |     Read Current Context      |
+                    |  - CONSCIENCE.md (project state)   |
+                    |  - VISION.md (phase info)    |
+                    +-------------------------------+
+                                    |
+                                    v
+                    +-------------------------------+
+                    |   Search Skills Library       |
+                    |  - Match phase requirements   |
+                    |  - Find relevant patterns     |
+                    |  - Suggest integrations       |
+                    +-------------------------------+
+                                    |
+                                    v
+                    +-------------------------------+
+                    |   Invoke fire-planner Agent  |
+                    |  - Analyze requirements       |
+                    |  - Apply honesty protocols    |
+                    |  - Estimate complexity        |
+                    +-------------------------------+
+                                    |
+                                    v
+                    +-------------------------------+
+                    |      Generate BLUEPRINT.md         |
+                    |  - Tasks with dependencies    |
+                    |  - Must-haves list            |
+                    |  - Breath groupings             |
+                    |  - Skills references          |
+                    +-------------------------------+
+                                    |
+                                    v
+                    +-------------------------------+
+                    |      Update CONSCIENCE.md          |
+                    |  - Phase status: planned      |
+                    |  - Planning timestamp         |
+                    +-------------------------------+
+```
+
+---
+
+## Data Flow: Execution Phase
+
+```
+                             /fire-3-execute N
+                                    |
+                                    v
+                    +-------------------------------+
+                    |      Load Phase Plan          |
+                    |  - BLUEPRINT.md tasks              |
+                    |  - Breath definitions           |
+                    |  - Dependencies               |
+                    +-------------------------------+
+                                    |
+                                    v
+               +--------------------------------------------+
+               |          BREATH-BASED EXECUTION              |
+               |                                            |
+               |   Breath 1 (Parallel)                        |
+               |   +--------+  +--------+  +--------+       |
+               |   | Task A |  | Task B |  | Task C |       |
+               |   +--------+  +--------+  +--------+       |
+               |        |          |           |            |
+               |        +-----+----+-----+-----+            |
+               |              v                             |
+               |   Breath 2 (Depends on Breath 1)               |
+               |   +--------+  +--------+                   |
+               |   | Task D |  | Task E |                   |
+               |   +--------+  +--------+                   |
+               |              |                             |
+               +--------------------------------------------+
+                              |
+                              v
+                    +-------------------------------+
+                    |  Invoke fire-executor Agent  |
+                    |  - Execute tasks              |
+                    |  - Apply honesty protocols    |
+                    |  - Track progress             |
+                    +-------------------------------+
+                              |
+                              v
+                    +-------------------------------+
+                    |   Real-time CONSCIENCE.md Update   |
+                    |  - Task completion status     |
+                    |  - Blockers encountered       |
+                    |  - Skills applied             |
+                    +-------------------------------+
+```
+
+---
+
+## Data Flow: Verification Phase
+
+```
+                             /fire-4-verify N
+                                    |
+                                    v
+                    +-------------------------------+
+                    |    Load Phase Deliverables    |
+                    |  - BLUEPRINT.md must-haves         |
+                    |  - Expected outcomes          |
+                    +-------------------------------+
+                                    |
+                                    v
+                    +-------------------------------+
+                    |  Invoke fire-verifier Agent  |
+                    |  - Check each must-have       |
+                    |  - Run 70-point checklist     |
+                    |  - Apply honesty protocols    |
+                    +-------------------------------+
+                                    |
+                                    v
+        +--------------------------------------------------+
+        |              VALIDATION CHECKS                    |
+        |                                                   |
+        |   Must-Haves              60-Point Checklist      |
+        |   +----------------+      +-------------------+   |
+        |   | [x] Feature A  |      | [x] No hardcoded  |   |
+        |   | [x] Feature B  |      |     credentials   |   |
+        |   | [ ] Feature C  |      | [x] Error handling|   |
+        |   +----------------+      | [!] Rate limiting |   |
+        |                           +-------------------+   |
+        +--------------------------------------------------+
+                                    |
+                                    v
+                    +-------------------------------+
+                    |    Generate Verification      |
+                    |         Report                |
+                    |  - PASS / PARTIAL / FAIL      |
+                    |  - Issues found               |
+                    |  - Recommendations            |
+                    +-------------------------------+
+                                    |
+                                    v
+                    +-------------------------------+
+                    |      Update CONSCIENCE.md          |
+                    |  - Phase status: complete     |
+                    |  - Verification results       |
+                    |  - Notes for next phase       |
+                    +-------------------------------+
+```
+
+---
+
+## Component Relationship Diagram
+
+```
++------------------+          +------------------+
+|    COMMANDS      |          |     AGENTS       |
++------------------+          +------------------+
+| fire-1-new       |--------->| fire-planner    |
+| fire-2-plan      |--------->| fire-executor   |
+| fire-3-execute   |--------->| fire-verifier   |
+| fire-4-verify    |--------->| fire-researcher |
+| fire-5-handoff   |          +------------------+
+| fire-6-resume    |                   |
+| fire-search      |                   | Uses
+| fire-contribute  |                   v
+| fire-skills-*    |          +------------------+
+| fire-dashboard   |          |    REFERENCES    |
+| fire-analytics   |          +------------------+
+| fire-discover    |          | honesty-protocols|
+| power-test       |          | validation-check |
++------------------+          | skills-usage     |
+        |                     | ui-brand         |
+        | Creates/Updates     +------------------+
+        v                              |
++------------------+                   | Guides
+|    TEMPLATES     |                   v
++------------------+          +------------------+
+| state.md         |<---------|  SKILLS LIBRARY  |
+| roadmap.md       |          +------------------+
+| plan.md          |          | advanced-features|
+| fire-handoff.md |          | api-patterns     |
+| verification.md  |          | automation       |
+| skills-index.md  |          | complexity-metrics|
++------------------+          | database-solutions|
+        |                     | deployment-security|
+        | Populates           | document-processing|
+        v                     | ecommerce        |
++------------------+          | form-solutions   |
+|  .planning/      |          | integrations     |
+|  (Project Dir)   |          | lms-patterns     |
++------------------+          | methodology      |
+| CONSCIENCE.md         |          | patterns-standards|
+| VISION.md       |          | theology         |
+| phases/          |          | video-media      |
+| POWER-HANDOFF-*  |          +------------------+
++------------------+
+```
+
+---
+
+## File Relationship Diagram
+
+```
+.planning/
+    |
+    +-- CONSCIENCE.md  <-----------------+
+    |      ^                        |
+    |      | Updates                | Reads
+    |      |                        |
+    +-- VISION.md                  |
+    |      ^                        |
+    |      | References             |
+    |      |                        |
+    +-- phases/                     |
+    |      |                        |
+    |      +-- 01-phase-name/       |
+    |      |      |                 |
+    |      |      +-- BLUEPRINT.md ------+
+    |      |      |      ^
+    |      |      |      | Created by /fire-2-plan
+    |      |      |      | Executed by /fire-3-execute
+    |      |      |      | Verified by /fire-4-verify
+    |      |      |
+    |      |      +-- RECORD.md
+    |      |      |      ^
+    |      |      |      | Created after verification
+    |      |      |
+    |      |      +-- BREATH-TRACKER.md
+    |      |             ^
+    |      |             | Updated during execution
+    |      |
+    |      +-- 02-phase-name/
+    |             |
+    |             +-- BLUEPRINT.md
+    |             +-- ...
+    |
+    +-- POWER-HANDOFF-2025-01-22.md
+           ^
+           | Created by /fire-5-handoff
+           | Read by /fire-6-resume
+```
+
+---
+
+## Session Continuity Flow
+
+```
+SESSION 1                          SESSION 2
+=========                          =========
+
+Work on project                    /fire-6-resume
+     |                                   |
+     v                                   v
+Update CONSCIENCE.md                    Read latest handoff
+     |                                   |
+     v                                   v
+/fire-5-handoff                   Restore CONSCIENCE.md context
+     |                                   |
+     v                                   v
+Create POWER-HANDOFF-*.md          Display session summary
+     |                                   |
+     |                                   v
+     |                             Continue work
+     |                                   |
+     +------- (Session boundary) --------+
+
+Handoff Contents:
++--------------------------------+
+| Project: My App                |
+| Phase: 2 (40% complete)        |
+| In Progress:                   |
+|   - Dashboard component        |
+|   - API endpoint               |
+| Blockers:                      |
+|   - State mgmt decision        |
+| Skills Used:                   |
+|   - oauth-patterns.md          |
+| Next Steps:                    |
+|   - Complete dashboard         |
+|   - Decide Redux vs Context    |
++--------------------------------+
+```
+
+---
+
+## Agent Interaction Model
+
+```
++-------------------------------------------------------------------+
+|                         USER REQUEST                               |
++-------------------------------------------------------------------+
+                              |
+                              v
++-------------------------------------------------------------------+
+|                      COMMAND ROUTER                                |
+|   Matches request to appropriate power-* command                   |
++-------------------------------------------------------------------+
+                              |
+          +-------------------+-------------------+
+          |                   |                   |
+          v                   v                   v
++------------------+  +------------------+  +------------------+
+| fire-planner    |  | fire-executor   |  | fire-verifier   |
+| Agent            |  | Agent            |  | Agent            |
++------------------+  +------------------+  +------------------+
+| - Skills search  |  | - Task execution |  | - Must-haves     |
+| - Complexity est |  | - Breath parallel  |  | - 70-point check |
+| - Plan generation|  | - Progress track |  | - Report gen     |
+| - Honesty: flag  |  | - Honesty: no    |  | - Honesty: prove |
+|   assumptions    |  |   false complete |  |   with evidence  |
++------------------+  +------------------+  +------------------+
+          |                   |                   |
+          +-------------------+-------------------+
+                              |
+                              v
++-------------------------------------------------------------------+
+|                    fire-researcher Agent                          |
+|   - Cross-reference skills                                         |
+|   - Find related patterns                                          |
+|   - Suggest improvements                                           |
+|   - Discover new skills                                            |
++-------------------------------------------------------------------+
+```
+
+---
+
+## Skills Library Architecture
+
+```
+skills-library/
+    |
+    +-- .git/                    # Version control
+    |
+    +-- AVAILABLE_TOOLS_REFERENCE.md   # Master index
+    |
+    +-- advanced-features/       # Category
+    |       |
+    |       +-- GAMIFICATION_SYSTEM.md
+    |       +-- PLUGIN_SYSTEM_ARCHITECTURE.md
+    |       +-- SEO_SETTINGS_MANAGEMENT.md
+    |       +-- ...
+    |
+    +-- database-solutions/      # Category
+    |       |
+    |       +-- RLS_SECURITY_GUIDE.md
+    |       +-- SCHEMA_MIGRATION_GUIDE.md
+    |       +-- POSTGRESQL_LICENSE_TABLE_DESIGN.md
+    |       +-- ...
+    |
+    +-- deployment-security/     # Category
+    |       |
+    |       +-- VPS_DEPLOYMENT_READINESS.md
+    |       +-- CPANEL_NODE_DEPLOYMENT.md
+    |       +-- LICENSE_KEY_SYSTEM.md
+    |       +-- ...
+    |
+    +-- [12 more categories...]
+    |
+    +-- methodology/             # Meta category
+            |
+            +-- complexity-divider.md
+            +-- work-with-complexity.md
+            +-- ...
+
+Total: 190+ skills across 15 categories
+Versioned: Git history for rollback
+Searchable: /fire-search command
+Contributable: /fire-contribute command
+```
+
+---
+
+*Architecture clarity powers effective development.*

package/COMMAND-REFERENCE.md

@@ -0,0 +1,172 @@
+# Dominion Flow Command Reference
+
+Complete reference for all 39 Dominion Flow commands.
+
+---
+
+## Command Tiers
+
+Commands are organized into 7 tiers by function. Every command is a `/fire-*` slash command.
+
+---
+
+### Tier 1 -- Core Workflow (the essential 6+1)
+
+The numbered pipeline that takes a project from idea to done.
+
+| Command | Description |
+|---------|-------------|
+| `/fire-1-new` | Initialize a new project with Dominion Flow structure |
+| `/fire-1a-discuss` | Gather implementation context through adaptive questioning before planning |
+| `/fire-2-plan` | Plan a phase with skills library access and WARRIOR validation |
+| `/fire-3-execute` | Execute a phase with breath-based parallelism and honesty protocols |
+| `/fire-4-verify` | Verify phase completion with must-haves and 70-point validation |
+| `/fire-5-handoff` | Create comprehensive session handoff for next AI agent |
+| `/fire-6-resume` | Resume from previous session handoff with full context restoration |
+
+---
+
+### Tier 2 -- Autonomous & Loop
+
+Self-iterating and fully autonomous execution modes.
+
+| Command | Description |
+|---------|-------------|
+| `/fire-autonomous` | Full autopilot -- plan, execute, verify all phases autonomously after PRD is complete |
+| `/fire-loop` | Start self-iterating loop until completion with circuit breaker, error classification, context engineering, and skills integration |
+| `/fire-loop-resume` | Resume a Power Loop from Sabbath Rest or stopped state |
+| `/fire-loop-stop` | Cancel the active Power Loop and save progress |
+
+---
+
+### Tier 3 -- Debugging & Discovery
+
+Investigation, research, and exploration tools.
+
+| Command | Description |
+|---------|-------------|
+| `/fire-debug` | Systematic debugging with persistent state, skills library integration, and WARRIOR validation |
+| `/fire-discover` | AI-powered pattern discovery and skill suggestions |
+| `/fire-map-codebase` | Analyze codebase with parallel mapper agents to produce structured documentation |
+| `/fire-0-orient` | Orient on an existing project -- understand what's here and what's next |
+| `/fire-research` | Research how to implement a phase with 3-level discovery before planning |
+| `/fire-brainstorm` | Dedicated ideation and exploration before implementation |
+
+---
+
+### Tier 4 -- Verification & Security
+
+Quality assurance, testing, and security scanning.
+
+| Command | Description |
+|---------|-------------|
+| `/fire-7-review` | Multi-perspective code review with 14 specialized reviewer personas |
+| `/fire-verify-uat` | Conversational User Acceptance Testing with automatic parallel diagnosis on failures |
+| `/fire-test` | Run Dominion Flow plugin integration tests to verify all commands and integrations work correctly |
+| `/fire-security-scan` | Inspect skills, plugins, MCP tools, and code for prompt injection, PII harvesting, credential theft, and supply chain attacks |
+| `/fire-vuln-scan` | AI-powered application vulnerability scanner using OWASP Top 10 -- find what regex-based tools miss |
+| `/fire-double-check` | Deep validation before claiming work is complete |
+
+---
+
+### Tier 5 -- Skills Management
+
+Skills library operations: search, add, sync, version control.
+
+| Command | Description |
+|---------|-------------|
+| `/fire-search` | Search the skills library for patterns, solutions, and best practices |
+| `/fire-add-new-skill` | Add a new skill to the skills library when you solve a hard problem |
+| `/fire-skills-sync` | Synchronize skills between project library and global library |
+| `/fire-skills-history` | View version history for a skill in the skills library |
+| `/fire-skills-rollback` | Rollback a skill to a previous version |
+| `/fire-skills-diff` | Compare different versions of a skill |
+
+---
+
+### Tier 6 -- Analytics & Project Management
+
+Dashboards, tracking, reflection, and phase transitions.
+
+| Command | Description |
+|---------|-------------|
+| `/fire-dashboard` | Display visual project dashboard with status and progress |
+| `/fire-analytics` | View skills usage analytics and effectiveness metrics |
+| `/fire-todos` | Capture, list, and manage todos during work sessions |
+| `/fire-reflect` | Capture, search, and review failure reflections for cross-session learning |
+| `/fire-assumptions` | List and validate assumptions for a phase before planning or execution |
+| `/fire-transition` | Complete phase transition with metrics collection, bottleneck detection, auto-skill extraction, and trend analysis |
+
+---
+
+### Tier 7 -- Milestone & Advanced
+
+Milestone lifecycle management and advanced operations.
+
+| Command | Description |
+|---------|-------------|
+| `/fire-new-milestone` | Start a new milestone cycle with questioning, research, requirements, and roadmap |
+| `/fire-complete-milestone` | Archive completed milestone and prepare for next version with WARRIOR validation |
+| `/fire-execute-plan` | Execute a single plan with segment-based routing, per-task atomic commits, and test enforcement |
+| `/fire-update` | Check for and apply plugin updates from GitHub repository |
+
+---
+
+## Agent Reference
+
+Agents are specialized sub-agents spawned by commands to perform focused work.
+
+| Agent | Description | Spawned By |
+|-------|-------------|------------|
+| `fire-executor` | Executes plans with honesty protocols and creates unified handoff documents | `/fire-3-execute`, `/fire-execute-plan`, `/fire-autonomous` |
+| `fire-planner` | Creates phase plans with skills library integration and WARRIOR validation | `/fire-2-plan`, `/fire-autonomous` |
+| `fire-researcher` | Researches phase context using skills library and pattern matching | `/fire-research`, `/fire-1-new`, `/fire-2-plan` |
+| `fire-verifier` | Combines must-haves verification with WARRIOR 70-point validation | `/fire-4-verify`, `/fire-3-execute` |
+| `fire-reviewer` | Independent code reviewer -- architecture, patterns, performance, maintainability | `/fire-7-review`, `/fire-3-execute` (parallel with verifier) |
+
+---
+
+## Template Reference
+
+| Template | Purpose | Created By |
+|----------|---------|------------|
+| `state.md` | Living project memory tracking | `/fire-1-new` |
+| `roadmap.md` | Phase overview and milestones | `/fire-1-new` |
+| `plan.md` | Detailed phase execution plan | `/fire-2-plan` |
+| `fire-handoff.md` | Session continuity handoff | `/fire-5-handoff` |
+| `verification.md` | Verification report format | `/fire-4-verify` |
+| `skills-index.md` | Skills library index | `/fire-skills-sync` |
+
+---
+
+## Common Flags Reference
+
+| Flag | Used With | Purpose |
+|------|-----------|---------|
+| `--auto-continue` | execute | Uninterrupted breath execution (Double-Shot Latte) |
+| `--autonomous` | execute, loop | Auto-route gate verdicts without human checkpoints |
+| `--breath N` | execute | Execute only a specific breath |
+| `--continue` | execute, loop-resume | Resume from last checkpoint |
+| `--skip-review` | execute | Skip parallel code review (not recommended) |
+| `--skip-verify` | execute | Skip verification (not recommended) |
+| `--max-iterations N` | loop | Safety limit for loop iterations |
+| `--aggressive` | loop | Tighter circuit breaker thresholds |
+| `--no-circuit-breaker` | loop | Disable circuit breaker (not recommended) |
+| `--discover` | loop | Run pattern discovery before starting |
+| `--dry-run` | skills-sync | Preview changes without applying |
+| `--push` | skills-sync | Push project skills to global |
+| `--pull` | skills-sync | Pull global skills to project |
+| `--both` | skills-sync | Bidirectional sync |
+| `--compact` | dashboard | Minimal output |
+| `--watch` | dashboard | Auto-refresh display |
+| `--json` | dashboard | JSON output format |
+| `--category` | analytics | Group by category |
+| `--time-saved` | analytics | Show time estimates |
+| `--gaps` | analytics | Show skill gaps |
+| `--e2e` | test | Full end-to-end tests |
+| `--integration` | test | Integration tests only |
+| `--command` | test | Test specific command |
+
+---
+
+*Dominion Flow v9.0 -- 39 commands, 5 agents, 190+ skills.*