arn-code-planner

arn-code-planner is an agent for Claude Code from AppsVortex/arness. It costs 203 tokens per session (1,137 once invoked), scanned A, original, MIT.

A technical plan writer that turns decisions about a small bug fix into a structured document. It organizes requirements, architecture decisions, and codebase details but does not make the design decisions itself.

In plain words
What is it for?
Use it to prepare implementation instructions for a bug fix after the technical approach has already been decided.
Why use it?
It makes a fix easier to implement consistently by putting the agreed instructions in one complete plan. This is intended for small fixes that need a written plan first.

Agent for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: model in frontmatter; mentions Claude Code.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the arn-code plugin — 37 skills, 18 agents shipped together

Good fit Use it to prepare implementation instructions for a bug fix after the technical approach has already been decided.

Compare 6 agents from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add AppsVortex/arness
Claude Code
/plugin install arn-code

Made for: Claude Code.

Or install arn-code, the plugin that ships this one along with the rest of its 37 skills, 18 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 arn-code-planner

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

Your own site · 80×15
<a href="https://agentmods.dev/agents/appsvortex/arness/arn-code-planner"><img src="https://agentmods.dev/badge/agents/appsvortex/arness/arn-code-planner.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 203 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,137 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.00203 $0.01137
Opus 5.5 $0.00081 $0.00455
Sonnet 5.5 $0.00041 $0.00227
Haiku 4.5 $0.00020 $0.00114

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

Security

Grade A, and why

arn-code-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 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.

plugins/arn-code/agents/arn-code-planner.md · 99 lines

How it starts

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

Arness Planner

You are a technical plan writer that compiles architectural decisions, feature requirements, and codebase context into a structured draft plan document. Your output is a complete, self-contained plan ready to be saved as a file.

Note: This agent is used specifically for inline fix plans in the simple bug fix path (arn-code-bug-spec Step 6A). For feature plans and complex bug fix plans, Claude Code's native plan mode is used instead, informed by the /arn-code-plan command.

You are NOT an architect -- you do not make design decisions. You organize, structure, and write. The architectural reasoning has already been done by the arn-code-architect agent and refined through conversation with the user. Your job is to compile that into a clear, well-structured document.

Input

The caller provides:

  • Bugfix plan template: The structure to follow (from ${CLAUDE_PLUGIN_ROOT}/skills/arn-code-bug-spec/references/bugfix-plan-template.md)
  • Fix proposal: The refined feature description incorporating all decisions made during the conversation
  • Architectural proposals: Outputs from arn-code-architect invocations -- the initial proposal and any subsequent answers to specific questions
  • Codebase context summary: Relevant patterns, key files, and testing approach from the stored pattern documentation
  • Conversation decisions: A bulleted list of all decisions made during the exploration phase
  • Open items: Unresolved questions, risks, or areas needing investigation
  • Existing draft (optional): If revising an existing plan, the current draft content and the specific changes requested

Core Process

1. Read the template

Read the draft plan template to understand the target structure and section expectations. Every section in the template must appear in the output.

2. Map context to sections

For each section in the template:

  • Identify which pieces of the provided context belong there
  • If multiple sources provide overlapping information, prefer the most specific (architectural proposals over raw codebase context)
  • If no context is available for a section, note it in Open Items rather than leaving the section empty

Read the full file on GitHub · 99 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 · 99 lines · 203 tokens per session scan A df9fd6fb6022

Subscribe to this mod's changes

arn-code-planner is an agent published in the GitHub repository AppsVortex/arness (33 stars, last pushed 2mo ago), licensed MIT. It adds 203 tokens to every session and 1,137 once invoked, about $0.0008 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 agents, from other repositories

terraform-engineer

Infrastructure as Code specialist focused on Terraform development, module creation, state management, and multi-cloud provisioning. Expert in writing maintainable, reusable, and secure Terraform configurations for AWS and GCP.

andisab/swe-marketplace · 42 tokens

adapto-researcher

Content research specialist. Given ONE research angle (a competitor, a query cluster, a site crawl, a PAA/related-questions sweep), gathers from the web and returns structured, cited findings. Used by project-define discovery and content-research; runs many in parallel. Never writes content.

adaptocms/adapto-cms-agent-skills · 67 tokens

adapto-writer

On-brand long-form content writer. Executes ONE content brief into a complete Markdown draft with full frontmatter (SEO/OG/JSON-LD/internal links), matching the project's voice exactly. Used by content-create (dispatched at Opus for cornerstone briefs). Reads the brain + SEO standards; never touches the read-client.

adaptocms/adapto-cms-agent-skills · 70 tokens

adapto-editor

Content critic. Reviews ONE draft against its brief + the project brain and returns a concrete gap checklist (voice fit, SEO/AEO/GEO completeness, internal-link coverage, structural sanity, slop check). Used by content-create (verify pass) and content-plan. Does not rewrite — it critiques.

adaptocms/adapto-cms-agent-skills · 65 tokens

demand-generation

Demand Generation (CMO). Owns plugins/demand-generation/ and nothing else. Delegate work in this department's remit here.

cbrock84/headcount · 30 tokens

canvas-create-screens

Groups approved functional intent into task-oriented screens, in-screen states and navigation without choosing Canvas controls.

microsoft/power-platform-skills · 24 tokens