plan

Convert design documents into a dependency-aware task graph for Claude Code.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/ryanismert/claude-plugin-build --skill plan-ryanismert
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan
Source: https://github.com/ryanismert/claude-plugin-build/tree/main/skills/plan
Command: npx skills add https://github.com/ryanismert/claude-plugin-build --skill plan-ryanismert

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridges the gap between design documents and actionable work by converting designs into a wired, dependency-aware task graph that Claude Code can execute.

Core Features & Use Cases

  • Extracts work items from design sections (e.g., 11.1, 11.2, 11.3) and groups them into phases.
  • Generates a deterministic task graph with explicit dependencies and blockers.
  • Supports multi-session planning and external blockers as tasks in a pending state.

Quick Start

Provide a design document (e.g., docs/design-*.md) to generate a wired task graph and a Phase 1 plan.

Frequently Asked Questions about plan

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

FAQPage Schema
How do I turn design docs into executable tasks in Claude Code?▼

To turn design docs into executable tasks, this Skill converts design documents into a wired, dependency-aware task graph. It extracts work items from design sections, groups them into phases, and generates a ready-to-run task set for Claude Code execution.

How does task graph generation work for software engineering project planning?▼

Task graph generation works by mapping design document sections to phase-based tasks with explicit dependencies and blockers. It validates required frontmatter like name and description, then derives a deterministic task graph that respects external blockers to seed a compliant execution plan.

Can I use this planning workflow with external blockers and multi-session execution?▼

Yes, this planning workflow supports multi-session planning and manages external blockers as tasks in a pending state. It generates a deterministic task graph that tracks these blockers, ensuring dependencies are respected across multiple execution phases.

What is the best way to group design document sections into implementation phases?▼

The best way to group design sections into implementation phases is by extracting work items from numbered design sections like 11.1 and 11.2, then mapping them into a phase-based plan with explicit dependencies, blockers, and a ready-to-run task set.

Do I need specific frontmatter in my design documents to generate a task graph?▼

Yes, you need specific frontmatter in your design documents to generate a task graph. The planning process validates required frontmatter fields, specifically name and description, before mapping design sections to a compliant task graph for execution.

What are the limitations of converting design docs to task graphs in Claude Code?▼

A limitation of converting design docs to task graphs is that the design document must be located in the docs/ directory or provided via ARGUMENTS. The task graph generation relies entirely on the structure and content of the input design document to derive phases and dependencies.