issue-planner

issue-planner is an agent for Claude Code from Jartan-LLC/grimoire. It costs 21 tokens per session (378 once invoked), scanned A, original, MIT.

An assistant that studies a GitHub issue and turns its requirements and project context into an implementation plan.

In plain words
What is it for?
It helps plan features and fixes, inspect related documentation and code, identify requirements, compare approaches, and produce actionable steps with file references.
Why use it?
It reduces guesswork by checking existing patterns, dependencies, constraints, and possible design choices before coding begins.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the praxis plugin — 16 skills, 7 agents shipped together

Good fit It helps plan features and fixes, inspect related documentation and code, identify requirements, compare approaches, and produce actionable steps with file references.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/jartan-llc/grimoire/issue-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/Jartan-LLC/grimoire

Made for: Claude Code.

Or install praxis, the plugin that ships this one along with the rest of its 16 skills, 7 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 issue-planner

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

Your own site · 80×15
<a href="https://agentmods.dev/agents/jartan-llc/grimoire/issue-planner"><img src="https://agentmods.dev/badge/agents/jartan-llc/grimoire/issue-planner.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 21 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 378 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.00021 $0.00378
Opus 5.5 $0.00008 $0.00151
Sonnet 5.5 $0.00004 $0.00076
Haiku 4.5 $0.00002 $0.00038

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

Security

Grade A, and why

issue-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/praxis/agents/issue-planner.md · 53 lines

What it actually says

You are an expert software architect specializing in planning implementations.

Core Mission

Analyze issue requirements, understand existing patterns, and design decisive implementation approaches that follow project conventions.

Planning Process

1. Context Gathering

  • Read relevant documentation in docs/ based on the issue area
  • Examine existing code patterns in similar areas
  • Understand module boundaries and how comparable features are implemented

2. Requirements Analysis

  • Extract explicit requirements from issue
  • Identify implicit requirements (error handling, testing, docs)
  • Note constraints and dependencies

3. Pattern Identification

  • Find existing implementations of similar features
  • Document patterns with file:line references
  • Note conventions that must be followed

4. Design Considerations

  • Flexibility -- Will this be used by other modules or downstream consumers? Design for maximum abstraction where reuse is likely, while keeping interfaces solid and well-defined.
  • Robustness -- Clear models, explicit types, proper error handling. Flexible internals, rigid contracts.
  • Future-proofing -- Consider how this might need to evolve without breaking changes.
  • Simplicity -- Don't over-engineer, but don't paint yourself into a corner either.

5. Solution Design

  • Design approach that follows existing patterns
  • Consider alternatives with trade-offs
  • Plan files to create/modify

Output Format

Follow the plan format from the gitwise:github-conventions skill (see plan-format.md). Be specific and actionable -- file paths, function names, concrete steps.

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 · 53 lines · 21 tokens per session scan A 3cfb08f56d1e

Subscribe to this mod's changes

issue-planner is an agent published in the GitHub repository Jartan-LLC/grimoire (2 stars, last pushed yesterday), licensed MIT. It adds 21 tokens to every session and 378 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-31.

Related

Other agents, from other repositories

catchup-runner

Does the catch-up fan-out, impact analysis, and brief assembly for /catchup on Sonnet (cheaper/faster than the caller's session). Spawned by the /catchup and /ketchup skills with a pre-resolved time window. Not user-invoked directly.

oliver-kriska/claude-elixir-phoenix · 63 tokens

arch-review

Principal-level software architect for architecture reviews, pre-implementation specification reviews, and spec-conformance verification. Use when the user asks to review architecture, evaluate design decisions, audit system boundaries, check for anti-patterns, evaluate whether a specification is ready to be…

sergeyklay/.agents · 122 tokens

diff-reviewer

Reviews an existing working-tree diff for correctness, scope creep, suppressed errors and shortcut fixes. Reports findings only — never edits. Use as a second opinion before the driver accepts a worker's changes.

aiskillstore/marketplace · 43 tokens

git-manager

Stage, commit, and push code changes with conventional commits. Use when user says "commit", "push", or finishes a feature/fix.

vanducng/skills · 32 tokens

devops-engineer

The DevOps Engineer maintains build pipelines, CI/CD configuration, version control workflow, and deployment infrastructure. Use this agent for build script maintenance, CI configuration, branching strategy, or automated testing pipeline setup.

tranhieutt/software_development_department · 45 tokens

commit

Use when: the owner wants to commit, save work, or release — the lead delegates ALL commits here, never runs git commit itself. Do NOT use for: read-only git ops (status/log/diff — run directly), non-commit code changes (domain expert + sniper own those).

fusengine/agents · 63 tokens