plan

plan is a skill for Claude Code, Codex from andyrids/icm-spec. It costs 26 tokens per session (394 once invoked), scanned A, original, Apache-2.0.

A set of rules for creating, updating, and closing Markdown plan files in `plans/`. These files record the work, its status, its technical specification links, its validation checks, and its follow-up notes.

In plain words
What is it for?
Use it when starting or completing a plan, setting valid status and metadata, documenting scope and risks, and recording validation results.
Why use it?
It prevents plans from becoming inconsistent or losing the information needed to track and verify work.

Skill for Claude CodeCodex

Part of the icm plugin — 8 skills, 1 agent, 5 hooks shipped together

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.

agentmods
npx agentmods add skills/andyrids/icm-spec/plan
Any agent
npx skills add andyrids/icm-spec --skill plan
Clone the repo
git clone --depth 1 https://github.com/andyrids/icm-spec

Made for: Claude Code, Codex.

Or install icm, the plugin that ships this one along with the rest of its 8 skills, 1 agent, 5 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 plan

README.md
[![agentmods](https://agentmods.dev/badge/skills/andyrids/icm-spec/plan.svg)](https://agentmods.dev/skills/andyrids/icm-spec/plan)
Your own site
<a href="https://agentmods.dev/skills/andyrids/icm-spec/plan"><img src="https://agentmods.dev/badge/skills/andyrids/icm-spec/plan.svg" alt="Measured on agentmods" height="20"></a>
Per session 26 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 394 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00026 $0.00394
Opus 5 $0.00013 $0.00197
Sonnet 5 $0.00005 $0.00079
Haiku 4.5 $0.00003 $0.00039

Measured 4d ago against content hash 054abc8ff595, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

plan 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 4d 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.

skills/plan/SKILL.md · 33 lines

What it actually says

Working under plans/

plans/ is the planning system - one file per unit of work, frozen at status: done as the durable record. The full protocol, frontmatter contract and closeout steps are plans/README.md. Read it before writing.

The rules that bite most often:

  • Frontmatter is queried, so it must stay exact: status is one of planned | in-progress | done | blocked | cancelled; specs: and authors: paths must resolve; the Layer 4 hierarchy keys are present.
  • The two spec fields answer different questions. specs: means this plan brings code into conformance and stage 03 verifies against it; authors: means this plan writes the spec and changes no behaviour. One field, never both - over-listing specs: silently defeats the coverage invariant, which is how it died the first time.
  • Body section order is fixed: Scope, Implements, Approach, Validation, Risks / unknowns, Notes, Follow-ups. Validation supplies the requirement identifiers stage 03 reports against, and its criteria are written in EARS (ICM/_config/reference-standard-validation.md).
  • At closeout, tick a Validation box only where evidenced; an unticked box with a reason in Notes beats a ticked one that was never checked.
  • A Deferred to follow-up edits the named downstream plan in the same commit, or the work is lost between two documents.

Plans are opened by ICM stage 01 (/icm:specify) and frozen by stage 04 (/icm:document).

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. 4d ago First seen · 33 lines · 26 tokens per session scan A 054abc8ff595

Subscribe to this mod's changes

plan is a skill published in the GitHub repository andyrids/icm-spec (2 stars, last pushed 16d ago), licensed Apache-2.0. It adds 26 tokens to every session and 394 once invoked, about $0.0001 per session on Opus 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-31.

Related

Other skills, from other repositories

tldr

Generate a review-oriented TLDR of GitHub Spec Kit artifacts (spec.md and/or plan.md) as a self-contained HTML dashboard plus a Markdown version, to make reviewing those files in a pull request faster. Use this skill whenever the user wants to review, summarize, "TLDR", skim, or get an overview of a Spec Kit spec.md…

qurore/speckit-tldr · 141 tokens

tldr-delete

Remove generated speckit-tldr output — the .tldr.html and .tldr.md files and the specs/ /tldr/ directories that hold them — so these local review artifacts are not committed into a pull request. Use this skill whenever the user wants to delete, remove, clean, clear, or "clean up" the TLDRs that the tldr skill…

qurore/speckit-tldr · 123 tokens

gsd-audit-milestone

Audit milestone completion against original intent before archiving.

open-gsd/gsd-core · 17 tokens

spec-kitty-charter-doctrine

Run charter interview, generation, context, and sync workflows for project governance in Spec Kitty 3.x. Access doctrine artifacts programmatically via DoctrineService. Resolve agent profiles. Load action-scoped governance context iteratively, not all at once. Triggers: "interview for charter", "generate charter"…

Priivacy-ai/spec-kitty · 135 tokens

conductor-implement

Executes the tasks defined in the specified track's plan. Use this to start or continue working on a feature, bug fix, or chore.

gemini-cli-extensions/conductor · 34 tokens

ideogram-ultra

Build Ideogram 4 (Ideogram Ultra) txt2img and img2img workflows with the local open-weights model, dual conditional/unconditional models with DualModelGuider, Qwen3-VL text encoder, and structured JSON ("compositional deconstruction") prompts for strong text rendering and layout control.

artokun/comfyui-mcp · 68 tokens