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.
- package/README.md +190 -224
- package/bin/cli.js +28 -1
- package/flows/aidlc/commands/construction-agent.md +5 -1
- package/flows/aidlc/commands/inception-agent.md +4 -0
- package/flows/aidlc/commands/master-agent.md +4 -0
- package/flows/aidlc/commands/operations-agent.md +4 -0
- package/flows/aidlc/memory-bank.yaml +2 -1
- package/{scripts/artifact-validator.js → flows/aidlc/scripts/artifact-validator.cjs} +3 -3
- package/{scripts/bolt-complete.js → flows/aidlc/scripts/bolt-complete.cjs} +36 -5
- package/{scripts/status-integrity.js → flows/aidlc/scripts/status-integrity.cjs} +5 -5
- package/flows/aidlc/skills/construction/bolt-list.md +1 -1
- package/flows/aidlc/skills/construction/bolt-start.md +3 -3
- package/flows/aidlc/skills/construction/bolt-status.md +1 -1
- package/flows/aidlc/skills/construction/prototype-apply.md +311 -0
- package/flows/aidlc/skills/inception/vibe-to-spec.md +410 -0
- package/flows/aidlc/skills/master/analyze-context.md +1 -1
- package/flows/aidlc/templates/construction/bolt-template.md +2 -2
- package/flows/aidlc/templates/construction/bolt-types/ddd-construction-bolt.md +73 -11
- package/flows/aidlc/templates/standards/decision-index-template.md +32 -0
- package/flows/fire/README.md +19 -0
- package/flows/fire/agents/builder/agent.md +260 -0
- package/flows/fire/agents/builder/skills/code-review/SKILL.md +257 -0
- package/flows/fire/agents/builder/skills/code-review/references/auto-fix-rules.md +218 -0
- package/flows/fire/agents/builder/skills/code-review/references/review-categories.md +154 -0
- package/flows/fire/agents/builder/skills/code-review/templates/review-report.md.hbs +120 -0
- package/flows/fire/agents/builder/skills/run-execute/SKILL.md +714 -0
- package/flows/fire/agents/builder/skills/run-execute/scripts/complete-run.cjs +800 -0
- package/flows/fire/agents/builder/skills/run-execute/scripts/init-run.cjs +500 -0
- package/flows/fire/agents/builder/skills/run-execute/scripts/update-checkpoint.cjs +254 -0
- package/flows/fire/agents/builder/skills/run-execute/scripts/update-phase.cjs +250 -0
- package/flows/fire/agents/builder/skills/run-execute/templates/plan.md.hbs +61 -0
- package/flows/fire/agents/builder/skills/run-execute/templates/test-report.md.hbs +81 -0
- package/flows/fire/agents/builder/skills/run-plan/SKILL.md +378 -0
- package/flows/fire/agents/builder/skills/run-status/SKILL.md +96 -0
- package/flows/fire/agents/builder/skills/walkthrough-generate/SKILL.md +267 -0
- package/flows/fire/agents/builder/skills/walkthrough-generate/templates/walkthrough.md.hbs +176 -0
- package/flows/fire/agents/orchestrator/agent.md +144 -0
- package/flows/fire/agents/orchestrator/skills/project-init/SKILL.md +226 -0
- package/flows/fire/agents/orchestrator/skills/project-init/templates/coding-standards.md.hbs +149 -0
- package/flows/fire/agents/orchestrator/skills/project-init/templates/constitution.md.hbs +43 -0
- package/flows/fire/agents/orchestrator/skills/project-init/templates/system-architecture.md.hbs +101 -0
- package/flows/fire/agents/orchestrator/skills/project-init/templates/tech-stack.md.hbs +136 -0
- package/flows/fire/agents/orchestrator/skills/project-init/templates/testing-standards.md.hbs +94 -0
- package/flows/fire/agents/orchestrator/skills/route/SKILL.md +146 -0
- package/flows/fire/agents/orchestrator/skills/status/SKILL.md +696 -0
- package/flows/fire/agents/planner/agent.md +143 -0
- package/flows/fire/agents/planner/skills/design-doc-generate/SKILL.md +156 -0
- package/flows/fire/agents/planner/skills/design-doc-generate/templates/design.md.hbs +124 -0
- package/flows/fire/agents/planner/skills/intent-capture/SKILL.md +125 -0
- package/flows/fire/agents/planner/skills/intent-capture/templates/brief.md.hbs +40 -0
- package/flows/fire/agents/planner/skills/work-item-decompose/SKILL.md +166 -0
- package/flows/fire/agents/planner/skills/work-item-decompose/templates/work-item.md.hbs +40 -0
- package/flows/fire/commands/fire-builder.md +56 -0
- package/flows/fire/commands/fire-planner.md +48 -0
- package/flows/fire/commands/fire.md +46 -0
- package/flows/fire/memory-bank.yaml +240 -0
- package/flows/fire/quick-start.md +146 -0
- package/flows/ideation/README.md +35 -0
- package/flows/ideation/agents/orchestrator/agent.md +103 -0
- package/flows/ideation/agents/orchestrator/skills/flame/SKILL.md +132 -0
- package/flows/ideation/agents/orchestrator/skills/flame/references/evaluation-criteria.md +81 -0
- package/flows/ideation/agents/orchestrator/skills/flame/references/six-hats-method.md +87 -0
- package/flows/ideation/agents/orchestrator/skills/flame/templates/flame-report.md.hbs +81 -0
- package/flows/ideation/agents/orchestrator/skills/forge/SKILL.md +153 -0
- package/flows/ideation/agents/orchestrator/skills/forge/references/disney-method.md +94 -0
- package/flows/ideation/agents/orchestrator/skills/forge/references/pitch-framework.md +87 -0
- package/flows/ideation/agents/orchestrator/skills/forge/templates/concept-brief.md.hbs +83 -0
- package/flows/ideation/agents/orchestrator/skills/spark/SKILL.md +152 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/anti-bias.md +43 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/analogy.md +60 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/first-principles.md +56 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/index.yaml +76 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/inversion.md +52 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/questorming.md +57 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/random-word.md +35 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/scamper.md +67 -0
- package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/what-if.md +55 -0
- package/flows/ideation/agents/orchestrator/skills/spark/templates/spark-bank.md.hbs +72 -0
- package/flows/ideation/commands/flame.md +43 -0
- package/flows/ideation/commands/forge.md +43 -0
- package/flows/ideation/commands/ideation.md +51 -0
- package/flows/ideation/commands/spark.md +43 -0
- package/flows/ideation/memory-bank.yaml +177 -0
- package/flows/ideation/quick-start.md +84 -0
- package/flows/ideation/shared/protocols/anti-bias.md +79 -0
- package/flows/ideation/shared/protocols/deep-thinking.md +92 -0
- package/flows/ideation/shared/protocols/diverge-converge.md +72 -0
- package/flows/ideation/shared/protocols/interaction-adaptation.md +88 -0
- package/flows/simple/README.md +190 -0
- package/flows/simple/agents/agent.md +404 -0
- package/flows/simple/commands/agent.md +60 -0
- package/flows/simple/context-config.yaml +34 -0
- package/flows/simple/memory-bank.yaml +66 -0
- package/flows/simple/quick-start.md +231 -0
- package/flows/simple/skills/design.md +96 -0
- package/flows/simple/skills/execute.md +190 -0
- package/flows/simple/skills/requirements.md +94 -0
- package/flows/simple/skills/tasks.md +136 -0
- package/flows/simple/templates/design-template.md +138 -0
- package/flows/simple/templates/requirements-template.md +85 -0
- package/flows/simple/templates/tasks-template.md +104 -0
- package/lib/analytics/tracker.js +6 -2
- package/lib/constants.js +25 -8
- package/lib/dashboard/aidlc/parser.js +581 -0
- package/lib/dashboard/fire/model.js +382 -0
- package/lib/dashboard/fire/parser.js +470 -0
- package/lib/dashboard/flow-detect.js +86 -0
- package/lib/dashboard/git/changes.js +362 -0
- package/lib/dashboard/git/worktrees.js +248 -0
- package/lib/dashboard/index.js +709 -0
- package/lib/dashboard/runtime/watch-runtime.js +122 -0
- package/lib/dashboard/simple/parser.js +293 -0
- package/lib/dashboard/tui/app.js +1675 -0
- package/lib/dashboard/tui/components/error-banner.js +35 -0
- package/lib/dashboard/tui/components/header.js +60 -0
- package/lib/dashboard/tui/components/help-footer.js +15 -0
- package/lib/dashboard/tui/components/stats-strip.js +35 -0
- package/lib/dashboard/tui/file-entries.js +383 -0
- package/lib/dashboard/tui/flow-builders.js +991 -0
- package/lib/dashboard/tui/git-builders.js +218 -0
- package/lib/dashboard/tui/helpers.js +236 -0
- package/lib/dashboard/tui/overlays.js +242 -0
- package/lib/dashboard/tui/preview.js +220 -0
- package/lib/dashboard/tui/renderer.js +76 -0
- package/lib/dashboard/tui/row-builders.js +797 -0
- package/lib/dashboard/tui/sections.js +45 -0
- package/lib/dashboard/tui/store.js +44 -0
- package/lib/dashboard/tui/views/overview-view.js +61 -0
- package/lib/dashboard/tui/views/runs-view.js +93 -0
- package/lib/dashboard/tui/worktree-builders.js +229 -0
- package/lib/dashboard/web/extension-adapter.js +726 -0
- package/lib/dashboard/web/public/app.js +9 -0
- package/lib/dashboard/web/public/index.html +14 -0
- package/lib/dashboard/web/public/styles.css +36 -0
- package/lib/dashboard/web/public/webview-bundle.js +7596 -0
- package/lib/dashboard/web/server.js +376 -0
- package/lib/dashboard/web/snapshot.js +299 -0
- package/lib/installer.js +19 -15
- package/lib/installers/CodexInstaller.js +72 -1
- package/lib/installers/KiroInstaller.js +55 -0
- package/lib/installers/OpenCodeInstaller.js +9 -1
- package/lib/installers/ToolInstaller.js +4 -1
- package/lib/installers/WindsurfInstaller.js +0 -54
- package/package.json +15 -55
- package/scripts/check-webview-bundle-sync.cjs +38 -0
- 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*
|