specsmd 0.0.0-dev.9 → 0.0.0-dev.90

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (146) hide show
  1. package/README.md +190 -224
  2. package/bin/cli.js +28 -1
  3. package/flows/aidlc/commands/construction-agent.md +5 -1
  4. package/flows/aidlc/commands/inception-agent.md +4 -0
  5. package/flows/aidlc/commands/master-agent.md +4 -0
  6. package/flows/aidlc/commands/operations-agent.md +4 -0
  7. package/flows/aidlc/memory-bank.yaml +2 -1
  8. package/{scripts/artifact-validator.js → flows/aidlc/scripts/artifact-validator.cjs} +3 -3
  9. package/{scripts/bolt-complete.js → flows/aidlc/scripts/bolt-complete.cjs} +36 -5
  10. package/{scripts/status-integrity.js → flows/aidlc/scripts/status-integrity.cjs} +5 -5
  11. package/flows/aidlc/skills/construction/bolt-list.md +1 -1
  12. package/flows/aidlc/skills/construction/bolt-start.md +3 -3
  13. package/flows/aidlc/skills/construction/bolt-status.md +1 -1
  14. package/flows/aidlc/skills/construction/prototype-apply.md +311 -0
  15. package/flows/aidlc/skills/inception/vibe-to-spec.md +410 -0
  16. package/flows/aidlc/skills/master/analyze-context.md +1 -1
  17. package/flows/aidlc/templates/construction/bolt-template.md +2 -2
  18. package/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt.md +73 -11
  19. package/flows/aidlc/templates/standards/decision-index-template.md +32 -0
  20. package/flows/fire/README.md +19 -0
  21. package/flows/fire/agents/builder/agent.md +260 -0
  22. package/flows/fire/agents/builder/skills/code-review/SKILL.md +257 -0
  23. package/flows/fire/agents/builder/skills/code-review/references/auto-fix-rules.md +218 -0
  24. package/flows/fire/agents/builder/skills/code-review/references/review-categories.md +154 -0
  25. package/flows/fire/agents/builder/skills/code-review/templates/review-report.md.hbs +120 -0
  26. package/flows/fire/agents/builder/skills/run-execute/SKILL.md +714 -0
  27. package/flows/fire/agents/builder/skills/run-execute/scripts/complete-run.cjs +800 -0
  28. package/flows/fire/agents/builder/skills/run-execute/scripts/init-run.cjs +500 -0
  29. package/flows/fire/agents/builder/skills/run-execute/scripts/update-checkpoint.cjs +254 -0
  30. package/flows/fire/agents/builder/skills/run-execute/scripts/update-phase.cjs +250 -0
  31. package/flows/fire/agents/builder/skills/run-execute/templates/plan.md.hbs +61 -0
  32. package/flows/fire/agents/builder/skills/run-execute/templates/test-report.md.hbs +81 -0
  33. package/flows/fire/agents/builder/skills/run-plan/SKILL.md +378 -0
  34. package/flows/fire/agents/builder/skills/run-status/SKILL.md +96 -0
  35. package/flows/fire/agents/builder/skills/walkthrough-generate/SKILL.md +267 -0
  36. package/flows/fire/agents/builder/skills/walkthrough-generate/templates/walkthrough.md.hbs +176 -0
  37. package/flows/fire/agents/orchestrator/agent.md +144 -0
  38. package/flows/fire/agents/orchestrator/skills/project-init/SKILL.md +226 -0
  39. package/flows/fire/agents/orchestrator/skills/project-init/templates/coding-standards.md.hbs +149 -0
  40. package/flows/fire/agents/orchestrator/skills/project-init/templates/constitution.md.hbs +43 -0
  41. package/flows/fire/agents/orchestrator/skills/project-init/templates/system-architecture.md.hbs +101 -0
  42. package/flows/fire/agents/orchestrator/skills/project-init/templates/tech-stack.md.hbs +136 -0
  43. package/flows/fire/agents/orchestrator/skills/project-init/templates/testing-standards.md.hbs +94 -0
  44. package/flows/fire/agents/orchestrator/skills/route/SKILL.md +146 -0
  45. package/flows/fire/agents/orchestrator/skills/status/SKILL.md +696 -0
  46. package/flows/fire/agents/planner/agent.md +143 -0
  47. package/flows/fire/agents/planner/skills/design-doc-generate/SKILL.md +156 -0
  48. package/flows/fire/agents/planner/skills/design-doc-generate/templates/design.md.hbs +124 -0
  49. package/flows/fire/agents/planner/skills/intent-capture/SKILL.md +125 -0
  50. package/flows/fire/agents/planner/skills/intent-capture/templates/brief.md.hbs +40 -0
  51. package/flows/fire/agents/planner/skills/work-item-decompose/SKILL.md +166 -0
  52. package/flows/fire/agents/planner/skills/work-item-decompose/templates/work-item.md.hbs +40 -0
  53. package/flows/fire/commands/fire-builder.md +56 -0
  54. package/flows/fire/commands/fire-planner.md +48 -0
  55. package/flows/fire/commands/fire.md +46 -0
  56. package/flows/fire/memory-bank.yaml +240 -0
  57. package/flows/fire/quick-start.md +146 -0
  58. package/flows/ideation/README.md +35 -0
  59. package/flows/ideation/agents/orchestrator/agent.md +103 -0
  60. package/flows/ideation/agents/orchestrator/skills/flame/SKILL.md +132 -0
  61. package/flows/ideation/agents/orchestrator/skills/flame/references/evaluation-criteria.md +81 -0
  62. package/flows/ideation/agents/orchestrator/skills/flame/references/six-hats-method.md +87 -0
  63. package/flows/ideation/agents/orchestrator/skills/flame/templates/flame-report.md.hbs +81 -0
  64. package/flows/ideation/agents/orchestrator/skills/forge/SKILL.md +153 -0
  65. package/flows/ideation/agents/orchestrator/skills/forge/references/disney-method.md +94 -0
  66. package/flows/ideation/agents/orchestrator/skills/forge/references/pitch-framework.md +87 -0
  67. package/flows/ideation/agents/orchestrator/skills/forge/templates/concept-brief.md.hbs +83 -0
  68. package/flows/ideation/agents/orchestrator/skills/spark/SKILL.md +152 -0
  69. package/flows/ideation/agents/orchestrator/skills/spark/references/anti-bias.md +43 -0
  70. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/analogy.md +60 -0
  71. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/first-principles.md +56 -0
  72. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/index.yaml +76 -0
  73. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/inversion.md +52 -0
  74. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/questorming.md +57 -0
  75. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/random-word.md +35 -0
  76. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/scamper.md +67 -0
  77. package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/what-if.md +55 -0
  78. package/flows/ideation/agents/orchestrator/skills/spark/templates/spark-bank.md.hbs +72 -0
  79. package/flows/ideation/commands/flame.md +43 -0
  80. package/flows/ideation/commands/forge.md +43 -0
  81. package/flows/ideation/commands/ideation.md +51 -0
  82. package/flows/ideation/commands/spark.md +43 -0
  83. package/flows/ideation/memory-bank.yaml +177 -0
  84. package/flows/ideation/quick-start.md +84 -0
  85. package/flows/ideation/shared/protocols/anti-bias.md +79 -0
  86. package/flows/ideation/shared/protocols/deep-thinking.md +92 -0
  87. package/flows/ideation/shared/protocols/diverge-converge.md +72 -0
  88. package/flows/ideation/shared/protocols/interaction-adaptation.md +88 -0
  89. package/flows/simple/README.md +190 -0
  90. package/flows/simple/agents/agent.md +404 -0
  91. package/flows/simple/commands/agent.md +60 -0
  92. package/flows/simple/context-config.yaml +34 -0
  93. package/flows/simple/memory-bank.yaml +66 -0
  94. package/flows/simple/quick-start.md +231 -0
  95. package/flows/simple/skills/design.md +96 -0
  96. package/flows/simple/skills/execute.md +190 -0
  97. package/flows/simple/skills/requirements.md +94 -0
  98. package/flows/simple/skills/tasks.md +136 -0
  99. package/flows/simple/templates/design-template.md +138 -0
  100. package/flows/simple/templates/requirements-template.md +85 -0
  101. package/flows/simple/templates/tasks-template.md +104 -0
  102. package/lib/analytics/tracker.js +6 -2
  103. package/lib/constants.js +25 -8
  104. package/lib/dashboard/aidlc/parser.js +581 -0
  105. package/lib/dashboard/fire/model.js +382 -0
  106. package/lib/dashboard/fire/parser.js +470 -0
  107. package/lib/dashboard/flow-detect.js +86 -0
  108. package/lib/dashboard/git/changes.js +362 -0
  109. package/lib/dashboard/git/worktrees.js +248 -0
  110. package/lib/dashboard/index.js +709 -0
  111. package/lib/dashboard/runtime/watch-runtime.js +122 -0
  112. package/lib/dashboard/simple/parser.js +293 -0
  113. package/lib/dashboard/tui/app.js +1675 -0
  114. package/lib/dashboard/tui/components/error-banner.js +35 -0
  115. package/lib/dashboard/tui/components/header.js +60 -0
  116. package/lib/dashboard/tui/components/help-footer.js +15 -0
  117. package/lib/dashboard/tui/components/stats-strip.js +35 -0
  118. package/lib/dashboard/tui/file-entries.js +383 -0
  119. package/lib/dashboard/tui/flow-builders.js +991 -0
  120. package/lib/dashboard/tui/git-builders.js +218 -0
  121. package/lib/dashboard/tui/helpers.js +236 -0
  122. package/lib/dashboard/tui/overlays.js +242 -0
  123. package/lib/dashboard/tui/preview.js +220 -0
  124. package/lib/dashboard/tui/renderer.js +76 -0
  125. package/lib/dashboard/tui/row-builders.js +797 -0
  126. package/lib/dashboard/tui/sections.js +45 -0
  127. package/lib/dashboard/tui/store.js +44 -0
  128. package/lib/dashboard/tui/views/overview-view.js +61 -0
  129. package/lib/dashboard/tui/views/runs-view.js +93 -0
  130. package/lib/dashboard/tui/worktree-builders.js +229 -0
  131. package/lib/dashboard/web/extension-adapter.js +726 -0
  132. package/lib/dashboard/web/public/app.js +9 -0
  133. package/lib/dashboard/web/public/index.html +14 -0
  134. package/lib/dashboard/web/public/styles.css +36 -0
  135. package/lib/dashboard/web/public/webview-bundle.js +7596 -0
  136. package/lib/dashboard/web/server.js +376 -0
  137. package/lib/dashboard/web/snapshot.js +299 -0
  138. package/lib/installer.js +19 -15
  139. package/lib/installers/CodexInstaller.js +72 -1
  140. package/lib/installers/KiroInstaller.js +55 -0
  141. package/lib/installers/OpenCodeInstaller.js +9 -1
  142. package/lib/installers/ToolInstaller.js +4 -1
  143. package/lib/installers/WindsurfInstaller.js +0 -54
  144. package/package.json +15 -55
  145. package/scripts/check-webview-bundle-sync.cjs +38 -0
  146. package/scripts/sync-webview-bundle.cjs +19 -0
@@ -0,0 +1,146 @@
1
+ # FIRE Flow
2
+
3
+ **Fast Intent-Run Engineering** — A simplified AI-native development methodology.
4
+
5
+ ## Overview
6
+
7
+ FIRE reduces the complexity of AI-assisted development by flattening the hierarchy:
8
+
9
+ ```
10
+ Intent → Work Item → Run
11
+ ```
12
+
13
+ Unlike traditional methodologies with 10-26 checkpoints, FIRE uses adaptive checkpoints (0-2) based on work item complexity.
14
+
15
+ ## Quick Start
16
+
17
+ ```bash
18
+ # Initialize FIRE in your project
19
+ /specsmd-fire
20
+
21
+ # Or directly invoke specific agents
22
+ /specsmd-fire-planner # For planning work
23
+ /specsmd-fire-builder # For executing work
24
+ ```
25
+
26
+ ## Execution Modes
27
+
28
+ | Mode | Checkpoints | Complexity | Use For |
29
+ |------|-------------|------------|---------|
30
+ | **Autopilot** | 0 | Low | Bug fixes, minor updates |
31
+ | **Confirm** | 1 | Medium | Standard features |
32
+ | **Validate** | 2 | High | Security, payments, architecture |
33
+
34
+ ## Run Scope
35
+
36
+ Run scope determines how many work items execute in a single run:
37
+
38
+ | Scope | Description | Grouping |
39
+ |-------|-------------|----------|
40
+ | **Single** | One work item per run, most controlled | Each item in its own run |
41
+ | **Batch** | Group items by mode, respect dependencies | Autopilot together, confirm together |
42
+ | **Wide** | Maximum items per run, minimal interruption | All compatible items together |
43
+
44
+ The system learns your preference from run history and stores it in `workspace.run_scope_preference`.
45
+
46
+ ## Project Structure
47
+
48
+ When initialized, FIRE creates:
49
+
50
+ ```
51
+ .specs-fire/
52
+ ├── state.yaml # Central state (source of truth)
53
+ ├── intents/ # Intent briefs and work items
54
+ │ └── {intent-id}/
55
+ │ ├── brief.md
56
+ │ └── work-items/
57
+ │ └── {work-item-id}.md
58
+ ├── runs/ # Run logs and walkthroughs
59
+ │ └── {run-id}/
60
+ │ ├── run.md
61
+ │ └── walkthrough.md
62
+ └── standards/ # Project standards
63
+ ├── tech-stack.md
64
+ └── coding-standards.md
65
+ ```
66
+
67
+ ## Agents
68
+
69
+ ### Orchestrator (`/specsmd-fire`)
70
+
71
+ Routes users based on project state:
72
+
73
+ - New project → Initialize
74
+ - No intent → Capture intent
75
+ - No work items → Decompose
76
+ - Pending work → Execute
77
+
78
+ ### Planner (`/specsmd-fire-planner`)
79
+
80
+ Handles planning:
81
+
82
+ - **intent-capture** — Capture user intent through conversation
83
+ - **work-item-decompose** — Break intent into executable work items
84
+ - **design-doc-generate** — Create design docs for Validate mode
85
+
86
+ ### Builder (`/specsmd-fire-builder`)
87
+
88
+ Handles execution:
89
+
90
+ - **run-execute** — Execute work items with mode-appropriate checkpoints
91
+ - **walkthrough-generate** — Generate implementation documentation
92
+ - **run-status** — Show current run progress
93
+
94
+ ## Flow Directory Structure
95
+
96
+ ```
97
+ src/flows/fire/
98
+ ├── agents/
99
+ │ ├── orchestrator/
100
+ │ │ ├── agent.md
101
+ │ │ └── skills/
102
+ │ │ ├── project-init/
103
+ │ │ ├── route/
104
+ │ │ └── status/
105
+ │ ├── planner/
106
+ │ │ ├── agent.md
107
+ │ │ └── skills/
108
+ │ │ ├── intent-capture/
109
+ │ │ ├── work-item-decompose/
110
+ │ │ └── design-doc-generate/
111
+ │ └── builder/
112
+ │ ├── agent.md
113
+ │ └── skills/
114
+ │ ├── run-execute/
115
+ │ ├── walkthrough-generate/
116
+ │ └── run-status/
117
+ ├── commands/
118
+ │ ├── fire.md
119
+ │ ├── fire-planner.md
120
+ │ └── fire-builder.md
121
+ ├── templates/
122
+ │ ├── intents/
123
+ │ ├── runs/
124
+ │ └── standards/
125
+ ├── memory-bank.yaml
126
+ └── quick-start.md
127
+ ```
128
+
129
+ ## Comparison with AI-DLC
130
+
131
+ | Aspect | AI-DLC | FIRE |
132
+ |--------|--------|------|
133
+ | Hierarchy | Intent → Unit → Story | Intent → Work Item |
134
+ | Checkpoints | 10-26 per feature | 0-2 per work item |
135
+ | Phases | Inception → Construction → Operations | Plan → Execute |
136
+ | Artifacts | Extensive | Minimal |
137
+ | Best for | Large initiatives, teams | Rapid delivery, individuals |
138
+
139
+ ## Configuration
140
+
141
+ See `memory-bank.yaml` for:
142
+
143
+ - Artifact paths
144
+ - Naming conventions
145
+ - Execution modes
146
+ - Agent ownership
@@ -0,0 +1,35 @@
1
+ # Ideation Flow
2
+
3
+ **Spark → Flame → Forge** — Creative ideation for AI-native thinkers.
4
+
5
+ For getting started, see [quick-start.md](./quick-start.md).
6
+
7
+ ## Summary
8
+
9
+ - **Hierarchy**: Topic → Session (Spark Bank → Flame Report → Concept Brief)
10
+ - **Skills**: Spark (generate), Flame (evaluate), Forge (shape)
11
+ - **Agent**: Single orchestrator with 3 skills
12
+
13
+ ## Commands
14
+
15
+ | Command | Purpose |
16
+ |---------|---------|
17
+ | `/specsmd-ideation` | Main entry point (orchestrator) |
18
+ | `/specsmd-spark` | Direct idea generation |
19
+ | `/specsmd-flame` | Direct idea evaluation |
20
+ | `/specsmd-forge` | Direct concept shaping |
21
+
22
+ ## Research Foundation
23
+
24
+ This flow synthesizes insights from established creativity research. Source materials are in `/resources/brainstorming/`:
25
+
26
+ | Source | Key Contribution |
27
+ |--------|-----------------|
28
+ | **Applied Imagination** — Alex Osborn (1953) | Deferred judgment, quantity-first, Osborn-Parnes CPS, idea prompter checklists (became SCAMPER) |
29
+ | **Six Thinking Hats** — Edward de Bono (1985) | Parallel thinking, ego protection via hat roles, hat sequencing methodology |
30
+ | **Enhancing Your Creative Spirit** — Dr. John Kapeleris (2009) | Creativity decline data, Wallas creative process, stimulation methods |
31
+ | **Creative & Group Thinking Techniques** — Skillfluence | 25 practical techniques with phase-based organization |
32
+ | **Brainstorming (Wikipedia)** | 9 variations, 6 research-backed challenges, improvement methods |
33
+ | **Anthropic XML Guide** | State machine execution, semantic tags, skill architecture |
34
+
35
+ See `/resources/brainstorming/analysis.md` for the full cross-resource synthesis.
@@ -0,0 +1,103 @@
1
+ ---
2
+ name: ideation-orchestrator
3
+ description: Creative ideation guide — routes users through Spark → Flame → Forge flow.
4
+ version: 1.0.0
5
+ ---
6
+
7
+ <role>
8
+ You are the **Ideation Orchestrator** for specsmd.
9
+
10
+ - **Role**: Creative Ideation Guide
11
+ - **Communication**: Energetic, concise, action-oriented. Get to ideas fast.
12
+ - **Principle**: Zero friction. Topic → ideas in 30 seconds. Never ask setup questions.
13
+ </role>
14
+
15
+ <constraints critical="true">
16
+ <constraint>NEVER ask setup questions (technique choice, mode, format) — jump straight to generating</constraint>
17
+ <constraint>NEVER name techniques to the user (no "Let's use SCAMPER" or "Applying Six Hats")</constraint>
18
+ <constraint>NEVER generate more than 2 questions in a row before producing creative output</constraint>
19
+ <constraint>ALWAYS maintain anti-bias diversity across idea domains</constraint>
20
+ <constraint>MUST use deep thinking protocol for every idea batch</constraint>
21
+ </constraints>
22
+
23
+ <on_activation>
24
+ When user invokes this agent:
25
+
26
+ <step n="1" title="Load Config">
27
+ <action>Read `.specsmd/ideation/memory-bank.yaml` for configuration</action>
28
+ </step>
29
+
30
+ <step n="2" title="Check for Existing Sessions">
31
+ <action>Check if `.specs-ideation/sessions/` exists and has active sessions</action>
32
+ <check if="active session with phase != complete">
33
+ <action>Offer to resume: "You have an active session on '{topic}'. Resume or start fresh?"</action>
34
+ </check>
35
+ </step>
36
+
37
+ <step n="3" title="Route by Input">
38
+ <check if="user provided a topic">
39
+ <action>Jump directly to Spark skill with the topic</action>
40
+ </check>
41
+ <check if="user provided ideas to evaluate">
42
+ <action>Jump to Flame skill with the ideas</action>
43
+ </check>
44
+ <check if="user provided concepts to shape">
45
+ <action>Jump to Forge skill with the concepts</action>
46
+ </check>
47
+ <check if="no input provided">
48
+ <action>Ask: "What would you like to explore ideas about?"</action>
49
+ <action>On response, jump to Spark skill</action>
50
+ </check>
51
+ </step>
52
+ </on_activation>
53
+
54
+ <skills>
55
+ | Command | Skill | Description |
56
+ |---------|-------|-------------|
57
+ | `spark`, `generate`, `ideas` | `skills/spark/SKILL.md` | Generate ideas — rapid-fire batches with cross-domain diversity |
58
+ | `flame`, `evaluate`, `score` | `skills/flame/SKILL.md` | Evaluate ideas — multi-perspective analysis and scoring |
59
+ | `forge`, `shape`, `develop` | `skills/forge/SKILL.md` | Shape concepts — develop top ideas into actionable concept briefs |
60
+ </skills>
61
+
62
+ <session_management>
63
+ Sessions track state across skills:
64
+
65
+ ```
66
+ .specs-ideation/sessions/{session-id}/
67
+ ├── session.yaml # State (phase, favorites, scores)
68
+ ├── spark-bank.md # Generated ideas
69
+ ├── flame-report.md # Evaluation results
70
+ └── concept-briefs/ # Shaped concepts
71
+ ```
72
+
73
+ - Create session on first Spark batch
74
+ - Update session.yaml at each phase transition
75
+ - Session ID format: `{topic-slug}-{YYYYMMDD}`
76
+ </session_management>
77
+
78
+ <flow_transitions>
79
+ Natural flow progression:
80
+
81
+ ```
82
+ Spark → "Ready to evaluate?" → Flame → "Ready to shape?" → Forge → Complete
83
+ ```
84
+
85
+ Users can also:
86
+
87
+ - Skip Spark (bring their own ideas to Flame)
88
+ - Skip Flame (bring evaluated ideas to Forge)
89
+ - Loop back (Forge → more Spark to explore new angles)
90
+ - Use any skill standalone
91
+ </flow_transitions>
92
+
93
+ <success_criteria>
94
+ <criterion>User gets creative ideas within 30 seconds of providing a topic</criterion>
95
+ <criterion>Ideas span genuinely diverse domains</criterion>
96
+ <criterion>Flow transitions feel natural, not procedural</criterion>
97
+ <criterion>Output documents are polished and shareable</criterion>
98
+ <criterion>Session state is maintained for resumability</criterion>
99
+ </success_criteria>
100
+
101
+ <begin>
102
+ Check for existing sessions, then route based on user input. If a topic is provided, go straight to Spark.
103
+ </begin>
@@ -0,0 +1,132 @@
1
+ ---
2
+ name: flame
3
+ description: Multi-perspective idea evaluation using Six Hats analysis, impact/feasibility scoring, and collaborative shortlisting.
4
+ version: 1.0.0
5
+ ---
6
+
7
+ <objective>
8
+ Evaluate ideas fairly through multiple perspectives. Surface hidden value, identify risks, and produce a ranked shortlist for Forge.
9
+ </objective>
10
+
11
+ <triggers>
12
+ - Spark Bank generated and user wants to evaluate
13
+ - User provides ideas directly for evaluation
14
+ - Orchestrator routes to Flame
15
+ - User invokes `/specsmd-flame`
16
+ </triggers>
17
+
18
+ <degrees_of_freedom>
19
+ **MEDIUM** — Structured evaluation with room for user input and collaborative extension.
20
+ </degrees_of_freedom>
21
+
22
+ <llm critical="true">
23
+ <mandate>NEVER skip ideas — evaluate ALL ideas, not just obvious favorites (hidden gems exist)</mandate>
24
+ <mandate>NEVER evaluate through a single lens — always use multiple perspectives</mandate>
25
+ <mandate>ALWAYS pause at Red Hat for user's gut feeling (the one required elicitation)</mandate>
26
+ <mandate>ALWAYS present evaluation as multi-dimensional, not pass/fail</mandate>
27
+ <mandate>NEVER dismiss ideas prematurely — look for the kernel of value in each</mandate>
28
+ </llm>
29
+
30
+ <protocols>
31
+ - `.specsmd/ideation/shared/protocols/interaction-adaptation.md` — Generate:60% / Elicit:15% / Co-build:25%
32
+ - `.specsmd/ideation/shared/protocols/diverge-converge.md` — Convergent mode with structured divergent extensions
33
+ </protocols>
34
+
35
+ <references>
36
+ - `references/six-hats-method.md` — De Bono methodology adapted for AI execution
37
+ - `references/evaluation-criteria.md` — Impact, feasibility, novelty, risk frameworks
38
+ </references>
39
+
40
+ <flow>
41
+ <step n="1" title="Load Ideas">
42
+ <check if="Spark Bank exists in session">
43
+ <action>Load spark-bank.md from current session</action>
44
+ <action>Prioritize favorites but include all ideas</action>
45
+ </check>
46
+ <check if="user provides ideas directly">
47
+ <action>Accept ideas as input</action>
48
+ </check>
49
+ <check if="no ideas available">
50
+ <ask>Which ideas would you like to evaluate? You can list them or I can load from a Spark session.</ask>
51
+ </check>
52
+ </step>
53
+
54
+ <step n="2" title="Rapid Six Hats Analysis">
55
+ <action>For each idea (or top 10-15 if many), perform rapid Six Hats analysis:</action>
56
+ <format>
57
+ **{idea title}**
58
+
59
+ | Hat | Perspective |
60
+ |-----|------------|
61
+ | White (Facts) | What do we know? What data exists? |
62
+ | Yellow (Benefits) | What's the best case? Why could this work? |
63
+ | Black (Risks) | What could go wrong? What are the dangers? |
64
+ | Green (Creative) | How could this be extended or combined? |
65
+ | Blue (Process) | What would it take to implement? What's the path? |
66
+ </format>
67
+ <critical>Red Hat is handled separately in step 3 — it requires user input</critical>
68
+ <action>Present analysis in batches of 3-5 ideas to avoid overwhelming</action>
69
+ </step>
70
+
71
+ <step n="3" title="Red Hat — User Gut Feeling">
72
+ <action>For each batch of analyzed ideas, pause and ask:</action>
73
+ <ask>What's your gut feeling on these? Which ones excite you? Which feel wrong despite looking good on paper?</ask>
74
+ <action>Record user's emotional responses</action>
75
+ <ai_fallback>If user says "you decide" — infer gut feeling from their Spark favorites and engagement patterns</ai_fallback>
76
+ </step>
77
+
78
+ <step n="4" title="Impact/Feasibility Scoring">
79
+ <action>Score each evaluated idea on two axes:</action>
80
+ <scoring>
81
+ **Impact** (1-5): How much value would this create if successful?
82
+ - 5: Transformative — changes the game entirely
83
+ - 4: Significant — clear, major improvement
84
+ - 3: Moderate — useful but not remarkable
85
+ - 2: Minor — incremental improvement
86
+ - 1: Negligible — barely noticeable
87
+
88
+ **Feasibility** (1-5): How achievable is this?
89
+ - 5: Easy — could start today with existing resources
90
+ - 4: Doable — requires some effort but clearly achievable
91
+ - 3: Challenging — significant effort but realistic
92
+ - 2: Hard — requires major investment or breakthroughs
93
+ - 1: Near-impossible — fundamental barriers exist
94
+ </scoring>
95
+ <action>Present as a 2x2 matrix view: high-impact/high-feasibility quadrant first</action>
96
+ </step>
97
+
98
+ <step n="5" title="Shortlist and Flame Report">
99
+ <action>Recommend top 3-5 ideas for Forge based on:</action>
100
+ <criteria>
101
+ - Impact × Feasibility score
102
+ - User's Red Hat gut feelings
103
+ - Green Hat creative extensions
104
+ - Novelty (does this exist already?)
105
+ </criteria>
106
+ <action>Present shortlist with brief rationale for each</action>
107
+ <ask>Does this shortlist feel right? Want to adjust?</ask>
108
+ <action>Generate Flame Report using template: templates/flame-report.md.hbs</action>
109
+ <action>Save to: .specs-ideation/sessions/{session-id}/flame-report.md</action>
110
+ <action>Update session.yaml: phase → "flame-complete"</action>
111
+ <transition>
112
+ Suggest moving to Forge: "Your top {N} ideas are ready to shape into concepts. Ready?"
113
+ If yes → invoke Forge skill
114
+ </transition>
115
+ </step>
116
+ </flow>
117
+
118
+ <output_artifacts>
119
+
120
+ | Artifact | Location | Template |
121
+ |----------|----------|----------|
122
+ | Flame Report | `.specs-ideation/sessions/{id}/flame-report.md` | `./templates/flame-report.md.hbs` |
123
+ </output_artifacts>
124
+
125
+ <success_criteria>
126
+ <criterion>All ideas evaluated (not just favorites)</criterion>
127
+ <criterion>Multiple perspectives applied (Six Hats minimum)</criterion>
128
+ <criterion>User's gut feeling captured (Red Hat)</criterion>
129
+ <criterion>Scoring is multi-dimensional (impact + feasibility minimum)</criterion>
130
+ <criterion>Shortlist reflects both data and intuition</criterion>
131
+ <criterion>Flame Report is clear, organized, and immediately useful</criterion>
132
+ </success_criteria>
@@ -0,0 +1,81 @@
1
+ # Evaluation Criteria
2
+
3
+ Frameworks for scoring and comparing ideas. Used alongside Six Hats for multi-dimensional evaluation.
4
+
5
+ ## Primary Scoring: Impact × Feasibility
6
+
7
+ The core evaluation matrix. Every idea gets scored on both axes.
8
+
9
+ ### Impact (1-5)
10
+
11
+ | Score | Level | Description |
12
+ |-------|-------|-------------|
13
+ | 5 | **Transformative** | Changes the game entirely. Creates a new category or eliminates a major pain point. |
14
+ | 4 | **Significant** | Clear, major improvement. Users would notice and value it immediately. |
15
+ | 3 | **Moderate** | Useful but not remarkable. Incremental improvement with clear value. |
16
+ | 2 | **Minor** | Small improvement. Nice to have but not a differentiator. |
17
+ | 1 | **Negligible** | Barely noticeable effect. Low user value. |
18
+
19
+ ### Feasibility (1-5)
20
+
21
+ | Score | Level | Description |
22
+ |-------|-------|-------------|
23
+ | 5 | **Easy** | Could start today. Existing resources, known approach, low risk. |
24
+ | 4 | **Doable** | Requires effort but clearly achievable. Path is visible. |
25
+ | 3 | **Challenging** | Significant effort. Some unknowns but realistic with investment. |
26
+ | 2 | **Hard** | Major investment, new capabilities needed, or significant unknowns. |
27
+ | 1 | **Near-impossible** | Fundamental barriers. Requires breakthroughs or massive resources. |
28
+
29
+ ### Quadrant Interpretation
30
+
31
+ ```
32
+ HIGH IMPACT
33
+
34
+ Quick │ Big
35
+ Wins │ Bets
36
+ (4,4+) │ (4+,2-)
37
+
38
+ ──────────────┼──────────────
39
+
40
+ Fill-ins │ Money
41
+ (2-,4+) │ Pits
42
+ │ (2-,2-)
43
+
44
+ LOW IMPACT
45
+ HIGH FEASIBILITY ← → LOW FEASIBILITY
46
+ ```
47
+
48
+ - **Quick Wins** (high impact, high feasibility): Do these first
49
+ - **Big Bets** (high impact, low feasibility): Worth exploring if the payoff justifies the effort
50
+ - **Fill-ins** (low impact, high feasibility): Do if time permits
51
+ - **Money Pits** (low impact, low feasibility): Avoid unless there's a hidden insight
52
+
53
+ ## Secondary Criteria
54
+
55
+ ### Novelty (1-5)
56
+
57
+ How original is this idea?
58
+
59
+ - 5: Never seen before — genuinely new
60
+ - 4: New in this context — adapted from elsewhere
61
+ - 3: Fresh take on existing concept
62
+ - 2: Incremental variation
63
+ - 1: Already exists / obvious
64
+
65
+ ### Risk Profile
66
+
67
+ - **Technical risk**: Can this be built?
68
+ - **Market risk**: Will anyone want this?
69
+ - **Adoption risk**: Will people change behavior for this?
70
+ - **Competitive risk**: Can this be copied easily?
71
+
72
+ ## Aggregation
73
+
74
+ The Flame Report presents:
75
+
76
+ 1. **Impact × Feasibility matrix** — visual positioning
77
+ 2. **Six Hats summary** — qualitative analysis per idea
78
+ 3. **User Red Hat** — gut feelings
79
+ 4. **Composite ranking** — weighted by Impact (40%) + Feasibility (30%) + User Gut (20%) + Novelty (10%)
80
+
81
+ The composite is a starting point, not a verdict. Users can override any ranking based on their intuition and context.
@@ -0,0 +1,87 @@
1
+ # Six Thinking Hats Method
2
+
3
+ **Origin**: Edward de Bono, *Six Thinking Hats* (1985). Parallel thinking paradigm that separates ego from exploration.
4
+
5
+ ## Core Concept
6
+
7
+ Instead of arguing different positions, everyone (or the AI) wears the same "hat" at the same time, exploring one perspective fully before moving to the next. This prevents:
8
+
9
+ - **Ego defense** — ideas aren't "yours" or "mine"
10
+ - **Argument** — you're not debating, you're exploring perspectives
11
+ - **Incomplete analysis** — each hat forces a perspective that might be skipped
12
+
13
+ ## The Six Hats
14
+
15
+ ### White Hat — Facts & Data
16
+
17
+ - What do we know for certain?
18
+ - What data exists? What's missing?
19
+ - No interpretation or opinion — just facts
20
+ - **AI application**: State what's objectively true about the idea, what evidence supports it, what data would be needed
21
+
22
+ ### Red Hat — Feelings & Intuition
23
+
24
+ - What's the gut reaction?
25
+ - Emotions, hunches, instincts — no justification needed
26
+ - **AI application**: This is the ONE hat where user input is critical. AI should ask: "What's your gut feeling?" If user defers, AI infers from engagement patterns.
27
+
28
+ ### Black Hat — Risks & Caution
29
+
30
+ - What could go wrong?
31
+ - Where are the dangers, weaknesses, pitfalls?
32
+ - Devil's advocate perspective
33
+ - **AI application**: Be genuinely critical — not token concerns. Identify real risks: market, technical, adoption, unintended consequences.
34
+
35
+ ### Yellow Hat — Benefits & Optimism
36
+
37
+ - What's the best case scenario?
38
+ - Why could this work? What's the upside?
39
+ - Look for value even in seemingly weak ideas
40
+ - **AI application**: Find genuine strengths. For weak ideas, ask: "What kernel of value exists here?"
41
+
42
+ ### Green Hat — Creative Extensions
43
+
44
+ - How could this be improved, combined, extended?
45
+ - New alternatives, modifications, provocations
46
+ - This is the divergent hat within convergence
47
+ - **AI application**: Suggest creative modifications, combinations with other ideas, unexpected extensions
48
+
49
+ ### Blue Hat — Process & Planning
50
+
51
+ - What would implementation look like?
52
+ - What steps are needed? What's the timeline?
53
+ - Meta-thinking about the idea
54
+ - **AI application**: Sketch the implementation path, key decisions, resources needed
55
+
56
+ ## Sequencing for Ideation Flow
57
+
58
+ ### Rapid Evaluation Sequence (Flame default)
59
+
60
+ ```
61
+ White → Yellow → Black → Green → Blue
62
+ ```
63
+
64
+ Red Hat is handled separately (requires user input).
65
+
66
+ **Rationale**:
67
+
68
+ - Start with facts (ground the discussion)
69
+ - Benefits before risks (prevents premature dismissal)
70
+ - Creative extensions after critique (rescue and improve)
71
+ - Process last (only relevant for shortlisted ideas)
72
+
73
+ ### Full Sequence (for top shortlisted ideas)
74
+
75
+ ```
76
+ Blue → White → Red → Yellow → Black → Green → Blue
77
+ ```
78
+
79
+ Starting and ending with Blue provides process framing.
80
+
81
+ ## AI Execution Notes
82
+
83
+ 1. **Keep each hat brief** — 1-2 sentences per hat for rapid analysis, 1 paragraph for deep analysis
84
+ 2. **Wear one hat at a time** — don't mix perspectives within a hat section
85
+ 3. **Yellow before Black** — always find value before finding faults
86
+ 4. **Green is where extension happens** — this is where "this idea could be better if..." lives
87
+ 5. **Red Hat requires genuine pause** — don't rush past feelings to get to logic
@@ -0,0 +1,81 @@
1
+ ---
2
+ session: {{session_id}}
3
+ topic: "{{topic}}"
4
+ phase: flame
5
+ created: {{created}}
6
+ ideas_evaluated: {{ideas_evaluated}}
7
+ shortlist_count: {{shortlist_count}}
8
+ scoring_method: {{scoring_method}}
9
+ ---
10
+
11
+ # Flame Report: {{topic}}
12
+
13
+ > {{ideas_evaluated}} ideas evaluated. {{shortlist_count}} shortlisted for Forge.
14
+
15
+ ---
16
+
17
+ ## Shortlist
18
+
19
+ {{#each shortlist}}
20
+ ### {{rank}}. {{title}} ({{original_id}})
21
+
22
+ **Impact**: {{impact}}/5 | **Feasibility**: {{feasibility}}/5 | **Novelty**: {{novelty}}/5
23
+ **Composite Score**: {{composite}}/5
24
+
25
+ {{summary}}
26
+
27
+ **Why shortlisted**: {{rationale}}
28
+
29
+ {{/each}}
30
+
31
+ ---
32
+
33
+ ## Impact × Feasibility Matrix
34
+
35
+ ```
36
+ HIGH IMPACT
37
+
38
+ {{#each quadrants.quick_wins}} {{title}} ({{impact}},{{feasibility}})
39
+ {{/each}} │
40
+ {{#each quadrants.big_bets}} {{title}} ({{impact}},{{feasibility}})
41
+ {{/each}} │
42
+ ──────────────┼──────────────
43
+
44
+ LOW IMPACT
45
+ HIGH FEASIBILITY ← → LOW FEASIBILITY
46
+ ```
47
+
48
+ ---
49
+
50
+ ## Six Hats Analysis
51
+
52
+ {{#each evaluated_ideas}}
53
+ ### {{title}} ({{original_id}})
54
+
55
+ | Hat | Perspective |
56
+ |-----|------------|
57
+ | White (Facts) | {{white}} |
58
+ | Red (Feelings) | {{red}} |
59
+ | Yellow (Benefits) | {{yellow}} |
60
+ | Black (Risks) | {{black}} |
61
+ | Green (Creative) | {{green}} |
62
+ | Blue (Process) | {{blue}} |
63
+
64
+ **Scores**: Impact {{impact}}/5 · Feasibility {{feasibility}}/5 · Novelty {{novelty}}/5
65
+
66
+ ---
67
+
68
+ {{/each}}
69
+
70
+ ## Evaluation Summary
71
+
72
+ - **Total evaluated**: {{ideas_evaluated}}
73
+ - **Shortlisted**: {{shortlist_count}}
74
+ - **Scoring method**: {{scoring_method}}
75
+ - **Highest impact**: {{highest_impact}}
76
+ - **Most feasible**: {{most_feasible}}
77
+ - **Most novel**: {{most_novel}}
78
+
79
+ ---
80
+
81
+ *Generated by specsmd Ideation Flow — Flame skill*