planning

planning is a skill for Claude Code from 23blocks-OS/ai-maestro-plugins. It costs 58 tokens per session (1,958 once invoked), scanned B, original, MIT.

A planning system that keeps task plans, findings, and progress in Markdown files on disk. It is meant for complex work that spans multiple steps or tool calls.

In plain words
What is it for?
Planning research, multi-step implementation, and other long-running tasks with persistent progress notes.
Why use it?
It reduces lost context, drifting goals, repeated mistakes, and difficulty resuming work after a session is cleared.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; names the TodoWrite tool.

Part of the ai-maestro plugin — 8 skills, 3 hooks shipped together

Good fit Planning research, multi-step implementation, and other long-running tasks with persistent progress notes.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/23blocks-os/ai-maestro-plugins/planning
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add 23blocks-OS/ai-maestro-plugins --skill planning
Clone the repo
git clone --depth 1 https://github.com/23blocks-OS/ai-maestro-plugins

Made for: Claude Code.

Or install ai-maestro, the plugin that ships this one along with the rest of its 8 skills, 3 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for planning

README.md
[![agentmods](https://agentmods.dev/badge/skills/23blocks-os/ai-maestro-plugins/planning.svg)](https://agentmods.dev/skills/23blocks-os/ai-maestro-plugins/planning)
Your own site
<a href="https://agentmods.dev/skills/23blocks-os/ai-maestro-plugins/planning"><img src="https://agentmods.dev/badge/skills/23blocks-os/ai-maestro-plugins/planning.svg" alt="Measured on agentmods" height="20"></a>
Per session 58 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,958 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00058 $0.01958
Opus 5 $0.00029 $0.00979
Sonnet 5 $0.00012 $0.00392
Haiku 4.5 $0.00006 $0.00196

Measured 6d ago against content hash fead3717b5de, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade B, and why

planning scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Enumerates other installed skillsmediumAgent snooping

Other skills' SKILL.md files reveal prompts, capabilities and secrets that should be invisible to peers.

ls ~/.claude/skills/planning/templates/
plugins/ai-maestro/skills/planning/SKILL.md · 307 lines

How it starts

The opening of the file, as written. The whole thing — 307 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AI Maestro Planning Skill

The Problem This Solves: EXECUTION

This skill solves the execution problem - losing focus during complex tasks:

Problem Symptom This Skill Fixes It
Goal drift Forgot original objective after 50 tool calls Re-read plan before decisions
Lost progress Can't remember what phase I'm in Phase tracking in task_plan.md
Repeated errors Make same mistake twice Error log prevents repetition
Session loss Can't resume after /clear Planning files persist on disk

Note: This is different from the Memory skill (which solves recall of past conversations). Planning solves staying focused NOW.


Core Principle

Context Window = RAM (volatile, limited, fast)
Filesystem = Disk (persistent, unlimited, explicit read required)

Anything important gets written to disk.

Output Directory

Planning output files (task_plan.md, findings.md, progress.md) should be written to:

  1. The directory specified by the AIMAESTRO_PLANNING_DIR environment variable (if set)
  2. Otherwise, docs_dev/ in the current project root
  3. Create the directory if it does not exist

Do NOT write planning files to the project root — use docs_dev/ to avoid cluttering the project.


The 3-File Pattern

Create these files in docs_dev/ (not the project root or the skill directory):

File Purpose Update When
task_plan.md Goals, phases, decisions, errors After each phase
findings.md Research, discoveries, resources During research
progress.md Session log, test results Throughout session

Quick Start

Before any complex task (3+ steps):

# 1. Determine output directory
PLAN_DIR="${AIMAESTRO_PLANNING_DIR:-docs_dev}"
mkdir -p "$PLAN_DIR"

# 2. Create planning files from templates
cat ~/.claude/skills/planning/templates/task_plan.md > "$PLAN_DIR/task_plan.md"
cat ~/.claude/skills/planning/templates/findings.md > "$PLAN_DIR/findings.md"
cat ~/.claude/skills/planning/templates/progress.md > "$PLAN_DIR/progress.md"

# 3. Edit task_plan.md with your specific goal and phases

Read the full file on GitHub · 307 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 307 lines · 58 tokens per session scan B fead3717b5de

Subscribe to this mod's changes

planning is a skill published in the GitHub repository 23blocks-OS/ai-maestro-plugins (9 stars, last pushed 2d ago), licensed MIT. It adds 58 tokens to every session and 1,958 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 1 finding (enumerates other installed skills). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

coding-investigation

Investigate unfamiliar code behavior, or answer an exact symbol's definition, callers, callees, references, impact, and cross-repository relationship questions. Use it to trace activation, ownership, data flow, configuration, registration, and runtime wiring with bounded source evidence without mutating code; do not…

evoelsewhere/evoflux · 81 tokens

skill-installer

Create, import, update, validate, or relocate portable Agent Skill bundles with SKILL.md, on-demand references, deterministic scripts, output assets, UI metadata, and EvoFlux mode settings. Use for explicit skill authoring or installation; do not use for invoking an existing skill, changing agent configuration, or…

evoelsewhere/evoflux · 71 tokens

pdf

Read, create and manipulate PDF files — extract text and tables, merge, split, rotate, reorder and delete pages, read and fill AcroForm fields, add or strip metadata, encrypt and decrypt, and generate new PDFs from HTML or from scratch. Also covers rasterising pages to images so a PDF can actually be looked at, and…

smith-network-solutions/threadknot · 88 tokens

easd-implement

Implement bounded work for an active EASD run under its accepted specification and AC ownership. Use only when EASD has authorized implementation; do not use while the run is Intent, authoring, draft, or merely accepted.

evoelsewhere/evoflux · 51 tokens

easd-verify

Run the final EASD integration and evidence gate against accepted AC policies, then prepare a convergence recommendation. Use after implementation and any required independent review; not for task-local code review or ordinary tests outside EASD.

evoelsewhere/evoflux · 49 tokens

coding-debugging

Use this skill when a test, build, runtime path, integration, or concurrent workflow fails and the responsible condition is unknown. It is for reproducing symptoms, isolating a cause, fixing it when authorized, and proving the regression; do not use it for general code exploration, proactive review, or an…

evoelsewhere/evoflux · 71 tokens