planner-invocation

Optimizes planner agent invocations for phase specs with token budgets and decision gates.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/CMiller838/meal-planner --skill planner-invocation-cmiller838
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planner-invocation
Source: https://github.com/CMiller838/meal-planner/tree/main/.claude/skills/planner-invocation
Command: npx skills add https://github.com/CMiller838/meal-planner --skill planner-invocation-cmiller838

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Invoking a planner subagent in phase mode burns tokens fast because a resumed agent replays its entire prior transcript, and coordinators often duplicate scanning work or leave decision forks ungated. This protocol keeps each planner call near a 100k token budget while ensuring important architectural decisions pause for the user. ## Core Features & Use Cases - Token Budget Enforcement: Targets roughly 100k subagent tokens per phase-mode planner call and diagnoses which rule slipped when a call runs over. - Targeted Dispatch Prompts: Requires naming exact files, functions, line ranges, and CSS selectors, plus referencing exactly one prior phase as the format model. - Decision Gate Discipline: Distinguishes trivial forks (auto-decided and noted) from important forks (architecture, reuse-vs-build, contradictions of dispatch assumptions) that must halt for the user's explicit pick, with batching to minimize resume round trips. - Use Case: Before dispatching @planner to write a phase 4 spec and tasks breakdown, run a few targeted greps to pin file locations, name phase 2 as the format model, and instruct planner to read only its own tasks.md slice. ## Quick Start Invoke the planner agent for the next phase spec using this protocol, naming exact files and line ranges, citing one prior phase as the format model, and gating any architectural decisions for my approval.

Frequently Asked Questions about planner-invocation

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

FAQPage Schema
How do I reduce token usage when invoking a planner subagent?

Avoid pre-scanning the codebase in the coordinator session, since planner's own Stage 1 spawns a scanner subagent when needed. Instead, name exact files, functions, and line ranges in the dispatch prompt so planner skips open-ended sweeps, and target roughly 100k subagent tokens per call.

How should I write a dispatch prompt for a phase spec planner?

Name exact files with line ranges or CSS selectors for every file the phase touches, reference exactly one prior phase's spec and tasks section as the format model, and instruct planner to read only its own phase's slice of tasks.md via grep on its heading.

When should a planner agent pause for a decision gate?

Gate forks that are expensive to reverse or change the phase's shape: schema changes, new endpoints or dependencies, reuse-vs-build choices, and findings contradicting the dispatch prompt's assumptions. Trivial forks that are cheap to change later should be decided by planner and noted in the spec.

Why does a resumed planner call cost so many tokens?

A resumed agent replays its entire prior transcript, so a pause-and-resume round costs roughly twice the pre-pause transcript. Batch multiple gates into one message with recommendations and resume once rather than resuming per gate.

Can I tell the planner to proceed past a decision gate without user input?

No. Instructions like "proceed after presenting" get treated as license to self-resolve every gate, defeating the purpose of gating. To minimize round trips, ask planner to list all gates at once with recommendations and resolve them in a single batched user answer.