deep-plan

Plan complex features with architecture analysis and executable sub-plans.

4|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/markhazlett/agent-harness --skill deep-plan-markhazlett
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-plan
Source: https://github.com/markhazlett/agent-harness/tree/main/.claude/skills/deep-plan
Command: npx skills add https://github.com/markhazlett/agent-harness --skill deep-plan-markhazlett

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complex feature work often requires architecture analysis, decomposition into executable sub-plans, and guardrails to reduce risk and ensure timely delivery.

Core Features & Use Cases

  • Entry-point architecture document (00-.md) plus executable sub-plans (G1-.md, G2-*.md) to structure big workstreams.
  • Generates a plan folder layout (docs/plans/YYYY-wNN/...) with dependency graphs and time budgets to optimize parallelism.
  • Enforces security reviews and risk assessment as part of the planning process, including one-way door analysis and guardrails.

Quick Start

Describe the workstream you want to plan to generate the 00-*.md entry point and associated sub-plans.

Frequently Asked Questions about deep-plan

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

FAQPage Schema
How do I plan complex features that span multiple files and systems?▼

Planning complex features involves creating an entry-point architecture document and decomposing the workstream into executable sub-plans. This structures big initiatives by generating a dependency graph and time budgets to optimize parallelism across multiple files and systems.

What is sub-plan decomposition for multi-sprint workstreams?▼

Sub-plan decomposition is the process of breaking a large architecture document into executable sub-plans, such as G1 or G2 files. It structures big workstreams by creating a plan folder layout with dependency graphs to optimize parallelizable tasks across multiple sprints.

How do I integrate security reviews and risk assessment into architecture planning?▼

Integrate security reviews and risk assessment into architecture planning by enforcing them directly within the plan generation process. This includes conducting one-way door analysis and establishing guardrails to reduce risk and ensure timely delivery of complex features.

When do I need a dependency graph for parallelizable workstreams?▼

You need a dependency graph for parallelizable workstreams when planning complex initiatives spanning multiple files and systems. Generating a dependency graph with time budgets optimizes parallelism by structuring executable sub-plans within a dedicated plan folder layout.

What is the best way to structure an entry-point architecture document for complex features?▼

The best way to structure an entry-point architecture document is to use an 00-*.md file format within a docs/plans folder structure. This entry point defines the architecture analysis and links to associated executable sub-plans to structure big workstreams effectively.

Does this planning approach work for single-file updates or simple feature additions?▼

This planning approach is not intended for single-file updates or simple feature additions. It applies to initiatives spanning multiple files and systems, requiring architectural decisions, multi-sprint planning, and parallelizable workstreams to justify the sub-plan decomposition overhead.