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.