What problem does it solve?
Projects often lack a clear, reviewable high-level plan that connects architecture decisions to implementable tasks, which makes multi-agent or multi-phase work costly and error-prone. The map skill converts accepted ADRs and research into a concise, stub-level plan that surfaces dependencies, acceptance criteria, and a user approval gate so teams can proceed to implementation with confidence.
Core Features & Use Cases
- Stub-level plan generation: Produce a plan document that avoids implementation specifics while enumerating tasks, dependencies, and acceptance criteria.
- Branch and tracker integration: Offer topic-branch creation and create beads tasks with brains:-prefixed labels, selecting the appropriate task tracker and creating umbrella nurture/secure tasks.
- Multi-LLM review modes: Support --single, --parallel, and --debate modes to run subagents or star-chamber reviews that refine ordering, sizing, coverage, and phasing.
- Use case: After an ADR is accepted, run the map skill to derive a topic slug, generate a map document, and create tracked tasks so implementation teammates can resume in phase 3.
Quick Start
Use the map skill to outline a stub-level implementation plan and create beads tasks for the topic "add a health-check endpoint".