@thierrynakoa/fire-flow 10.0.0

package/templates/record.md

@@ -0,0 +1,131 @@
+# Summary Template (Dominion Flow Enhanced)
+
+> **Origin:** Ported from Dominion Flow `summary.md` with metrics collection for trend analysis.
+
+Template for `.planning/phases/XX-name/{phase}-{plan}-RECORD.md`
+
+---
+
+## File Template
+
+```markdown
+---
+phase: XX-name
+plan: NN
+subsystem: [primary subsystem]
+tags: [tech tags]
+requires:
+  - [prior phases this builds on]
+provides:
+  - [what this delivers for future phases]
+affects:
+  - [future phases that may need to reference this]
+tech-stack:
+  added: [new dependencies]
+  patterns: [new patterns established]
+key-files:
+  created: [new files]
+  modified: [changed files]
+key-decisions:
+  - [decision: rationale]
+
+# Dominion Flow Metrics (for bottleneck detection + trend analysis)
+metrics:
+  duration_minutes: [N]
+  tasks_completed: [N]
+  tasks_blocked: [N]
+  files_created: [N]
+  files_modified: [N]
+  lines_added: [N]
+  lines_removed: [N]
+  tests_added: [N]
+  test_coverage_delta: "[+/-N%]"
+  skills_applied: [N]
+  honesty_checkpoints: [N]
+  commits: [N]
+  blocker_count: [N]
+  execution_mode: sequential|subagent|swarm
+  mode_reason: "[why this mode was selected]"
+  agents_spawned: [N]
+---
+
+## Quick Summary
+
+[One substantive sentence. Not "completed plan" - what was actually built.]
+
+## Task Commits
+
+| # | Hash | Description | Files |
+|---|------|-------------|-------|
+| 1 | abc1234 | feat(XX-NN): [task 1] | src/file1.ts, src/file2.ts |
+| 2 | def5678 | feat(XX-NN): [task 2] | src/file3.ts |
+| 3 | ghi9012 | test(XX-NN): [task 3] | src/__tests__/file.test.ts |
+
+## Deviations from Plan
+
+[If none: "None - executed as planned."]
+
+| Deviation | Rule | Detail |
+|-----------|------|--------|
+| [what changed] | Rule 1 - Bug | [why] |
+
+## Test Results
+
+| Segment | Tests Run | Passed | Failed | New Tests |
+|---------|-----------|--------|--------|-----------|
+| 1 | 24 | 24 | 0 | 3 |
+| 2 | 27 | 27 | 0 | 3 |
+
+## Decisions Made
+
+- **[Decision]:** [Choice made] — [Rationale]
+
+## Blockers Encountered
+
+- **BLOCKER-XXX [PX]:** [Description] — [Status: Resolved/Open]
+
+## Skills Applied
+
+- [skill-library/category/SKILL_NAME.md] — [how it helped]
+
+## Honesty Checkpoints
+
+- **Gap identified:** [what was uncertain]
+- **Research conducted:** [what was looked up]
+- **Resolution:** [what was decided]
+- **Confidence after research:** [High/Medium/Low]
+
+## Next Step
+
+[More plans in phase? Phase complete? What comes next?]
+
+## Performance
+
+- **Duration:** [N] minutes
+- **Started:** [timestamp]
+- **Completed:** [timestamp]
+- **Tasks:** [completed]/[total]
+- **Files:** [created] created, [modified] modified
+- **Branch:** feature/phase-XX-description
+```
+
+---
+
+## Writing Guidelines
+
+- **Quick Summary:** Substantive. "Built JWT auth with refresh tokens" not "Completed plan 02"
+- **Task Commits:** Include actual git hashes for traceability
+- **Deviations:** Categorize by Rule (1-Bug, 2-Critical, 3-Blocking, 4-Architectural)
+- **Metrics:** Fill accurately - these feed into bottleneck detection and trend analysis
+- **Skills Applied:** Reference exact skill file path for future reuse tracking
+- **Honesty Checkpoints:** Document any research conducted during execution
+
+---
+
+## Metrics Collection
+
+The `metrics` frontmatter is consumed by:
+- `/fire-transition` — aggregates into phase-level metrics in CONSCIENCE.md
+- `/fire-analytics` — historical trend analysis
+- `/fire-dashboard` — visual project health display
+- `references/metrics-and-trends.md` — bottleneck detection algorithm

package/templates/review-report.md

@@ -0,0 +1,117 @@
+# Multi-Perspective Code Review
+
+**Target:** {target}
+**Date:** {timestamp}
+**Depth:** shallow | normal | deep
+**Personas Used:** {count}
+
+---
+
+## Executive Summary
+
+| Severity | Count | Action Required |
+|----------|-------|-----------------|
+| CRITICAL | 0 | Immediate fix |
+| HIGH | 0 | Fix before merge |
+| MEDIUM | 0 | Address soon |
+| LOW | 0 | Optional |
+
+**Overall Assessment:** BLOCK | APPROVE WITH FIXES | APPROVE
+
+---
+
+## Critical Findings (Fix Immediately)
+
+### Finding #1: {Title}
+
+| Attribute | Value |
+|-----------|-------|
+| **Severity** | CRITICAL |
+| **Location** | `{file}:{line}` |
+| **Flagged By** | {persona list} |
+| **Confidence** | {percentage}% |
+
+**Problem:**
+```{language}
+// Code showing the issue
+```
+
+**Fix:**
+```{language}
+// Code showing the solution
+```
+
+**Why This Matters:**
+{Explanation of impact}
+
+---
+
+## High Priority Findings
+
+### Finding #{N}: {Title}
+
+| Attribute | Value |
+|-----------|-------|
+| **Severity** | HIGH |
+| **Location** | `{file}:{line}` |
+| **Flagged By** | {persona list} |
+
+**Problem:** {description}
+
+**Fix:** {recommendation}
+
+---
+
+## Medium Priority Findings
+
+| # | Location | Issue | Flagged By |
+|---|----------|-------|------------|
+| 1 | `{file}:{line}` | {issue} | {persona} |
+
+---
+
+## Low Priority / Suggestions
+
+- {suggestion 1}
+- {suggestion 2}
+
+---
+
+## Persona Breakdown
+
+### Security Review ({count} personas)
+- **Issues Found:** {count}
+- **Unique Insights:** {insights}
+
+### Quality Review ({count} personas)
+- **Issues Found:** {count}
+- **Unique Insights:** {insights}
+
+### Architecture Review ({count} personas)
+- **Issues Found:** {count}
+- **Unique Insights:** {insights}
+
+### UX/DX Review ({count} personas)
+- **Issues Found:** {count}
+- **Unique Insights:** {insights}
+
+---
+
+## Actionable Summary
+
+### Must Fix Before Merge
+1. [ ] {item}
+2. [ ] {item}
+
+### Should Fix Soon
+1. [ ] {item}
+2. [ ] {item}
+
+### Consider Later
+1. [ ] {item}
+2. [ ] {item}
+
+---
+
+*Review completed: {timestamp}*
+*Powered by: Dominion Flow Multi-Perspective Review*

package/templates/skills-index.md

@@ -0,0 +1,157 @@
+# Skills Applied to This Project
+
+**Project:** {project_name}
+**Last Updated:** {last_updated}
+
+---
+
+## Summary
+
+| Metric | Value |
+|--------|-------|
+| Total skills applied | {total_skills_applied} |
+| Categories used | {categories_used_count} ({categories_list}) |
+| Most used category | {most_used_category} ({most_used_count} applications) |
+| Most effective skill | {most_effective_skill} |
+| Time saved estimate | {time_saved_estimate} |
+
+---
+
+## By Phase
+
+{by_phase_sections}
+
+---
+
+## By Category
+
+{by_category_sections}
+
+---
+
+## Skills Effectiveness
+
+| Skill | Times Applied | Avg Impact | Success Rate | Notes |
+|-------|---------------|------------|--------------|-------|
+{effectiveness_rows}
+
+---
+
+## Quick Reference
+
+### Most Valuable Skills for This Project
+{most_valuable_skills}
+
+### Commonly Used Patterns
+{common_patterns}
+
+### Skills to Consider Adding
+{skills_to_consider}
+
+---
+
+## Recent Applications
+
+| Date | Skill | Phase | Plan | Result |
+|------|-------|-------|------|--------|
+{recent_applications_rows}
+
+---
+
+## Contribution Candidates
+
+Skills discovered during this project that should be contributed to the global library:
+
+{contribution_candidates}
+
+---
+
+## Skills Search Quick Commands
+
+```bash
+# Search for database patterns
+/fire-search "database performance"
+
+# Search for security solutions
+/fire-search "authentication"
+
+# Search for API patterns
+/fire-search "pagination REST"
+
+# View skill details
+/fire-search "select:database-solutions/n-plus-1"
+
+# View skill history
+/fire-skills-history database-solutions/n-plus-1
+
+# Sync with global library
+/fire-skills-sync --both
+```
+
+---
+
+## Category Index
+
+### database-solutions/
+{database_solutions_list}
+
+### api-patterns/
+{api_patterns_list}
+
+### security/
+{security_list}
+
+### performance/
+{performance_list}
+
+### frontend/
+{frontend_list}
+
+### testing/
+{testing_list}
+
+### infrastructure/
+{infrastructure_list}
+
+### automation/
+{automation_list}
+
+### deployment-security/
+{deployment_security_list}
+
+### patterns-standards/
+{patterns_standards_list}
+
+### form-solutions/
+{form_solutions_list}
+
+### document-processing/
+{document_processing_list}
+
+### video-media/
+{video_media_list}
+
+### integrations/
+{integrations_list}
+
+### methodology/
+{methodology_list}
+
+---
+
+## Analytics Summary
+
+### Usage Over Time
+```
+{usage_timeline_ascii}
+```
+
+### Category Distribution
+```
+{category_distribution_ascii}
+```
+
+---
+
+*Index generated: {generated_timestamp}*
+*Run `/fire-analytics` for detailed usage statistics*

package/templates/verification.md

@@ -0,0 +1,149 @@
+# Verification Report: Phase {phase_number}
+
+**Project:** {project_name}
+**Phase:** {phase_number} - {phase_name}
+**Date:** {verification_date}
+**Verifier:** fire-verifier
+
+---
+
+## Summary
+
+| Category | Score | Status |
+|----------|-------|--------|
+| Must-Haves | {musthave_passed}/{musthave_total} | {musthave_status} |
+| WARRIOR Validation | {warrior_passed}/{warrior_total} | {warrior_status} |
+| **Overall** | **{total_passed}/{total_total}** | **{overall_status}** |
+
+---
+
+## Must-Haves: {musthave_passed}/{musthave_total} {musthave_status_emoji}
+
+### Truths (Observable Behaviors)
+{truths_checklist}
+
+### Artifacts (File Verification)
+{artifacts_checklist}
+
+### Key Links (Component Wiring)
+{key_links_checklist}
+
+---
+
+## WARRIOR Validation: {warrior_passed}/{warrior_total} {warrior_status_emoji}
+
+### Code Quality ({code_quality_passed}/{code_quality_total}) {code_quality_emoji}
+- [ ] Project builds without errors
+- [ ] No TypeScript errors (`npx tsc --noEmit`)
+- [ ] ESLint compliance (`npx eslint . --ext .ts,.tsx`)
+- [ ] No console.logs in production code
+- [ ] Code comments present (why, not what)
+- [ ] Functions have JSDoc/TSDoc where appropriate
+
+### Testing ({testing_passed}/{testing_total}) {testing_emoji}
+- [ ] Unit tests passing (`npm run test`)
+- [ ] Integration tests passing (`npm run test:integration`)
+- [ ] Test coverage >= {coverage_threshold}% (current: {current_coverage}%)
+- [ ] Manual testing complete
+- [ ] E2E tests passing (if applicable)
+
+### Security ({security_passed}/{security_total}) {security_emoji}
+- [ ] No hardcoded credentials in code
+- [ ] No secrets in git history
+- [ ] Input validation implemented
+- [ ] SQL injection prevention (parameterized queries)
+- [ ] XSS protection (output encoding)
+- [ ] HTTPS enforced in production
+- [ ] CORS configured properly
+- [ ] Rate limiting active on public endpoints
+
+### Performance ({performance_passed}/{performance_total}) {performance_emoji}
+- [ ] Page load times < 2s (LCP)
+- [ ] Database queries optimized (no N+1)
+- [ ] Proper indexes on frequently queried columns
+- [ ] No memory leaks detected
+- [ ] API response times < 200ms (p95)
+- [ ] Bundle size within limits
+
+### Database ({database_passed}/{database_total}) {database_emoji}
+- [ ] Migrations applied successfully
+- [ ] Schema matches expected state
+- [ ] Indexes created for foreign keys
+- [ ] Proper constraints (NOT NULL, UNIQUE)
+- [ ] Seed data available for testing
+
+### API Design ({api_passed}/{api_total}) {api_emoji}
+- [ ] RESTful conventions followed
+- [ ] Proper HTTP status codes
+- [ ] Error responses are informative
+- [ ] Versioning in place (/v1/, /v2/)
+- [ ] Rate limiting headers present
+- [ ] API documentation updated
+
+### Infrastructure ({infra_passed}/{infra_total}) {infra_emoji}
+- [ ] Environment variables documented
+- [ ] Docker configuration valid (if used)
+- [ ] CI/CD pipeline passing
+- [ ] Health check endpoint available
+
+### Documentation ({docs_passed}/{docs_total}) {docs_emoji}
+- [ ] README updated with new features
+- [ ] API documentation current
+- [ ] Setup instructions accurate
+- [ ] Changelog entry added
+
+---
+
+## Gaps Identified
+
+{gaps_list}
+
+---
+
+## Automated Check Results
+
+### Code Quality Checks
+```
+{code_quality_output}
+```
+
+### Test Results
+```
+{test_output}
+```
+
+### Security Scan
+```
+{security_scan_output}
+```
+
+### Performance Metrics
+```
+{performance_metrics_output}
+```
+
+---
+
+## Recommendations
+
+{recommendations}
+
+---
+
+## Verification Status: {final_status}
+
+{final_recommendation}
+
+---
+
+## Sign-Off
+
+- [ ] Must-Haves verified by: {pf_verifier}
+- [ ] WARRIOR validation by: {warrior_verifier}
+- [ ] Human review completed: {human_reviewer}
+- [ ] Approved for: {approved_for}
+
+---
+
+*Verification completed: {verification_timestamp}*
+*Report generated by: fire-verifier agent*

package/templates/vision.md

@@ -0,0 +1,79 @@
+# {project_name} Roadmap
+
+## Milestone: v{milestone_version} - {milestone_name}
+
+**Target:** {milestone_target_date}
+**Status:** {milestone_status}
+**Progress:** [{progress_bar}] {progress_percent}%
+
+---
+
+## Phase Overview
+
+| # | Phase | Status | Plans | Description |
+|---|-------|--------|-------|-------------|
+{phase_overview_rows}
+
+---
+
+## Phase Details
+
+{phase_details}
+
+---
+
+## Dependencies
+
+```mermaid
+graph TD
+{dependency_graph}
+```
+
+---
+
+## Timeline
+
+```
+{timeline_ascii}
+```
+
+---
+
+## Risk Assessment
+
+| Risk | Impact | Mitigation | Status |
+|------|--------|------------|--------|
+{risk_rows}
+
+---
+
+## Success Criteria
+
+### Must-Haves (Required for v{milestone_version})
+{must_haves_list}
+
+### Nice-to-Haves (Deferred if needed)
+{nice_to_haves_list}
+
+---
+
+## Milestone Completion Checklist
+
+- [ ] All phases completed
+- [ ] All must-haves verified
+- [ ] Dominion Flow validation passed
+- [ ] WARRIOR 70-point validation passed
+- [ ] Documentation updated
+- [ ] Handoff created
+- [ ] Ready for deployment/release
+
+---
+
+## Notes
+
+{notes}
+
+---
+
+*Created: {created_date}*
+*Last updated: {last_updated}*