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.