plan-schema

plan-schema is a skill for Claude Code from GantisStorm/essentials-claude-code. It costs 29 tokens per session (2,976 once invoked), scanned A, original, Unlicense.

A reference for the Markdown format used to describe implementation plans in `.claude/plans/` files.

In plain words
What is it for?
Use it when creating, editing, or validating plans for features, bug fixes, or code-quality work.
Why use it?
It keeps plans structured so other tools can execute them directly or convert them into task lists or Beads issues. Beads is a git-backed issue tracker.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the essentials plugin — 5 skills, 25 commands, 8 agents shipped together

Good fit Use it when creating, editing, or validating plans for features, bug fixes, or code-quality work.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/gantisstorm/essentials-claude-code/plan-schema
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 GantisStorm/essentials-claude-code --skill plan-schema
Clone the repo
git clone --depth 1 https://github.com/GantisStorm/essentials-claude-code

Made for: Claude Code.

Or install essentials, the plugin that ships this one along with the rest of its 5 skills, 25 commands, 8 agents.

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 plan-schema

README.md
[![agentmods](https://agentmods.dev/badge/skills/gantisstorm/essentials-claude-code/plan-schema/github.svg)](https://agentmods.dev/skills/gantisstorm/essentials-claude-code/plan-schema)
Your own site
<a href="https://agentmods.dev/skills/gantisstorm/essentials-claude-code/plan-schema"><img src="https://agentmods.dev/badge/skills/gantisstorm/essentials-claude-code/plan-schema/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for plan-schema

Your own site · 80×15
<a href="https://agentmods.dev/skills/gantisstorm/essentials-claude-code/plan-schema"><img src="https://agentmods.dev/badge/skills/gantisstorm/essentials-claude-code/plan-schema.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,976 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. 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.00029 $0.02976
Opus 5.5 $0.00012 $0.01190
Sonnet 5.5 $0.00006 $0.00595
Haiku 4.5 $0.00003 $0.00298

Measured 1mo ago against content hash d166d22e37df, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

plan-schema scanned grade A with 0 findings 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 1mo 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

essentials/skills/plan-schema/SKILL.md · 347 lines

How it starts

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

Plan file schema reference for architectural plans created by /plan-creator, /bug-plan-creator, and /code-quality-plan-creator. Use this when creating, editing, or reviewing .claude/plans/*-plan.md files.

When to Use

Invoke /plan-schema before manually editing any plan file. Invoke /plan-schema validate <path> to check an existing plan.

Core Concepts

Plans are markdown files in .claude/plans/ that specify HOW to implement a feature, fix, or improvement. They are consumed by:

  • /plan-loop and /plan-swarm — execute plans directly
  • /tasks-converter — converts to prd.json for /tasks-loop, /tasks-swarm, or RalphTUI
  • /beads-converter — converts to beads for /beads-loop, /beads-swarm, or RalphTUI

Conversion Pipeline

Plans are the intermediate representation between creators and executors:

/plan-creator (or /bug-plan-creator, /code-quality-plan-creator)
    ↓ writes
.claude/plans/{slug}-{hash5}-plan.md
    ↓ consumed by (choose one)
    ├─ /plan-loop or /plan-swarm        → executes plan directly
    ├─ /tasks-converter <plan-path>     → .claude/prd/<slug>.json
    │       ↓ executed by
    │       /tasks-loop or /tasks-swarm or ralph-tui
    └─ /beads-converter <plan-path>     → .beads/ (bd CLI issues)
            ↓ executed by
            /beads-loop or /beads-swarm or ralph-tui

Direct execution (/plan-loop, /plan-swarm) reads the plan file and implements each file entry in dependency order. No intermediate format needed.

Converted execution (/tasks-converter, /beads-converter) transforms the plan into prd.json or beads. Each task/bead gets a 100% self-contained description — the executor agent receives only the task description, never the source plan. All code, requirements, and verification commands are copied verbatim from the plan.

File Naming

.claude/plans/{slug}-{hash5}-plan.md
Creator Pattern Example
/plan-creator {feature-slug}-{hash5}-plan.md oauth2-authentication-a3f9e-plan.md
/bug-plan-creator bug-plan-creator-{identifier}-{hash5}-plan.md bug-plan-creator-auth-null-pointer-4k2m7-plan.md
/code-quality-plan-creator code-quality-{filename}-{hash5}-plan.md code-quality-auth_service-3m8k5-plan.md

Read the full file on GitHub · 347 lines

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. 1mo ago First seen · 347 lines · 29 tokens per session scan A d166d22e37df

Subscribe to this mod's changes

plan-schema is a skill published in the GitHub repository GantisStorm/essentials-claude-code (90 stars, last pushed 8mo ago), licensed Unlicense. It adds 29 tokens to every session and 2,976 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

dekko-verify

Sanity-check a suspiciously low or zero call-graph result from dekko (getcallers, getcallees, findusages, impactedtests, unused) before concluding "no callers" or "dead code," or a heritage/throws-provenance result (query supertypes, query subtypes, query throws) that labels something (external) when you expect it to…

aahlijia/dekko · 151 tokens

dekko-daemon

Start dekko's background daemon before a session that will run many bare dekko CLI commands via Bash (not the MCP tools) against a large or medium repo. Trigger when you're about to run several dekko CLI invocations in a row on the same repo — a long refactor loop, a batch of query/search/outline calls, or a…

aahlijia/dekko · 94 tokens

dekko-delegate

Brief a subagent with dekko's map before dispatching it into a repo that has a .dekko/ directory. Trigger before any Agent/Task tool call, Workflow agent(), teammate message, or scripted claude -p run that will explore, review, implement, or test in such a repo. A subagent starts with an empty context and no…

aahlijia/dekko · 127 tokens

dekko-notes

Read and write dekko's symbol-anchored notes in any repo with a .dekko/ directory. Trigger every time you pull a symbol's context (querysymbol, getcontextpack, dekko query/context), right after a non-obvious change, and right after any rename/move/signature edit (to sweep orphaned notes). Notes are durable, committed…

aahlijia/dekko · 94 tokens

dekko-orient

Use dekko's tools instead of grep/Read whenever a repo has a .dekko/ directory — not just at session start. Trigger before any Grep/Glob/Read of a source file, before a grep/rg/find/cat in Bash, and on any "find/locate/understand this symbol," "what does this file/dir contain," "who calls this," "what will this change…

aahlijia/dekko · 141 tokens

dekko-refactor

List every site a rename, move, or signature change must touch before editing, then prove nothing was missed after. Trigger when about to rename a function, method, class or type, rename or move a file or module, change a parameter list or return type, move a symbol between files, or remove a symbol, in a repo with a…

aahlijia/dekko · 125 tokens