agentware: Agent for Claude Code

.claude/agents/agentware-planner.md

agentware-planner is an agent for Claude Code from r5rana/agentware. It costs 63 tokens per session (1,697 once invoked), scanned A, original, Apache-2.0.

A planning assistant for an agentware workspace, where agentware is a framework that turns written task plans into later automated work.

In plain words
What is it for?
For scoping features, writing and revising work/plan.md files, and handing an approved plan to the agentware execution loop.
Why use it?
It helps turn a feature idea into a detailed plan while keeping planning separate from implementation, so execution does not start before the plan is approved.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: reads .claude/ paths.

This is r5rana/agentware's own configuration. It tells Claude Code how to work on agentware itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything agentware configures →

Reuse

Borrowing it

Nothing to install: this file belongs to r5rana/agentware. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/r5rana/agentware/main/.claude/agents/agentware-planner.md
Clone the repo
git clone --depth 1 https://github.com/r5rana/agentware

Made for: Claude Code.

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 agentware-planner

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

Your own site · 80×15
<a href="https://agentmods.dev/agents/r5rana/agentware/agentware-planner"><img src="https://agentmods.dev/badge/agents/r5rana/agentware/agentware-planner.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 63 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,697 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.00063 $0.01697
Opus 5.5 $0.00025 $0.00679
Sonnet 5.5 $0.00013 $0.00339
Haiku 4.5 $0.00006 $0.00170

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

Security

Grade A, and why

agentware-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.

.claude/agents/agentware-planner.md · 119 lines

How it starts

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

You are agentware Planner — your only job is to help the user produce high-quality plan.md files in an agentware workspace. agentware Execution implements them later. agentware is a clone-and-go AI context + task-execution framework that is cloud- and language-agnostic.

🔴 ABSOLUTE RULE: YOU NEVER EXECUTE

When the user approves a plan, you DO NOT start working on it. You hand off and stop. When the plan is approved and saved, respond with:

✅ Plan saved to <knowledge-dir>/work/<YYMMDD-feature-name>/plan.md

To execute this plan, run:

./agentware.sh <YYMMDD-feature-name>

Even if the user says "go ahead", "do it", "start", or "execute" — respond: "I'm the planner. Run ./agentware.sh <feature> to start execution." After plan approval you ONLY: iterate on the plan, answer questions, save updated versions.

First-run gate

Check whether the external knowledge dir is configured AND initialized (resolve with scripts/agentware config --knowledge-dir-only; the AGENTWARE_STATUS line reports it). If NOT, STOP and run the onboarding flow in .claude/skills/onboarding/SKILL.md first. If it is, proceed with planning.

What planning mode means

You DO NOT create infrastructure, modify application code, or deploy anything. You DO have full read/research/Bash (read-only) capability and you are TRUSTED to use it so the plan is informed and unambiguous. The distinction is INTENT, not capability: use your tools to inform the plan, not to do the work. The only file you write is the plan.md (and optional design.md).

What you SHOULD do

  • Run read-only shell commands to explore the filesystem, check tool versions.
  • Read files across the workspace to understand what exists and how it works.
  • Read the external knowledge base and <knowledge-dir>/work/ for prior plans and gotchas.
  • Write the plan.md file when ready.

What you DO NOT do

  • Do NOT create/modify/delete resources or modify application source code.
  • Do NOT mark plan tasks complete, and do NOT execute the plan.
  • Do NOT start implementing when the user says "yes", "approved", "go ahead".

Read the full file on GitHub · 119 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 · 119 lines · 63 tokens per session scan A 5c3defd4535c

Subscribe to this mod's changes

agentware-planner is an agent published in the GitHub repository r5rana/agentware (24 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 63 tokens to every session and 1,697 once invoked, about $0.0003 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

playwright-test-generator

Use this agent when you need to create automated browser tests using Playwright Examples: Context: User wants to generate a test for the test plan item.

microsoft/playwright · 151 tokens

.NET-Notebook-Migration-Agent

Expert .NET and documentation transformation agent that migrates Polyglot Jupyter notebooks into clean Markdown and companion .NET sample code.

microsoft/ai-agents-for-beginners · 33 tokens

AVM Owner Triage

Triage open GitHub issues across the Azure Verified Modules (AVM) repos an owner maintains. Splits the backlog into a Copilot-delegatable pile and a human pile, produces a report with a delegation ratio, and never comments or assigns without explicit user approval.

github/awesome-copilot · 61 tokens

Ultimate Transparent Thinking Beast Mode

Agent "Ultimate Transparent Thinking Beast Mode" from github/awesome-copilot, covering quantum cognitive architecture, phase 2: adversarial intelligence & red-team analysis, phase 3: implementation & iterative refinement and phase 4: comprehensive verification & completion.

github/awesome-copilot · 11 tokens

Context7-Expert

Expert in latest library versions, best practices, and correct syntax using up-to-date documentation.

github/awesome-copilot · 22 tokens

code-reviewer

Performs thorough code reviews for the Notebooks in the Cookbook repo, focusing on Python/Jupyter best practices, and project-specific standards. Use this agent proactively after writing any significant code changes, especially when modifying notebooks, Github Actions, and scripts.

anthropics/claude-cookbooks · 52 tokens