rad-create-plans

Author Requirements, Master Plan, and amendment documents for the rad-orc planning pipeline.

Updated May 24, 2026
One-click install
npx skills add https://github.com/MetalHexx/rad-orc-marketplace --skill rad-create-plans-metalhexx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rad-create-plans
Source: https://github.com/MetalHexx/rad-orc-marketplace/tree/main/claude-plugin/skills/rad-create-plans
Command: npx skills add https://github.com/MetalHexx/rad-orc-marketplace --skill rad-create-plans-metalhexx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It standardizes how a main agent authors planning documents in the rad-orc workflow, ensuring Requirements, Master Plans, and amendments follow a parser-enforced structure that downstream orchestration can explode into executable phases and tasks. ## Core Features & Use Cases - Mode-based routing: Three self-contained workflows — requirements, master-plan, and amendment — selected by the caller and followed inline by the main agent, never delegated to subagents. - Contract-rich task authoring: An authoring standard that pins interfaces, external surfaces, and seams into each task so coding agents execute without opening other documents. - Parser-safe output contracts: Templates and heading discipline (## P{NN}:, ### P{NN}-T{MM}:) with retry guidance for structured parse errors, capped at 3 attempts. - Use Case: After a /rad-brainstorm session reaches consensus, the main agent authors a Requirements document, then later receives the spawn_master_plan action and produces a Master Plan whose tasks a coding agent executes directly. ## Quick Start Declare a mode such as requirements, master-plan, or amendment and follow the corresponding workflow reference to author the planning document.

Frequently Asked Questions about rad-create-plans

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

FAQPage Schema
How do I author a Master Plan in the rad-orc workflow?▼

Follow the master-plan mode: carry the approved Requirements context in, ground with targeted codebase discovery, decide phase and task breakdown, then author the Execution Map and full phase/task blocks. Save to {NAME}-MASTER-PLAN.md at the project root.

How do I write an amendment to an approved Master Plan?▼

Use the amendment mode to add, revise, or drop phases and tasks within the plan's open frontier. Declare changes in frontmatter keys like adds_tasks or drops_tasks, ground against the current working tree, and save as {NAME}-AMENDMENT-{NN}.md.

What heading format does the Master Plan parser require?▼

Phases use `## P{NN}:` and tasks use `### P{NN}-T{MM}:` with zero-padded two-digit numbers, and task numbering restarts at T01 in every phase. The Execution Map above must use bold labels, never headings, to avoid parser collisions.

Can planning tasks be delegated to subagents?▼

No. Every mode in this skill is followed inline by the main agent, never delegated. The brainstorm or pipeline context carries directly into authoring, which a subagent would not hold.

What happens when Master Plan parsing fails?▼

Read the structured last_parse_error from state.json, fix only the flagged issue at the indicated line, and re-emit. The retry loop is capped at 3 attempts before the pipeline halts for manual help.

Should requirement IDs appear inside task bodies or code?▼

No. Requirement IDs like R{n} live only on requirement headings in the Requirements doc. They must never appear in task bodies, code, tests, or comments, since they are planning scaffolding only.