headless-plan

Gather organizational context and produce a validated implementation plan without writing code.

13|1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/unblocked/cookbook --skill headless-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headless-plan
Source: https://github.com/unblocked/cookbook/tree/main/recipes/headless-plan
Command: npx skills add https://github.com/unblocked/cookbook --skill headless-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Headless planning workflow that gathers organizational context and produces a validated implementation plan without writing code. Use when an agent needs to plan a change autonomously — for handoff to another agent, a cloud executor, or human review. Hydrates with context_research, drafts a plan with inlined context, and validates it against team patterns. No codegen phase.

Core Features & Use Cases

  • Self-contained plan with embedded context
  • Hydrates with context_research, inlines conventions and prior art, and validates against team patterns
  • Suitable for handoff to other agents or human review in autonomous environments

Quick Start

Provide a self-contained headless plan for the requested change, embedding all context and validating it against team patterns.

Frequently Asked Questions about headless-plan

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

FAQPage Schema
How do I generate an autonomous implementation plan without writing code?

An autonomous implementation plan without code is generated by a headless workflow that gathers organizational context and validates it against team patterns. It embeds research and conventions inline, producing a self-contained plan ready for handoff.

What is headless planning for autonomous agents?

Headless planning is an autonomous workflow where an agent gathers context and drafts an implementation plan without writing code. It embeds organizational context inline and validates the plan against team patterns before finalization.

How do I create a validated implementation plan for handoff to another agent?

To create a validated implementation plan for agent handoff, use a headless planning workflow that hydrates with context research and inlines prior art. It validates the plan against team patterns to ensure the receiving agent has all necessary context.

Does autonomous planning work without a code generation phase?

Autonomous planning works without a code generation phase by focusing solely on drafting and validating the implementation strategy. It produces a self-contained plan with embedded context, explicitly skipping codegen to isolate the planning step.

Can I use headless planning for human review of implementation strategies?

Headless planning can be used for human review of implementation strategies because it produces a self-contained plan with embedded organizational context and team pattern validation. This allows reviewers to evaluate the full context without needing to run code generation.

When should I use a headless planning workflow instead of generating code directly?

Use a headless planning workflow instead of direct code generation when you need to separate the planning step from implementation for autonomous agent handoff or human review. It ensures the plan is validated against team patterns before any code is written.