| name | idea-darwin |
| version | 1.0.0 |
| emoji | 🧬 |
| homepage | https://github.com/warmskull/idea-darwin |
| description | Idea Darwin Engine — an automated idea iteration system that evolves raw ideas through structured competition and selection. Imports ideas from ideas.md, structures them into scored cards, then runs iterative rounds of deepening, derivation, crossbreeding, critique, and validation to surface high-potential ideas. Use /idea-darwin to trigger. This skill should also trigger whenever the user mentions "run a round", "iterate ideas", "idea pool", "idea scoring", "idea status", "brainstorm iteration", "evolve my ideas", "rank my ideas", or "idea pipeline". Even if the user doesn't explicitly say /idea-darwin, use this skill whenever the task involves structuring ideas from a file, scoring and ranking ideas, or running any kind of systematic idea iteration or selection process.
|
Idea Darwin Engine
A round-based idea iteration system that treats ideas as competing organisms — scoring, selecting, crossing, and evolving them through structured rounds to surface the strongest concepts.
The metaphor is Darwinian selection: ideas that score well survive and evolve; weak ideas get flagged for the user to decide on; crossbreeding produces novel offspring. This prevents the common failure mode of brainstorming where all ideas stay equally vague forever.
Commands
| Command | Description |
|---|
/idea-darwin init | Initialize: parse ideas.md, create directory structure, config, and initial cards (optional params below) |
/idea-darwin round | Execute the next iteration round |
/idea-darwin round N | Execute N consecutive rounds |
/idea-darwin status | View idea pool status and rankings |
/idea-darwin dormant IDEA-XXXX | Put a specific idea into dormancy |
/idea-darwin wake IDEA-XXXX | Wake a dormant idea |
/idea-darwin | No arguments: show brief status and suggest next step |
Arguments are extracted from $ARGUMENTS. If no arguments are provided, show current status and suggestions.
init Optional Parameters
| Parameter | Description | Default |
|---|
--budget <N> | Max ideas to process per round | 12 |
--actions <N> | Max actions per idea per round | 2 |
--disruption <N> | Introduce external stimulus every N rounds (disruption round) | 3 |
Example: /idea-darwin init --budget 8 --actions 3 --disruption 5
These parameters are written to config.yaml and can be manually edited later. Unspecified parameters use defaults.
File Structure
The system maintains this structure in the working directory (created during initialization):
project/
├── ideas.md # User's raw ideas (read-only — never modify this file)
├── config.yaml # System configuration and state
├── stimuli.md # External stimulus entries (user-editable, system read-only)
├── cards/ # Idea cards
│ ├── IDEA-0001.md
│ └── ...
├── rounds/ # Round reports
│ ├── round-000.md
│ └── ...
├── reports/ # Leaderboard and cluster reports
│ └── leaderboard.md
└── graph/ # Relationship graph
└── relations.json
Idea Numbering
- Format:
IDEA-XXXX (4-digit zero-padded, starting from 0001)
- Globally unique — numbers are never recycled, even for dormant or removed ideas
config.yaml tracks the next available number in next_idea_id- Each idea card records lineage via
parent_ids and child_ids
Idea State Machine
seed → exploring → refining → crossing → validated → dormant
| State | Meaning | Available Actions |
|---|
| seed | Just entered the pool | Tagging, card generation, deepen, quick cross-validation |
| exploring | Exploration phase | Deepen, derive, critique, preliminary cross |
| refining | Polishing phase | Logic reinforcement, feasibility analysis, risk check |
| crossing | High-cross phase | Merge with complementary ideas, evaluate fusion quality |
| validated | Verified | Output MVP plan, generate execution roadmap |
| dormant | Hibernating | Passive participation in cross and similarity matching only |
State transitions are recommended by the system based on scores and action results, but the user always has final say.
Scoring System
6 Scoring Dimensions (1–10 each)
| Dimension | Weight | Meaning |
|---|
| Novelty | 0.10 | Is there a genuine breakthrough, or just repetition? |
| Feasibility | 0.20 | Is this technically, resource-wise, and path-wise achievable? |
| Value | 0.20 | How much impact would this create if successful? |
| Logic | 0.20 | Is it internally consistent, with no obvious gaps? |
| CrossPotential | 0.10 | How likely is this to spark something new when combined with other ideas? |
| Verifiability | 0.20 | Can we design an experiment or minimum validation path? |
Three-Layer Scoring Formula
The scoring is layered so that each layer captures a different strategic lens — Survival measures standalone quality, Development measures growth potential, and Priority blends both with recency and diversity bonuses to prevent the pool from stagnating.
Survival = 0.10×Novelty + 0.20×Feasibility + 0.20×Value
+ 0.20×Logic + 0.10×CrossPotential + 0.20×Verifiability
Development = 0.30×Novelty + 0.30×CrossPotential
+ 0.20×VariationPotential + 0.20×Freshness
Priority = 0.50×Survival + 0.30×Development
+ 0.10×NewIdeaBoost + 0.10×DiversityBonus
- VariationPotential (0–10): How many distinct directions can this idea still branch into. Decreases as more children are derived.
- Freshness (0–10): Has this idea changed recently? Decays when an idea goes unprocessed for several rounds.
- NewIdeaBoost: Newly pooled ideas get +2 for their first 2 rounds, then 0.
- DiversityBonus: Ideas belonging to underrepresented categories in the pool get +1–2.
When scoring, refer to the prompt templates in references/prompts.md.
Initialization Flow
When the user runs /idea-darwin init:
-
Locate ideas.md
- Check if ideas.md exists in the current directory
- If not found, use
AskUserQuestion to ask for the path
-
Create directories and config
- Create cards/, rounds/, reports/, graph/
- Generate config.yaml (merge user-provided optional params; use defaults for unspecified ones):
source:
ideas_file: "./ideas.md"
counter:
next_idea_id: 1
current_round: 0
schedule:
max_ideas_per_round: 12
max_actions_per_idea: 2
disruption:
trigger_every_n_rounds: 3
wildcard_budget_ratio: 0.10
- Generate
stimuli.md (external stimulus file in the project root) with an initial template and editing instructions
-
Parse ideas.md
- Identify each independent idea (typically separated by ## headings)
- Do not modify ideas.md — it is always read-only
-
Generate a card for each idea
- Assign ID (starting from IDEA-0001)
- Tag (topic / problem type / stage / style / resource tags)
- Generate full card following
assets/card-template.md format
- Initial scoring (6 dimensions + 3-layer composite scores)
- Write to cards/IDEA-XXXX.md
-
Generate round-000.md report
- List all initial card summaries, scores, and suggested next steps
- Write to rounds/round-000.md
-
Present results to user
- Display a summary table of all cards (ID, title, score, suggested action)
- Inform the user about
stimuli.md and how to use it:
stimuli.md has been created in the project root. Every N rounds, the system randomly selects up to 5 enabled entries as external stimuli to break mental ruts.
You can edit this file anytime to add/modify/disable entries. Each entry follows this format:
## [Entry Title]
- status: enabled / disabled
- [Content description]
- Wait for user confirmation before entering the formal round cycle
Round Execution Flow
When the user runs /idea-darwin round, execute these 9 steps strictly in order:
Step 1: Import New Ideas
- Every round starts by checking the default idea document: read the file pointed to by
source.ideas_file in config.yaml
- Compare the default ideas.md against existing cards to identify new additions
- For new ideas: tag → generate card → initial scoring
- New ideas are marked
stage: seed and receive the NewIdeaBoost
- This is a mandatory pre-step for every round — the system must not loop only over existing cards while ignoring incremental additions to the source file
Step 2: Update Relationship Graph
- Based on all cards' tags and content, compute inter-idea similarity
- Identify potential cross candidates (high similarity = neighbor-cross candidates; low similarity but complementary = distant-cross candidates)
- Update graph/relations.json
Step 3: Global Score Refresh
- Recalculate the 6-dimension scores for every active idea (not dormant)
- Update Survival / Development / Priority
- Flag: high-potential (Priority > 7), stagnant (unchanged for 3+ rounds), low-potential (Priority < 3)
Step 4: Budget Allocation
Distribute slots according to max_ideas_per_round:
- 25% for newly pooled ideas
- 30% for deepening high-priority ideas
- 20% for deriving from high-potential ideas
- 15% for cross experiments
- 10% for disruption / random exploration
Select ideas by Priority Score descending. Each idea gets at most max_actions_per_idea actions.
Step 5: Decide Actions
For each selected idea, assign actions based on the state machine (see table above).
When the state machine is insufficient, use score-driven rules:
High Novelty + Low Verifiability → deepenHigh Novelty + High CrossPotential → crossHigh Value + Low Feasibility → critique + refineHigh Feasibility + Low Logic → deepenHigh duplication → merge
Step 6: Execute Actions
Process each selected idea in turn. Refer to references/actions.md for detailed execution specs, and references/prompts.md for prompt templates.
Execution flow per idea:
- Read the full card
- Follow the corresponding prompt template for the action type — think deeply
- Produce structured output:
- Updated card content
- New derived ideas (auto-assign IDs, update parent_ids/child_ids on both sides)
- Score changes
- Discovered risks
- Suggested next actions
- Write the updated card file
Newly derived ideas also require full card generation and initial scoring.
Step 7: Validate and Deduplicate
- Run two-layer validation on all newly produced ideas:
- Layer 1 (Fatal flaw check): Logical contradiction? No real demand? Completely infeasible? Near-duplicate?
- Layer 2 (Value judgment): Worth continuing? What next? Biggest risk?
- Validation failure → mark
validated: false, lower priority, report to user
- The user decides whether to dormant or remove — the system only recommends
- Run similarity check across the entire pool and merge near-duplicates
Step 8: Generate Round Report
Write to rounds/round-XXX.md, including:
- Ideas processed this round and actions executed
- Newly produced idea summaries
- Top 5 score changes (up/down)
- Ideas that failed validation (require user decision)
- Recommended priorities for next round
- If disruption round: which external stimuli were used, which innovation frameworks applied
Step 8.5: Output Round Briefing
After all file updates are complete, output a round briefing directly in the conversation (not written to file) so the user can understand the full picture without opening any files. Format:
## Round N Briefing
### Actions Taken
| ID | Title | Action | Key Output |
|---|---|---|---|
| IDEA-XXXX | ... | deepen/derive/cross/critique/... | One-line summary |
### Card Changes
| ID | Title | Score Change | State Change | Notes |
|---|---|---|---|---|
| IDEA-XXXX | ... | Priority X.XX→X.XX | seed→exploring | Reason for change |
### New Ideas (Detail)
For each newly produced idea this round:
#### IDEA-XXXX: [Title]
- **Source**: [cross/derive/stimulus] from IDEA-XXXX + IDEA-XXXX
- **Core Question**: [one paragraph]
- **Key Insight**: [what's most valuable about this idea]
- **Initial Score**: Priority X.XX (Survival X.XX / Development X.XX)
- **Current Tension**: [biggest unresolved question]
- **Suggested Next Step**: [deepen/derive/cross/critique + specific direction]
### Current Rankings
| Rank | ID | Title | Priority | Stage |
|---|---|---|---|---|
### Next Round Preview
- [Suggested priority actions]
- [Whether a disruption round is coming soon]
### Decisions Needed
> List key decisions the user needs to make this round. Each item **must include the idea's full title** (not just the ID) along with context and suggested options.
> Examples:
> 1. **IDEA-0002 "Learn Coding Agent Tutorial Site" overlaps with IDEA-0004 "Progressive Unboxing Pedagogy"** — Merge or reposition? Suggestion: [...]
> 2. **IDEA-0006 "Auto-Diagnostic Thread" failed validation** — Dormant, pivot, or keep observing?
> 3. **IDEA-0003 "Thermal Management Ontology" downgraded** — Accept downgrade from ontology to structured Excel as first step?
>
> If no user decisions are needed this round, write "No decisions needed this round."
This briefing is the primary interface between the user and the system — keep it complete and readable. The "Decisions Needed" section is the most important interaction point: the system should clearly list decision items with recommendations, rather than leaving the user to discover issues from reports.
Step 9: Save State
- Update all modified card files
- Increment
current_round in config.yaml
- Update
next_idea_id
- Update reports/leaderboard.md (Top 10 rankings)
External Stimuli and Disruption Rounds
Every trigger_every_n_rounds rounds (default 3), external stimuli are introduced in a "disruption round." The purpose is to prevent the idea pool from converging on a local optimum by forcing fresh perspectives.
External Stimulus File (stimuli.md)
stimuli.md lives in the project root. It is created during initialization and maintained by the user. Format:
## Industry Trend: Embodied AI Accelerating to Production
- status: enabled
- Embodied AI moving from lab to production line in 2026, robot operating costs down 60%
## Tech Shift: Unified Multimodal Model Architecture
- status: enabled
- Vision, language, and code unified into single models, API paradigm changing
## Contrarian View: SaaS Is Dead
- status: disabled
- Open-source + self-hosted deployments replacing traditional SaaS subscriptions
- Each entry:
## heading + status field + content description
enabled = participates in random selection; disabled = skipped- Users can add, edit, or toggle entries at any time
- The system only reads this file — never writes to it
Disruption Round Mechanics
- Shuffle priorities: Give low-priority but novel ideas a chance to surface
- Distant cross: Force crossbreeding between ideas with non-overlapping tags
- External stimuli: Randomly select up to 5 enabled entries from stimuli.md
- Assumption reversal: For top-scoring ideas, ask "What if the core assumption is wrong?"
- Innovation frameworks: Apply SCAMPER / First Principles / Analogical Transfer / Constraint Reversal / Extreme User Perspective
Each round also reserves wildcard_budget_ratio (default 10%) of slots for non-optimal-path exploration.
Dormancy and Wake
/idea-darwin dormant IDEA-XXXX
- Read the card, set stage to
dormant
- Record reason and round number in the card's "Dormancy Log"
- The idea will no longer be selected for deepen/derive, but still participates in cross and similarity matching
/idea-darwin wake IDEA-XXXX
- Read the card, restore stage to the pre-dormancy state (inferred from history, typically
exploring)
- Update the "Dormancy Log"
The system never auto-dormants any idea. Only the user can make that call.
/idea-darwin status
Read config.yaml and all cards, then output:
- Current round number
- Total ideas in pool (broken down by state)
- Top 10 rankings (by Priority Score descending)
- What was processed in the most recent round
- Suggested next steps
Key Constraints
- ideas.md is read-only: Never modify the user's ideas.md
- IDs never recycle: Numbers are never reused under any circumstance
- Branch limit: Each idea can derive at most 2–3 children per round
- Per-round dedup: Similarity check is mandatory before a round concludes
- User control: The system never auto-dormants or removes ideas — only recommends
- Structured output: Every action must produce structured results
- Consistent card format: All cards strictly follow
assets/card-template.md
- Traceable reports: Every round report must contain a complete operation log
Reference Files
references/actions.md: Detailed specs and use cases for each standard actionreferences/prompts.md: Prompt templates for each actionassets/card-template.md: Card file template
