plan-to-epic

Convert implementation plans into Beads epics with scoped tasks and dependencies.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ItsMattG/property-tracker --skill plan-to-epic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-to-epic
Source: https://github.com/ItsMattG/property-tracker/tree/main/.claude/skills/plan-to-epic
Command: npx skills add https://github.com/ItsMattG/property-tracker --skill plan-to-epic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Parse an implementation plan and transform it into a Beads epic with clearly scoped, dependency-linked tasks.

Core Features & Use Cases

  • Extract Goal, Architecture, and Tech Stack from the plan header.
  • Identify tasks from plan sections and apply the one-sentence scoping test to split complex tasks.
  • Generate a Beads epic with three-field-separated tasks, automatic dependency inference, and cycle-detection validation.

Quick Start

Provide the path to the implementation plan and an optional design doc to generate a Beads epic with scoped tasks and inferred dependencies.

Frequently Asked Questions about plan-to-epic

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

FAQPage Schema
How do I turn an implementation plan into linked epics with scoped tasks?

To turn an implementation plan into linked epics with scoped tasks, you can automate the parsing of plan headers to extract goals and architecture, apply a one-sentence scoping test to split complex tasks, and generate epics with inferred dependencies and cycle-detection validation.

How does automatic task dependency inference work when generating epics?

Automatic dependency inference works by analyzing the extracted tasks from plan sections to map relationships, applying DAG validation to detect cycles, and ensuring the generated epic maintains a verifiable structure with properly linked tasks and phase-based scoping.

Can I incorporate a design doc when converting a plan into a Beads epic?

Yes, you can incorporate a design doc when converting a plan into a Beads epic. Providing the path to an implementation plan and an optional design doc allows the system to extract goals, architecture, and tech stack to emit epics with scoped tasks and inferred dependencies.

What is the one-sentence scoping test for splitting complex tasks in an epic?

The one-sentence scoping test is a mechanism applied to tasks identified from plan sections to split complex tasks into clearly scoped, three-field-separated items, ensuring the generated Beads epic maintains a verifiable structure with properly linked dependencies.

Does Beads epic generation support phase-based scoping and DAG validation?

Yes, Beads epic generation supports phase-based scoping and DAG validation. It handles phase-based scoping during task extraction and applies cycle-detection validation to ensure dependency links form a verifiable directed acyclic graph structure.

Why does dependency cycle detection fail when creating epics from plans?

Dependency cycle detection fails when inferred task dependencies form circular references. The DAG validation process catches these cycles during Beads epic generation to prevent invalid dependency links from being emitted into the verifiable structure.