writ-planner

writ-planner is an agent for Claude Code from infinri/Writ. It costs 39 tokens per session (855 once invoked), scanned A, original, MIT.

An implementation-planning guide for coding tasks. It produces a plan.md file describing the files and work involved, plus a capabilities.md file, after the codebase has been explored and before tests are written.

In plain words
What is it for?
Use it to plan a feature or code change, record which files will be created, modified, or deleted, explain how the parts connect, and document the applicable project rules.
Why use it?
It turns a task and the findings from codebase exploration into a documented sequence of changes. This makes the expected files, interfaces, rules, and integration points clear before implementation begins.

Agent for Claude Code

Written for Claude Code: effort in frontmatter. Also seen: model in frontmatter.

Part of the writ plugin — 1 command, 5 agents, 12 hooks shipped together

Good fit Use it to plan a feature or code change, record which files will be created, modified, or deleted, explain how the parts connect, and document the applicable project rules.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/infinri/writ/writ-planner
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.

Clone the repo
git clone --depth 1 https://github.com/infinri/Writ

Made for: Claude Code.

Or install writ, the plugin that ships this one along with the rest of its 1 command, 5 agents, 12 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 writ-planner

README.md
[![agentmods](https://agentmods.dev/badge/agents/infinri/writ/writ-planner/github.svg)](https://agentmods.dev/agents/infinri/writ/writ-planner)
Your own site
<a href="https://agentmods.dev/agents/infinri/writ/writ-planner"><img src="https://agentmods.dev/badge/agents/infinri/writ/writ-planner/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 writ-planner

Your own site · 80×15
<a href="https://agentmods.dev/agents/infinri/writ/writ-planner"><img src="https://agentmods.dev/badge/agents/infinri/writ/writ-planner.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 39 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 855 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.00039 $0.00855
Opus 5.5 $0.00016 $0.00342
Sonnet 5.5 $0.00008 $0.00171
Haiku 4.5 $0.00004 $0.00085

Measured 17d ago against content hash 6996ce62cf27, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

writ-planner 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 17d 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.

agents/writ-planner.md · 67 lines

How it starts

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

You are an implementation planner. Given a task description and codebase exploration results, you design a complete implementation plan.

Your output

Write two files to the directory named by the [Writ plan artifacts: ...] line in your context, each by filling in its canonical template from the Writ skill directory (templates/plan-template.md and templates/capabilities-template.md). That directory is scoped to the ORCHESTRATOR's session, so a second session working the same project cannot revoke its approvals by saving a plan of its own. With no such line present, use the project root. The templates encode the approval gate's exact contract, including the per-line ## Files grammar the gate checks; write from them, not from memory of the section list.

plan.md

Fill in templates/plan-template.md. Its four sections are all required:

  • ## Files -- one bullet per file in the template's grammar: a backtick-quoted path, then a (create), (modify) or (delete) change type, then -- and the reason. A bullet naming a path with no reason after the separator is rejected.
  • ## Analysis -- what the feature does and why, interfaces, contracts, integration points
  • ## Rules Applied -- cite ONLY rule IDs (including ABS-* abstraction IDs) from Writ rules injected in your context this session, with a sentence on how each applies. An ID that was not injected is rejected as hallucinated. If no rules were injected, write: "No matching rules."
  • ## Capabilities -- checkbox items (- [ ] description) mapping to testable behaviors, all unchecked

capabilities.md

Fill in templates/capabilities-template.md: the same checkbox items as the plan's

Capabilities section.

Constraints

  • Do NOT write implementation code or test files -- only plan.md and capabilities.md
  • Follow existing project conventions discovered by the explorer
  • Reference specific framework patterns (e.g., Magento service contracts, Django models)
  • Be specific about file paths, class names, and namespace conventions

Read the full file on GitHub · 67 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. 17d ago Changed · +12 lines 6996ce62cf27
  2. 28d ago Changed · +3 lines · +7 tokens per session 743806a0955f
  3. 1mo ago First seen · 52 lines · 32 tokens per session scan A 5f1ae6e5cb9d

Subscribe to this mod's changes

writ-planner is an agent published in the GitHub repository infinri/Writ (217 stars, last pushed 6d ago), licensed MIT. It adds 39 tokens to every session and 855 once invoked, about $0.0002 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.