Ideation

Ideation Pipeline

A 5-stage skill chain that transforms a problem space into interactive HTML prototypes. Each stage reads the previous stage's markdown output and writes structured markdown for the next.

intake → generate → review → ui → prototype
  │          │          │       │       │
  ▼          ▼          ▼       ▼       ▼
problem    solutions  reviewed  ui    prototypes/
_space.md   .md       _solutions concepts solution_
                      .md       .md    {id}.html

Configuration

Read .claude/ideation.local.md in the project root if it exists. Parse the YAML frontmatter for settings. If missing, use defaults.

Template: settings-template.md — copy to .claude/ideation.local.md. You can also generate it with /ideation:init.

Stage Skills

Run Folder Structure

A completed run folder looks like:

ideation-run-01/
├── intake.md                  # Blank template (created by stage 1, filled by user)
├── problem_space.md           # Stage 1 output
├── solutions.md               # Stage 2 output
├── reviewed_solutions.md      # Stage 3 output (single source of truth from here on)
├── ui_concepts.md             # Stage 4 output
└── prototypes/                # Stage 5 output (via web-artifacts-builder)
    ├── solution_01_01/        # React project source
    │   └── bundle.html
    ├── solution_01_01.html    # Bundled standalone prototype
    ├── solution_01_02/
    │   └── bundle.html
    ├── solution_01_02.html
    └── ...

ID Conventions

Cross-Stage Validation Rules

1. Every solution ID in reviewed_solutions.md must trace back to solutions.md
2. Every solution in ui_concepts.md must appear in the "passed" section of reviewed_solutions.md
3. Every cap_XX or asp_XX referenced in solutions must exist in problem_space.md
4. Every prob_XX referenced in solutions must exist in problem_space.md
5. Solution IDs follow the pattern sol_{NN}_{NN}
6. UI concept IDs follow the pattern ui_{NN}_{NN}_{letter}
7. Prototype filenames follow the pattern solution_{sol_id}.html

Reference Docs

• Data Contracts — YAML frontmatter schemas for all stages
• Intake Template — Blank template for stage 1
• Solution Diversity — 5 diversity dimensions for stage 2
• Scoring Rubric — Feasibility/novelty/dedup for stage 3
• ASCII Rules — Box-drawing, sizing, labeling for stage 4
• HTML Prototype Spec — Self-contained HTML requirements for stage 5