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

package/flows/ideation/agents/orchestrator/skills/forge/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: forge
+description: Shape top ideas into actionable concept briefs using Disney Strategy — Dream, Reality, Critique.
+version: 1.0.0
+---
+
+<objective>
+Develop shortlisted ideas into polished, actionable concept briefs. AI and user co-build through the Disney Creative Strategy.
+</objective>
+
+<triggers>
+  - Flame Report generated with shortlisted ideas
+  - User provides ideas directly for shaping
+  - Orchestrator routes to Forge
+  - User invokes `/specsmd-forge`
+</triggers>
+
+<degrees_of_freedom>
+  **MEDIUM-LOW** — Structured shaping with high co-build ratio. User and AI refine together.
+</degrees_of_freedom>
+
+<llm critical="true">
+  <mandate>ALWAYS apply Disney Strategy in sequence: Dreamer → Realist → Critic</mandate>
+  <mandate>NEVER mix phases — keep Dreamer, Realist, and Critic strictly separate</mandate>
+  <mandate>ALWAYS involve user in Critic phase — this is the primary co-build moment</mandate>
+  <mandate>NEVER produce a Concept Brief without user validation of the core concept</mandate>
+  <mandate>ALWAYS make Concept Briefs polished enough to share in a meeting</mandate>
+</llm>
+
+<protocols>
+  - `.specsmd/ideation/shared/protocols/interaction-adaptation.md` — Generate:40% / Elicit:20% / Co-build:40%
+  - `.specsmd/ideation/shared/protocols/diverge-converge.md` — Alternating diverge-converge (Disney pattern)
+</protocols>
+
+<references>
+  - `references/disney-method.md` — Disney Creative Strategy for AI execution
+  - `references/pitch-framework.md` — Concept structuring and pitch patterns
+</references>
+
+<flow>
+  <step n="1" title="Load Top Ideas">
+    <check if="Flame Report exists in session">
+      <action>Load shortlisted ideas from flame-report.md</action>
+      <action>Present the shortlist: "Here are your top ideas. Which one shall we shape first?"</action>
+    </check>
+    <check if="user provides ideas directly">
+      <action>Accept ideas as input</action>
+    </check>
+    <check if="no ideas available">
+      <ask>Which ideas would you like to develop into full concepts?</ask>
+    </check>
+    <action>Select one idea to forge at a time (depth over breadth)</action>
+  </step>
+
+  <step n="2" title="Dreamer Pass">
+    <action>Enter Dreamer mode — pure possibility, no limits</action>
+    <output>
+      Signal the mode: "Let's dream big first — no limits, no criticism, just possibility."
+    </output>
+    <action>Expand the idea with:</action>
+    <dreamer>
+      - What's the most ambitious version of this?
+      - What would it look like if everything went perfectly?
+      - What adjacent possibilities does this unlock?
+      - What would make users absolutely love this?
+      - How could this grow beyond its initial scope?
+    </dreamer>
+    <action>Present the expanded vision (3-5 paragraphs)</action>
+    <action>Invite user additions: "What else would you dream for this?"</action>
+  </step>
+
+  <step n="3" title="Realist Pass">
+    <action>Enter Realist mode — practical implementation thinking</action>
+    <output>
+      Signal the mode: "Now let's get practical. How would this actually work?"
+    </output>
+    <action>Ground the dream with:</action>
+    <realist>
+      - What are the core components needed?
+      - What's the simplest version that still delivers the magic?
+      - What resources are required (time, money, skills, technology)?
+      - What's the implementation sequence?
+      - What existing solutions or tools can be leveraged?
+      - What's the timeline from start to first value?
+    </realist>
+    <action>Present a practical breakdown</action>
+    <action>Ask: "Does this implementation path make sense? What would you adjust?"</action>
+  </step>
+
+  <step n="4" title="Critic Pass (Co-build)">
+    <action>Enter Critic mode — constructive stress-testing</action>
+    <output>
+      Signal the mode: "Time to stress-test. Let's find the weak spots — and fix them."
+    </output>
+    <action>Present AI's concerns:</action>
+    <critic>
+      - What's the biggest risk?
+      - What assumption is most likely wrong?
+      - What would a skeptic say?
+      - Where could this fail?
+      - What's the competitive response?
+    </critic>
+    <ask>What concerns you most about this concept? What feels risky?</ask>
+    <action>For each concern (AI's and user's), co-develop a mitigation:</action>
+    <format>
+      **Concern**: {concern}
+      **Mitigation**: {proposed mitigation}
+    </format>
+    <action>Iterate until user is satisfied with mitigations</action>
+  </step>
+
+  <step n="5" title="Generate Concept Brief">
+    <action>Synthesize Dreamer + Realist + Critic into a polished Concept Brief</action>
+    <action>Generate using template: templates/concept-brief.md.hbs</action>
+    <action>Present the brief to user for final review</action>
+    <ask>How does this look? Any final adjustments?</ask>
+    <action>Save to: .specs-ideation/sessions/{session-id}/concept-briefs/{concept-name}.md</action>
+    <action>Update session.yaml: track concept brief</action>
+    <check if="more shortlisted ideas to forge">
+      <ask>Ready to shape the next idea?</ask>
+      <action>If yes, return to step 1 with next idea</action>
+    </check>
+    <check if="all ideas shaped">
+      <action>Update session.yaml: phase → "complete"</action>
+      <output>
+        Your ideation session is complete!
+
+        **Created**:
+        - Spark Bank: {N} ideas generated
+        - Flame Report: {M} ideas evaluated, {K} shortlisted
+        - Concept Briefs: {B} concepts shaped
+
+        All artifacts saved in .specs-ideation/sessions/{session-id}/
+      </output>
+    </check>
+  </step>
+</flow>
+
+<output_artifacts>
+
+  | Artifact | Location | Template |
+  |----------|----------|----------|
+  | Concept Brief | `.specs-ideation/sessions/{id}/concept-briefs/{name}.md` | `./templates/concept-brief.md.hbs` |
+</output_artifacts>
+
+<success_criteria>
+  <criterion>Disney Strategy applied in strict sequence: Dreamer → Realist → Critic</criterion>
+  <criterion>User actively involved in Critic phase (co-build)</criterion>
+  <criterion>Concept Brief is polished enough to share in a meeting</criterion>
+  <criterion>Risks identified AND mitigated (not just listed)</criterion>
+  <criterion>Clear next steps included in every brief</criterion>
+  <criterion>Session state updated and all artifacts saved</criterion>
+</success_criteria>

package/flows/ideation/agents/orchestrator/skills/forge/references/disney-method.md

@@ -0,0 +1,94 @@
+# Disney Creative Strategy
+
+**Origin**: Modeled after Walt Disney's creative process by Robert Dilts (1994). Disney reportedly used three distinct "rooms" for thinking: the Dreamer room, the Realist room, and the Critic room.
+
+## Core Concept
+
+The same idea is examined through three completely separate lenses, in sequence. The key insight is **strict separation** — you never dream and critique simultaneously.
+
+## The Three Roles
+
+### The Dreamer
+
+- **Mindset**: "Anything is possible"
+- **Perspective**: User/visionary — what would be amazing?
+- **Time horizon**: Infinite
+- **Constraints**: None
+- **Question**: "If we could do anything, what would this look like?"
+
+**AI behavior in Dreamer mode**:
+
+- Generate the most ambitious version of the idea
+- No "but" or "however" — pure expansion
+- Think about the emotional impact on users
+- Explore adjacent possibilities and long-term potential
+- Use vivid, exciting language
+
+### The Realist
+
+- **Mindset**: "How would this actually work?"
+- **Perspective**: Project manager/engineer — what's the plan?
+- **Time horizon**: 3-12 months
+- **Constraints**: Resources, technology, time
+- **Question**: "What needs to be true for this to work?"
+
+**AI behavior in Realist mode**:
+
+- Break the dream into concrete components
+- Identify the minimum viable version
+- Map resources, skills, and technology needed
+- Propose an implementation sequence
+- Focus on what can be leveraged from existing work
+
+### The Critic
+
+- **Mindset**: "What could go wrong?"
+- **Perspective**: Quality assurance/risk analyst — what are the weak spots?
+- **Time horizon**: Full lifecycle
+- **Constraints**: Reality, competition, human nature
+- **Question**: "Why might this fail, and how do we prevent it?"
+
+**AI behavior in Critic mode**:
+
+- Identify genuine risks (not token concerns)
+- Challenge the weakest assumptions
+- Consider second-order effects and unintended consequences
+- For EACH criticism, propose a mitigation
+- The goal is to strengthen, not to kill
+
+## Sequencing Rules
+
+```
+Dreamer → Realist → Critic
+```
+
+1. **Always start with Dreamer** — establishes the vision before constraints appear
+2. **Realist grounds the dream** — but doesn't shrink it, just makes it buildable
+3. **Critic strengthens** — finds weaknesses AND fixes them
+4. **Optional loop**: If Critic reveals fundamental issues → mini Dreamer pass to re-envision → Realist → Critic again
+
+## Co-build Integration
+
+The Forge skill uses Disney Strategy with a co-build emphasis:
+
+| Phase | AI Role | User Role |
+|-------|---------|-----------|
+| **Dreamer** | AI expands (generates 70%) | User adds aspirations (30%) |
+| **Realist** | AI structures (generates 60%) | User validates and adjusts (40%) |
+| **Critic** | AI raises concerns (generates 40%) | User identifies personal concerns and co-develops mitigations (60%) |
+
+The Critic phase has the highest user involvement because:
+
+- Users know their context, stakeholders, and politics better than AI
+- Risk assessment requires domain-specific knowledge
+- Co-developing mitigations builds ownership and confidence
+
+## Anti-Pattern: The Premature Critic
+
+The most common failure mode is jumping to critique too early. Signals:
+
+- "That won't work because..." (before the idea is fully developed)
+- "But what about..." (during Dreamer phase)
+- Listing constraints before exploring possibilities
+
+**Mitigation**: Explicitly signal phase transitions. "We're in Dreamer mode — no limits yet. We'll stress-test in a moment."

package/flows/ideation/agents/orchestrator/skills/forge/references/pitch-framework.md

@@ -0,0 +1,87 @@
+# Pitch Framework
+
+Structures for presenting concepts clearly and persuasively. Used when generating Concept Briefs.
+
+## Concept Brief Structure
+
+Every Concept Brief follows this structure:
+
+### 1. One-Liner
+
+A single sentence that captures the essence. If you can't say it in one sentence, the concept isn't clear enough.
+
+**Formula**: [Action] + [for whom] + [unique mechanism] + [key benefit]
+
+**Examples**:
+
+- "A quest-based onboarding system that turns new hire setup into a game, cutting time-to-productivity by 60%."
+- "A reverse mentoring platform where junior employees teach executives about emerging tech, building cross-generational understanding."
+
+### 2. Problem
+
+What pain exists today? Be specific and vivid.
+
+**Formula**: [Who] + [experiences what pain] + [how often/severely] + [what it costs them]
+
+### 3. Concept
+
+How does this solve the problem? What's the mechanism?
+
+**Elements**:
+
+- Core mechanism (how it works)
+- Key differentiator (why this approach vs. others)
+- User experience (what does the user see/feel/do?)
+
+### 4. Why It Works
+
+What makes this concept compelling? Why will it succeed?
+
+**Types of evidence**:
+
+- Analogies that have worked elsewhere
+- Research or data that supports the approach
+- First-principles reasoning
+- User psychology insights
+
+### 5. Risks & Mitigations
+
+What could go wrong, and what's the plan?
+
+**Format per risk**:
+
+- **Risk**: {what could go wrong}
+- **Likelihood**: Low / Medium / High
+- **Impact**: Low / Medium / High
+- **Mitigation**: {specific action to prevent or address}
+
+### 6. Next Steps
+
+What would you do first to move this forward?
+
+**Good next steps are**:
+
+- Specific (not "do more research")
+- Actionable (can be started this week)
+- Time-bounded (has a deadline or milestone)
+- Testable (you'll know if it worked)
+
+## Pitch Principles
+
+### Specificity Over Abstraction
+
+- Bad: "Leverage gamification to improve engagement"
+- Good: "A quest system where each completed onboarding task unlocks a new tool, with a leaderboard showing progress vs. cohort average"
+
+### Show, Don't Categorize
+
+- Bad: "This is a B2B SaaS solution for the enterprise market"
+- Good: "When a new VP of Engineering joins, they open their laptop and see a personalized roadmap..."
+
+### One Problem, One Solution
+
+Each concept brief tackles one clear problem. If there are multiple problems, make multiple briefs.
+
+### The "Tell a Friend" Test
+
+The one-liner should be something someone would actually say to a colleague: "Hey, have you heard about this thing that [one-liner]?"

package/flows/ideation/agents/orchestrator/skills/forge/templates/concept-brief.md.hbs

@@ -0,0 +1,83 @@
+---
+session: {{session_id}}
+topic: "{{topic}}"
+concept: "{{concept_name}}"
+phase: forge
+created: {{created}}
+origin_idea: {{origin_idea_id}}
+impact: {{impact}}
+feasibility: {{feasibility}}
+---
+
+# Concept Brief: {{concept_title}}
+
+> {{one_liner}}
+
+---
+
+## Problem
+
+{{problem}}
+
+---
+
+## Concept
+
+{{concept_description}}
+
+{{#if key_differentiator}}
+**Key differentiator**: {{key_differentiator}}
+{{/if}}
+
+{{#if user_experience}}
+### User Experience
+
+{{user_experience}}
+{{/if}}
+
+---
+
+## Why It Works
+
+{{#each reasons}}
+- {{this}}
+{{/each}}
+
+---
+
+## Risks & Mitigations
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+{{#each risks}}
+| {{risk}} | {{likelihood}} | {{impact}} | {{mitigation}} |
+{{/each}}
+
+---
+
+## Next Steps
+
+{{#each next_steps}}
+{{@index_1}}. **{{title}}** — {{description}}{{#if timeline}} *({{timeline}})*{{/if}}
+{{/each}}
+
+---
+
+## Development Notes
+
+### Dreamer Vision
+
+{{dreamer_summary}}
+
+### Realist Plan
+
+{{realist_summary}}
+
+### Critic Refinements
+
+{{critic_summary}}
+
+---
+
+*Generated by specsmd Ideation Flow — Forge skill*
+*Origin: {{origin_idea_id}} from Spark Bank*

package/flows/ideation/agents/orchestrator/skills/spark/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: spark
+description: Rapid idea generation with cross-domain diversity, anti-bias enforcement, and deep thinking.
+version: 1.0.0
+---
+
+<objective>
+Generate genuinely diverse, surprising ideas through rapid batches. AI is the creative partner — user reacts and steers.
+</objective>
+
+<triggers>
+  - User provides a topic for ideation
+  - Orchestrator routes to Spark
+  - User invokes `/specsmd-spark`
+</triggers>
+
+<degrees_of_freedom>
+  **MAXIMUM** — This is pure creative divergence. Go wide. Go weird. Cross domains. Surprise the user.
+</degrees_of_freedom>
+
+<llm critical="true">
+  <mandate>NEVER ask setup questions — generate ideas immediately on receiving a topic</mandate>
+  <mandate>SHOW which technique was used for each idea — e.g., "(via Inversion)" or "(via First Principles)" — so the user understands the thinking approach</mandate>
+  <mandate>ALWAYS use the deep thinking protocol before generating each batch</mandate>
+  <mandate>ALWAYS present ideas as vivid, specific, memorable concepts — not abstract descriptions</mandate>
+  <mandate>NEVER more than 2 questions in a row — always generate something creative first</mandate>
+  <mandate>ANTI-BIAS — MATCH DIVERSITY TO TOPIC TYPE:
+    - For OPEN/CREATIVE topics (product ideas, business concepts, experiences): use the domain wheel aggressively — 3+ different domains per batch, cross-domain metaphors welcome
+    - For TECHNICAL/ARCHITECTURAL topics (system design, integration decisions, API design): diversity means different PERSPECTIVES and ANGLES on the same technical space — architecture, developer experience, tradeoffs, migration strategy, patterns from other systems. Do NOT force nature/art/games metaphors onto technical decisions. The ideas should feel like they came from 5 different senior engineers, not 5 different departments.
+    - When in doubt, match the user's register. If they're talking code, give them code-level ideas.
+  </mandate>
+</llm>
+
+<protocols>
+  Read these shared protocols before generating:
+  - `.specsmd/ideation/shared/protocols/anti-bias.md` — Domain wheel, diversity enforcement
+  - `.specsmd/ideation/shared/protocols/deep-thinking.md` — Multi-step reasoning per batch
+  - `.specsmd/ideation/shared/protocols/interaction-adaptation.md` — Generate/elicit/co-build rules
+  - `.specsmd/ideation/shared/protocols/diverge-converge.md` — Osborn-Parnes dual thinking
+</protocols>
+
+<references>
+  Technique references for internal use (never expose technique names to user):
+  - `references/techniques/index.yaml` — Technique metadata and interaction types
+  - `references/techniques/scamper.md` — Substitute, Combine, Adapt, Modify, Put to other use, Eliminate, Reverse
+  - `references/techniques/random-word.md` — Random stimulus for forced connections
+  - `references/techniques/what-if.md` — Assumption challenging scenarios
+  - `references/techniques/inversion.md` — Reverse assumptions, opposite thinking
+  - `references/techniques/analogy.md` — Cross-domain pattern mapping
+  - `references/techniques/first-principles.md` — Decompose to fundamentals, rebuild
+  - `references/techniques/questorming.md` — Generate questions instead of answers
+  - `references/anti-bias.md` — Domain wheel and provocation types
+</references>
+
+<flow>
+  <step n="1" title="Receive Topic">
+    <check if="topic provided">
+      <action>Accept topic, proceed immediately to step 2</action>
+    </check>
+    <check if="no topic">
+      <ask>What would you like to explore ideas about?</ask>
+      <action>On response, proceed to step 2</action>
+    </check>
+    <critical>Zero friction. Do NOT ask clarifying questions before generating the first batch.</critical>
+  </step>
+
+  <step n="2" title="Deep Thinking">
+    <action>Execute the deep thinking protocol (see shared/protocols/deep-thinking.md)</action>
+    <action>Perform 6-step reasoning chain:</action>
+    <reasoning>
+      [Think 1 — Angle Check]: What topic type is this? For creative/open topics, pick 3+ domain wheel sectors. For technical topics, pick 3+ different perspectives (architecture, DX, tradeoffs, patterns, prior art, migration, cost). Either way, ensure the batch won't feel repetitive.
+      [Think 2 — Raw Concepts]: Generate raw ideas — one per selected angle. Use techniques internally (SCAMPER, analogy, inversion, first-principles, etc.) but keep ideas grounded in the user's actual domain.
+      [Think 3 — Novelty Filter]: Are these genuinely new or just repackaged versions of obvious ideas? Replace any that feel generic.
+      [Think 4 — Cross-pollinate]: Can any ideas combine with user's stated favorites? Create unexpected connections.
+      [Think 5 — Provocation]: If provocation is due (every 15 ideas), inject one deliberately unconventional idea. Otherwise, ensure at least one idea challenges assumptions.
+      [Think 6 — Polish]: Make each idea vivid, specific, and memorable. Match the user's register — if they're talking about code, give them code-level specificity, not abstract metaphors.
+    </reasoning>
+  </step>
+
+  <step n="3" title="Generate Spark Batch">
+    <action>Present batch of 5 ideas, each with:</action>
+    <format>
+      **S{batch}-{number}** — {vivid idea title}
+      {2-3 sentence description — specific, concrete, imaginative}
+      *(technique: {technique used, e.g., Inversion, First Principles, SCAMPER, Analogy})*
+    </format>
+    <action>Number ideas sequentially across batches (S1-1, S1-2... S2-1, S2-2...)</action>
+    <anti_bias>
+      BEFORE presenting the batch, verify diversity:
+      - For creative/open topics: 3+ different domain wheel sectors
+      - For technical topics: 3+ different perspectives (e.g., architecture, DX, tradeoffs, patterns, migration)
+      - No 2 consecutive ideas making the same argument from the same angle
+    </anti_bias>
+  </step>
+
+  <step n="4" title="Collect Reactions">
+    <action>After presenting batch, invite reaction with a light prompt:</action>
+    <examples>
+      - "What catches your eye? Or say 'more' for another batch."
+      - "Pick favorites, ask for 'wilder', or tell me a direction."
+      - "Any of these spark something? I can go deeper on any."
+    </examples>
+    <action>Track user favorites in session state</action>
+  </step>
+
+  <step n="5" title="Adapt and Repeat">
+    <action>Based on user reaction, adapt the next batch:</action>
+    <adaptation>
+      <if reaction="picked favorites">Explore adjacent spaces to favorites, but maintain domain diversity</if>
+      <if reaction="'more' or 'keep going'">New batch with fresh domains and techniques</if>
+      <if reaction="'wilder' or 'more creative'">Increase provocation frequency, use inversion and what-if techniques</if>
+      <if reaction="'more like #N'">Analyze what makes #N appealing, generate variations while maintaining diversity</if>
+      <if reaction="'more practical' or 'realistic'">Ground ideas more, but still span domains</if>
+      <if reaction="provides new constraint or context">Incorporate as filter, regenerate</if>
+      <if reaction="'enough' or 'done' or 'that's good'">Proceed to step 6</if>
+    </adaptation>
+    <action>Return to step 2 for next batch</action>
+    <check if="total ideas >= target_count (50) AND not explicitly asked for more">
+      <action>Suggest: "We've generated {N} ideas. Ready to evaluate the best ones? Or keep going?"</action>
+    </check>
+  </step>
+
+  <step n="6" title="Generate Spark Bank">
+    <action>Compile all ideas into a Spark Bank document using template: templates/spark-bank.md.hbs</action>
+    <action>Organize by theme (cluster related ideas)</action>
+    <action>Highlight user favorites</action>
+    <action>Include domain coverage summary</action>
+    <action>Save to: .specs-ideation/sessions/{session-id}/spark-bank.md</action>
+    <action>Update session.yaml: phase → "spark-complete", track stats</action>
+    <transition>
+      Suggest moving to Flame: "Your Spark Bank has {N} ideas ({F} favorites). Ready to evaluate them?"
+      If yes → invoke Flame skill
+    </transition>
+  </step>
+</flow>
+
+<output_artifacts>
+
+  | Artifact | Location | Template |
+  |----------|----------|----------|
+  | Spark Bank | `.specs-ideation/sessions/{id}/spark-bank.md` | `./templates/spark-bank.md.hbs` |
+</output_artifacts>
+
+<success_criteria>
+  <criterion>First batch of ideas delivered within 30 seconds of receiving topic</criterion>
+  <criterion>Every batch spans 3+ different domains from the domain wheel</criterion>
+  <criterion>Ideas are vivid, specific, and memorable — not abstract or generic</criterion>
+  <criterion>Deep thinking protocol executed for every batch</criterion>
+  <criterion>User favorites tracked and influence subsequent batches</criterion>
+  <criterion>Provocations injected at configured frequency</criterion>
+  <criterion>Spark Bank is polished, organized by theme, and immediately shareable</criterion>
+</success_criteria>

package/flows/ideation/agents/orchestrator/skills/spark/references/anti-bias.md

@@ -0,0 +1,43 @@
+# Anti-Bias Reference (Spark Skill)
+
+Quick reference for the anti-bias engine during idea generation. See `shared/protocols/anti-bias.md` for the full protocol.
+
+## Domain Wheel (12 Sectors)
+
+| # | Domain | Example Application |
+|---|--------|-------------------|
+| 1 | Technology/Engineering | Systems, algorithms, automation, tools |
+| 2 | Human Psychology/Behavior | Motivation, habits, cognition, emotion |
+| 3 | Business/Economics | Markets, incentives, pricing, value chains |
+| 4 | Nature/Biology | Ecosystems, evolution, biomimicry, growth |
+| 5 | Art/Design/Aesthetics | Form, beauty, expression, experience |
+| 6 | Games/Play | Competition, rules, progression, fun |
+| 7 | Social/Community | Networks, culture, belonging, collaboration |
+| 8 | Physical Space/Architecture | Layout, flow, wayfinding, environment |
+| 9 | Time/Temporal | Timing, rhythm, duration, history, future |
+| 10 | Extreme/Edge Cases | Exceptions, outliers, extremes, limits |
+| 11 | Inversion/Opposite | Reversal, contradiction, opposite approach |
+| 12 | Random Cross-Pollination | Unrelated connections, serendipity |
+
+## Per-Batch Rules
+
+- Each batch of 5 ideas MUST include 3+ different domains
+- Never 2 consecutive ideas from the same domain
+- Prioritize underused domains (track usage in session state)
+- If user favorites cluster in one domain, deliberately diversify next batch
+
+## Provocation Schedule
+
+- Every 15 ideas: inject 1 deliberately absurd/provocative idea
+- Every 20 ideas: shift perspective entirely
+
+## Provocation Types
+
+| Type | Description |
+|------|-------------|
+| Inversion | What if the opposite were true? |
+| Exaggeration | What if 1000x bigger/smaller? |
+| Elimination | Remove the core assumption entirely |
+| Random | Force connection with unrelated concept |
+| Time shift | 100 years ago or from now |
+| Stakeholder swap | Designed for a completely different user |

package/flows/ideation/agents/orchestrator/skills/spark/references/techniques/analogy.md

@@ -0,0 +1,60 @@
+# Cross-Domain Analogy Technique
+
+**Origin**: Synectics (William Gordon, 1961); also central to Osborn's *Applied Imagination* approach of "What else is like this?"
+
+**Interaction type**: Generate — AI finds analogous problems in distant domains and adapts solutions.
+
+## How It Works
+
+1. **Abstract the problem** — strip away domain-specific details to find the core challenge
+2. **Find analogous problems** in distant domains that share the same core challenge
+3. **Study how those domains solve it** — what mechanisms, patterns, or principles do they use?
+4. **Transfer the solution** back to the original domain, adapting as needed
+
+## Analogy Sources
+
+### Nature (Biomimicry)
+
+- How does nature solve similar problems?
+- Velcro from burrs, bullet trains from kingfisher beaks, self-healing materials from skin
+- Best for: structural, efficiency, and resilience problems
+
+### Games & Sports
+
+- How do games create engagement, manage competition, handle fairness?
+- Matchmaking, progression systems, handicaps, spectator modes
+- Best for: engagement, fairness, and motivation problems
+
+### Architecture & Urban Planning
+
+- How do cities manage flow, density, growth, safety?
+- Zoning, traffic patterns, public spaces, wayfinding
+- Best for: scale, navigation, and organization problems
+
+### Music & Performance
+
+- How do musicians create tension, resolution, improvisation, collaboration?
+- Call-and-response, crescendo, variations on a theme
+- Best for: experience design, pacing, and collaboration problems
+
+### History & Civilization
+
+- How did past civilizations solve similar problems?
+- Trade routes, governance, knowledge preservation, cultural transmission
+- Best for: communication, governance, and knowledge problems
+
+### Medicine & Biology
+
+- How does the body handle similar challenges?
+- Immune system (threats), nervous system (signals), circulatory system (distribution)
+- Best for: security, communication, and distribution problems
+
+## AI Application Notes
+
+When using analogy internally:
+
+1. Abstract the topic to its core challenge (e.g., "reduce onboarding time" → "accelerate knowledge transfer")
+2. Pick 2-3 distant domains from the list above
+3. Find genuine analogies (not surface-level similarities)
+4. The transfer should produce ideas the user wouldn't have thought of
+5. Present the ideas with just enough analogy context to make them vivid — not an essay on the source domain