idea-wizard

Generate and refine project improvement ideas into self-documenting beads with dependency structure.

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill idea-wizard-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: idea-wizard
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/idea-wizard
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill idea-wizard-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Brainstorming sessions often produce vague ideas that never become actionable work, or duplicate existing plans. This Skill turns open-ended ideation into a structured, multi-phase workflow that generates many ideas, winnows them ruthlessly, and converts survivors into granular, self-documenting beads with tasks, subtasks, and dependencies. ## Core Features & Use Cases - Structured Ideation Pipeline: A six-phase workflow that generates 30 ideas, winnows to the best 5, expands to 15, checks overlap against existing beads, and creates dependency-structured work items. - Self-Documenting Beads: Creates beads via the br CLI with background, rationale, risks, and success criteria so no external plan document is needed. - Iterative Refinement: Runs 4-5 refinement passes in plan space with cycle detection via bv --robot-insights before any implementation begins. - Use Case: When planning the next milestone for a CLI tool, use this Skill to brainstorm improvements, evaluate them against a 10-criterion rubric, and produce a complete bead graph with unit and e2e test tasks ready for implementation. ## Quick Start Ask the agent to run the idea-wizard workflow to brainstorm improvements for this project and turn the best ideas into beads.

Frequently Asked Questions about idea-wizard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn brainstorming ideas into actionable tasks?

Use a generate-then-winnow workflow: produce 30 ideas, filter to the best 5 using an evaluation rubric, expand to 15, then create self-documenting beads with tasks, subtasks, and dependencies via the br CLI. Refine the beads over 4-5 passes before implementing.

How do I create beads with dependencies using the br tool?

Create epics and tasks with br create, then link them using br dep add <child> <parent>. Validate the graph immediately with bv --robot-insights to confirm the Cycles array is empty before proceeding.

When should I use a duel instead of single-agent idea generation?

Escalate to a duel for high-stakes architectural decisions, contested design spaces, or blue-sky questions with no clear answer. Single-agent ideation is sufficient for well-shaped questions and routine discovery cycles.

How do I avoid creating duplicate beads for existing work?

Read AGENTS.md and list all open and closed beads with br list --json before ideation. In the overlap-check phase, compare new ideas against existing bead titles and merge complementary ideas instead of duplicating them.

What makes a bead self-documenting?

A self-documenting bead answers what needs to be done, why it matters, how to approach it, what risks exist, and what success looks like. It includes enough background and rationale that no external plan document is ever needed.