From writing-with-agents
Generates Mermaid mindmap diagrams as 2-3 nonlinear outline options for article structures, knowledge domains, and idea mapping after brainstorming raw material.
npx claudepluginhub jeffallan/writing-with-agents --plugin writing-with-agentsThis skill uses the workspace's default tool permissions.
The Whirlybird is the nonlinear outlining phase using Bryan Garner's technique from *The Winning Brief*. Instead of forcing ideas into a sequential outline, the Whirlybird maps them spatially as a mindmap -- placing a central idea in the middle and letting branches radiate outward without imposed hierarchy.
Generates mindmaps, diagrams, charts, and visual content configurations using Mermaid and best practices. Activates on 'mindmap generator' phrases for documentation, presentations, and visualization tasks.
Create and manage ProcessOn mind maps: build node structures, style themes/icons, real-time collaborate, export PNG/SVG/PDF. For visual idea organization and project outlining.
Guides creation of diagrams, concept maps, and architectural blueprints to visualize relationships, dependencies, and structures. Useful for documenting complex systems, component mappings, hierarchies, processes, architectures, and data flows.
Share bugs, ideas, or general feedback.
The Whirlybird is the nonlinear outlining phase using Bryan Garner's technique from The Winning Brief. Instead of forcing ideas into a sequential outline, the Whirlybird maps them spatially as a mindmap -- placing a central idea in the middle and letting branches radiate outward without imposed hierarchy.
Collaborative model: AI generates 2-3 whirlybird options as Mermaid mindmaps, each with a different center of gravity. Human selects, combines, or redirects. The human never receives a single take-it-or-leave-it structure.
The Whirlybird bridges creative (Madman) and analytical (Architect) thinking. The Madman produces raw material without restraint. The Architect imposes order with a throughline. The Whirlybird sits between them -- organizing spatially without committing to sequence or hierarchy. Ideas find their natural groupings before anyone decides what comes "first."
Priority is not assigned during this phase. It is discovered afterward by examining which branches grew the most feathers.
Receive Madman output -- Take the raw material dump from the Madman phase. Scan for recurring themes, candidate arguments, key evidence clusters, and natural groupings. If no Madman output exists, ask the human for the topic and raw ideas before proceeding. If a Fool stress-test was run between Madman and Whirlybird, absorb the refined thesis and any surfaced weaknesses into the scan — the centers of gravity you identify should reflect the stress-tested thesis, not the pre-Fool version.
Identify 2-3 candidate centers of gravity -- Each center reframes the same material through a different lens or emphasis. A center of gravity is not a title -- it is the idea everything else orbits. Different centers produce different articles from identical raw material.
Generate Mermaid mindmap for each option -- Build a mindmap with 3-5 primary branches (wings), 2-5 feathers per branch, and 15-25 total nodes maximum. Every node label is 2-6 words. No full sentences. See references/whirlybird-format.md for syntax rules and structural constraints.
Present options to human for selection -- Use structured presentation with clear labels for each option. The human may select one whirlybird, combine elements from multiple, or redirect entirely. Never proceed without explicit human selection. See references/article-whirlybird-examples.md for the presentation format.
Deliver selected whirlybird to Architect phase -- Package the chosen mindmap with the original Madman material for the Architect to triage, cut, and impose sequence. The whirlybird informs structure but does not dictate it.
| Topic | Reference | Load When |
|---|---|---|
| Mermaid syntax, structural rules, templates | references/whirlybird-format.md | Generating any whirlybird mindmap |
| Article-level whirlybird examples | references/article-whirlybird-examples.md | Creating whirlybirds for a single piece |
| Domain-level whirlybird examples | references/domain-whirlybird-examples.md | Mapping a knowledge domain for content strategy |
MUST DO:
MUST NOT DO:
Every Whirlybird artifact opens with YAML frontmatter so downstream phases can trace provenance:
---
type: whirlybird
version: N
parent: raw-material.md
---
Write one file per option (e.g., whirlybird-a-<slug>.md, whirlybird-b-<slug>.md). parent points to the Madman output. Omit derived-from when it is identical to parent.
Each whirlybird option uses an H3 heading, an emphasis line, and a Mermaid mindmap block:
Heading: ### Whirlybird [A/B/C]: [Center of Gravity]
Emphasis line: One sentence describing what this framing prioritizes.
Mindmap block:
mindmap
root((Center Idea))
Branch One
Feather 1a
Feather 1b
Feather 1c
Branch Two
Feather 2a
Feather 2b
Branch Three
Feather 3a
Feather 3b
Feather 3c
Feather 3d
After presenting all options, prompt for selection using the format in references/article-whirlybird-examples.md.
Bryan Garner introduced the whirlybird technique in The Winning Brief as an alternative to the rigid sequential outline. Garner observed that forcing ideas into I-A-1-a hierarchy too early kills the writer's ability to see relationships between ideas. The whirlybird places a central concept in the middle of the page and lets related ideas radiate outward without predetermined order. The name comes from the spinning motion of freely associating outward from a center.
The center of gravity is the most important decision in this phase. Different centers produce fundamentally different articles from the same raw material. A piece about "remote work productivity" could center on tools, on habits, on management failure, or on cognitive science. Each center pulls different Madman material into prominence and pushes other material to the periphery. Generating 2-3 whirlybirds with different centers gives the human a genuine structural choice rather than a single predetermined path.
The Mermaid mindmap format enforces conciseness through its syntax constraints. Node labels of 2-6 words force the writer to distill ideas to their essence. The 15-25 node limit prevents the whirlybird from becoming a second Madman dump. These constraints are features, not limitations -- they force spatial thinking to stay at the structural level where it is most useful.
The bridge function between Madman and Architect is deliberate. The Madman produces chaos. The Architect imposes order. Without the Whirlybird, the transition is abrupt and often results in the first plausible structure being adopted without exploring alternatives. The Whirlybird creates a structured intermediate step where multiple organizational approaches can be compared before any is committed to sequence.