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.