@thierrynakoa/fire-flow 10.0.0

package/templates/brainstorm.md

@@ -0,0 +1,185 @@
+# Brainstorm: {Topic}
+
+**Date:** {timestamp}
+**Status:** IN_PROGRESS | COMPLETE
+**Facilitator:** Dominion Flow
+
+---
+
+## Problem Statement
+
+{Single paragraph describing what we're trying to solve}
+
+---
+
+## Clarifying Questions & Answers
+
+| Question | Answer |
+|----------|--------|
+| What is the primary use case? | {answer} |
+| What systems does this interact with? | {answer} |
+| What are the non-negotiables? | {answer} |
+| What does success look like? | {answer} |
+
+---
+
+## Problem Decomposition
+
+### Core Challenge
+{One sentence}
+
+### Sub-Problems
+1. **{Sub-problem 1}**
+   - Why it matters:
+   - Complexity: Low | Medium | High
+
+2. **{Sub-problem 2}**
+   - Why it matters:
+   - Complexity: Low | Medium | High
+
+3. **{Sub-problem 3}**
+   - Why it matters:
+   - Complexity: Low | Medium | High
+
+### Dependencies
+- {dependency relationships}
+
+### Risk Areas
+- {highest uncertainty}
+- {most likely to change}
+
+---
+
+## Alternative Approaches
+
+### Approach A: {Name}
+
+**Summary:** {One-line}
+
+**How it works:**
+{2-3 sentences}
+
+**Pros:**
+-
+-
+-
+
+**Cons:**
+-
+-
+
+**Best when:** {scenario}
+
+**Complexity:** Low | Medium | High
+
+**Skills Match:** @skills-library/{path}
+
+---
+
+### Approach B: {Name}
+
+**Summary:** {One-line}
+
+**How it works:**
+{2-3 sentences}
+
+**Pros:**
+-
+-
+-
+
+**Cons:**
+-
+-
+
+**Best when:** {scenario}
+
+**Complexity:** Low | Medium | High
+
+**Skills Match:** @skills-library/{path}
+
+---
+
+### Approach C: {Name}
+
+**Summary:** {One-line}
+
+**How it works:**
+{2-3 sentences}
+
+**Pros:**
+-
+-
+-
+
+**Cons:**
+-
+-
+
+**Best when:** {scenario}
+
+**Complexity:** Low | Medium | High
+
+**Skills Match:** @skills-library/{path}
+
+---
+
+## Trade-off Analysis
+
+| Criteria | Weight | A | B | C |
+|----------|--------|---|---|---|
+| Simplicity | 3 | | | |
+| Performance | 2 | | | |
+| Maintainability | 3 | | | |
+| Time to Implement | 2 | | | |
+| Scalability | 2 | | | |
+| **Weighted Total** | | | | |
+
+---
+
+## Recommendation
+
+### Recommended: Approach {X}
+
+**Why:**
+{2-3 sentences}
+
+**Key factors:**
+1.
+2.
+3.
+
+### Implementation Sketch
+
+```
+{High-level diagram or flow}
+```
+
+### First Steps
+1.
+2.
+3.
+
+### Open Questions
+-
+-
+
+---
+
+## Decision Record
+
+| Decision | Rationale | Alternatives |
+|----------|-----------|--------------|
+| {decision} | {why} | {what else considered} |
+
+---
+
+## Next Steps
+
+- [ ] Review with stakeholders
+- [ ] Create plan: `/fire-2-plan`
+- [ ] Begin implementation
+
+---
+
+*Brainstorm facilitated by Dominion Flow*

package/templates/conscience.md

@@ -0,0 +1,92 @@
+# Project State
+
+## Project Reference
+- **Project:** {project_name}
+- **Core value:** {core_value}
+- **Current focus:** Phase {current_phase} - {phase_name}
+- **Milestone:** v{milestone_version} [{milestone_status}]
+
+## Current Position
+- **Phase:** {current_phase} of {total_phases}
+- **Breath:** {current_wave}
+- **Status:** {status}
+- **Last activity:** {last_activity_date} - {last_activity_description}
+- **Progress:** [{progress_bar}] {progress_percent}%
+
+## Dominion Flow Progress Tracking
+### Phase Status
+| Phase | Name | Status | Plans | Completed |
+|-------|------|--------|-------|-----------|
+{phase_status_rows}
+
+### Recent Completions
+{recent_completions}
+
+## WARRIOR Integration
+- **Skills Applied:** {total_skills_applied} total
+{skills_applied_list}
+
+- **Honesty Checkpoints:** {honesty_checkpoint_count} (agents admitted gaps, researched, proceeded)
+- **Validation Status:** Phase {last_validated_phase} passed {validation_score}/70 checks
+
+## Performance Metrics
+### Time Tracking
+- **Session start:** {session_start}
+- **Total time this phase:** {phase_time}
+- **Average plan duration:** {avg_plan_duration}
+
+### Quality Metrics
+- **Test coverage:** {test_coverage}%
+- **Lint errors:** {lint_errors}
+- **Build status:** {build_status}
+
+## Accumulated Context
+
+### Skills Library Usage
+- **Most used:** {most_used_skill_category} ({most_used_count} applications)
+- **Recent:** {recent_skill} (Phase {recent_skill_phase})
+- **Categories applied:** {categories_applied}
+
+### Decisions
+> Full decision log: `.planning/DECISION_LOG.md` (v3.2 enhancement)
+> Quick reference of recent decisions below; see log for full rationale and options considered.
+
+| Date | Decision | Rationale | Phase |
+|------|----------|-----------|-------|
+{decisions_rows}
+
+### Assumptions Health
+> Full registry: `.planning/ASSUMPTIONS.md`
+
+| Status | Count |
+|--------|-------|
+| Validated | {validated_count} |
+| Unvalidated | {unvalidated_count} |
+| Invalidated | {invalidated_count} |
+
+### Blockers & Issues
+{blockers_list}
+
+## Session Continuity
+- **Last session:** {last_session_timestamp}
+- **Stopped at:** {stopped_at_description}
+- **Resume file:** .planning/WARRIOR-HANDOFF.md
+- **Next:** {next_action}
+
+## Quick Resume Commands
+```bash
+# Check current status
+/fire-dashboard
+
+# Resume work
+/fire-6-resume
+
+# Continue execution
+/fire-3-execute {current_phase}
+
+# View skills applied
+/fire-analytics --project
+```
+
+---
+*Last updated: {last_updated}*

package/templates/fire-handoff.md

@@ -0,0 +1,159 @@
+---
+# Dominion Flow Frontmatter (machine-readable)
+project: {project_name}
+phase: {phase_number}-{phase_name}
+plan: {plan_number}
+subsystem: {subsystem}
+duration: "{duration_minutes} min"
+start_time: "{start_time_iso}"
+end_time: "{end_time_iso}"
+
+# Skills & Quality (WARRIOR integration)
+skills_applied:
+{skills_applied_yaml}
+honesty_checkpoints:
+{honesty_checkpoints_yaml}
+validation_score: {validation_passed}/{validation_total}
+
+# Dominion Flow Execution Metadata
+requires: [{requires}]
+provides: [{provides}]
+affects: [{affects}]
+tech_stack_added: [{tech_stack_added}]
+patterns_established: [{patterns_established}]
+key_files:
+  created:
+{files_created_yaml}
+  modified:
+{files_modified_yaml}
+key_decisions:
+{key_decisions_yaml}
+---
+
+# Power Handoff: Plan {phase_number}-{plan_number}
+
+## Quick Summary
+{quick_summary}
+
+---
+
+## Dominion Flow Accomplishments
+
+### Task Commits
+| Task | Description | Commit | Status |
+|------|-------------|--------|--------|
+{task_commits_rows}
+
+### Files Created/Modified
+**Created ({files_created_count} files):**
+{files_created_list}
+
+**Modified ({files_modified_count} files):**
+{files_modified_list}
+
+### Decisions Made
+{decisions_made_list}
+
+---
+
+## Skills Applied (WARRIOR)
+
+{skills_applied_details}
+
+---
+
+## WARRIOR 7-Step Handoff
+
+### W - Work Completed
+{work_completed}
+
+### A - Assessment
+{assessment}
+
+### R - Resources
+**Environment Variables Required:**
+```bash
+{env_vars}
+```
+
+**Database Tables:**
+{database_tables}
+
+**External Services:**
+{external_services}
+
+**Credentials/Access:**
+{credentials_access}
+
+### R - Readiness
+**Ready For:**
+{ready_for}
+
+**Blocked On:** {blocked_on}
+
+**Next Steps:**
+{next_steps}
+
+### I - Issues
+**Current Issues:**
+{current_issues}
+
+**Known Limitations (Deferred):**
+{known_limitations}
+
+### O - Outlook
+**Next Session Should:**
+{next_session_should}
+
+**After This Phase:**
+{after_this_phase}
+
+### R - References
+**Skills Used:**
+{skills_used_list}
+
+**Commits:**
+{commits_list}
+
+**Related Work:**
+{related_work}
+
+**External Resources:**
+{external_resources}
+
+---
+
+## Metrics
+
+| Metric | Value |
+|--------|-------|
+| Execution Time | {duration_minutes} min |
+| Files Created | {files_created_count} |
+| Files Modified | {files_modified_count} |
+| Tests Added | {tests_added_count} |
+| Test Coverage | {test_coverage}% |
+| Validation Score | {validation_passed}/{validation_total} |
+| Skills Applied | {skills_count} |
+
+---
+
+## Resume Instructions
+
+To continue this work in a new session:
+
+```bash
+# 1. Read this handoff (auto-injected by SessionStart hook)
+# 2. Check current state
+/fire-dashboard
+
+# 3. Resume work
+/fire-6-resume
+
+# 4. Or continue specific phase
+/fire-3-execute {next_phase}
+```
+
+---
+
+*Handoff created: {handoff_timestamp}*
+*Session ID: {session_id}*

package/templates/metrics.md

@@ -0,0 +1,67 @@
+# Metrics Template
+
+> **Origin:** NEW for Dominion Flow v2.0 - Metrics collection for trend analysis.
+
+Template for metrics frontmatter in RECORD.md files and aggregation in CONSCIENCE.md.
+
+---
+
+## Per-Plan Metrics (in RECORD.md frontmatter)
+
+```yaml
+metrics:
+  duration_minutes: 12
+  tasks_completed: 4
+  tasks_blocked: 0
+  files_created: 3
+  files_modified: 5
+  lines_added: 245
+  lines_removed: 30
+  tests_added: 6
+  test_coverage_delta: "+3%"
+  skills_applied: 2
+  honesty_checkpoints: 1
+  commits: 4
+  blocker_count: 0
+```
+
+---
+
+## Per-Phase Metrics (in CONSCIENCE.md)
+
+```markdown
+## Phase Metrics
+| Phase | Plans | Duration | Avg/Plan | Trend | Bottleneck |
+|-------|-------|----------|----------|-------|------------|
+| 01    | 3     | 30m      | 10m      | -     | None       |
+| 02    | 4     | 45m      | 11m      | +10%  | None       |
+| 03    | 6     | 72m      | 12m      | +9%   | Plan 05    |
+```
+
+---
+
+## Trend Dashboard (in CONSCIENCE.md)
+
+```markdown
+## Trends (Last 5 Phases)
+| Metric | P1 | P2 | P3 | P4 | P5 | Trend |
+|--------|----|----|----|----|-----|-------|
+| Avg Duration | 10m | 11m | 12m | 10m | 11m | Stable |
+| Pass Rate | 100% | 100% | 100% | 100% | 100% | Stable |
+| Skill Reuse | 20% | 25% | 30% | 35% | 40% | Improving |
+| Blocker Rate | 10% | 5% | 0% | 0% | 0% | Improving |
+
+Trajectory: POSITIVE
+```
+
+---
+
+## Bottleneck Flags
+
+| Flag | Trigger | Suggestion |
+|------|---------|------------|
+| SLOW | Duration > 2x average | Break into smaller plans |
+| BLOCKED | >20% tasks blocked | Review dependencies |
+| QUALITY | Failed verification | Better must-haves |
+| CRITICAL_PATH | Blocks 2+ plans | Prioritize this plan |
+| COMPLEXITY | Lines > 3x average | Split into sub-plans |

package/templates/phase-prompt.md

@@ -0,0 +1,142 @@
+# Phase Prompt Template (Dominion Flow Enhanced)
+
+> **Origin:** Ported from Dominion Flow `phase-prompt.md` with SDLC quality gates.
+
+Template for `.planning/phases/XX-name/{phase}-{plan}-BLUEPRINT.md`
+
+---
+
+## File Template
+
+```markdown
+---
+phase: XX-name
+plan: NN
+type: execute|tdd
+breath: N
+depends_on: []
+files_modified: []
+autonomous: true|false
+user_setup: []
+must_haves:
+  truths: []
+  artifacts: []
+  key_links: []
+skills_to_apply: []
+assumptions: []
+risk_level: low|medium|high
+warrior_validation:
+  code_quality: true
+  security: false
+  performance: false
+  testing: true
+---
+
+<objective>
+[What this plan accomplishes]
+Purpose: [Why this matters]
+Output: [What artifacts will be created]
+</objective>
+
+<execution_context>
+@~/.claude/plugins/dominion-flow/templates/summary.md
+</execution_context>
+
+<honesty_precheck>
+**What I know:**
+- [Facts confirmed about this domain/technology]
+
+**What I'm uncertain about:**
+- [Areas where research or skills lookup may be needed]
+
+**Skills to reference:**
+- [Relevant skills-library entries]
+
+**Assumptions being made:**
+- [VALIDATED: confirmed fact]
+- [UNVALIDATED: assumption to verify]
+</honesty_precheck>
+
+<context>
+@.planning/PROJECT.md
+@.planning/VISION.md
+@.planning/CONSCIENCE.md
+@.planning/BLOCKERS.md
+[Relevant source files]
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: [Action-oriented name]</name>
+  <files>path/to/file.ext</files>
+  <skills>[skill-library reference if applicable]</skills>
+  <action>[Specific implementation]</action>
+  <verify>[Command or check]</verify>
+  <done>[Acceptance criteria]</done>
+</task>
+
+<task type="checkpoint:human-verify" gate="blocking">
+  <what-built>[What needs verification]</what-built>
+  <how-to-verify>[Exact steps]</how-to-verify>
+  <resume-signal>Type "approved" or describe issues</resume-signal>
+</task>
+
+</tasks>
+
+<verification>
+### Test Requirements
+- [ ] [Test command]
+- [ ] Build passes
+- [ ] No new warnings
+
+### WARRIOR Quality Gates
+- [ ] Code builds without errors
+- [ ] Tests pass (existing + new)
+- [ ] No regressions
+</verification>
+
+<success_criteria>
+- All tasks completed
+- All verification checks pass
+- WARRIOR validation gates passed
+</success_criteria>
+```
+
+---
+
+## Frontmatter Fields
+
+| Field | Required | Purpose |
+|-------|----------|---------|
+| `phase` | Yes | Phase identifier |
+| `plan` | Yes | Plan number within phase |
+| `type` | Yes | `execute` or `tdd` |
+| `breath` | Yes | Execution breath (pre-computed) |
+| `depends_on` | Yes | Plan IDs this requires |
+| `files_modified` | Yes | Files this plan touches |
+| `autonomous` | Yes | `true` if no checkpoints |
+| `must_haves` | Yes | Goal-backward verification |
+| `skills_to_apply` | No | Skills-library references |
+| `assumptions` | No | Key assumptions |
+| `risk_level` | No | Verification depth (default: low) |
+
+---
+
+## Scope Guidance
+
+- 2-3 tasks per plan, ~50% context max
+- Prefer vertical slices (User: model+API+UI) over horizontal layers
+- Split by risk level (high-risk separate from low-risk)
+- TDD candidates get separate plans
+
+---
+
+## Task Types
+
+| Type | Use For | Autonomy |
+|------|---------|----------|
+| `auto` | Everything Claude can do | Fully autonomous |
+| `checkpoint:human-verify` | Visual/functional checks | Pauses for user |
+| `checkpoint:decision` | Implementation choices | Pauses for user |
+| `checkpoint:human-action` | Unavoidable manual steps | Pauses for user |