map

Generate stub-level implementation plans from ADRs and research documents.

2|1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/Epiphytic/brains --skill map-epiphytic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map
Source: https://github.com/Epiphytic/brains/tree/main/skills/map
Command: npx skills add https://github.com/Epiphytic/brains --skill map-epiphytic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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".

Frequently Asked Questions about map

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

FAQPage Schema
How do I generate an implementation plan from an architecture decision record?

To generate an implementation plan from an architecture decision record, you can use a tool that parses accepted ADRs and research documents to produce a concise, stub-level plan. This plan surfaces task dependencies, acceptance criteria, and a user approval gate for confident multi-agent implementation.

What is a stub-level implementation plan and when do I need one?

A stub-level implementation plan is a high-level document that connects architecture decisions to implementable tasks without detailing specific code. You need one when orchestrating multi-agent or multi-phase work to ensure dependencies and acceptance criteria are reviewable before implementation begins.

Can I use multi-LLM review modes to refine task ordering and sizing?

Yes, you can use multi-LLM review modes to refine task ordering, sizing, coverage, and phasing. By running subagents or star-chamber reviews in single, parallel, or debate modes, the plan is systematically improved before implementation begins.

How do I create tracked tasks and topic branches from an accepted ADR?

You can create tracked tasks and topic branches from an accepted ADR by deriving a topic slug and generating a map document. This process automatically creates beads-labeled tasks with brains prefixes and selects the appropriate task tracker for umbrella secure and nurture tasks.

Does this plan generation approach work without writing implementation specifics?

Yes, this plan generation approach works by intentionally avoiding implementation specifics. It focuses on enumerating high-level tasks, dependencies, and acceptance criteria to provide a reviewable high-level plan that connects architecture decisions to actionable work.