Borrowing it
Nothing to install: this file belongs to semihkayan/codeweave-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/semihkayan/codeweave-mcp/main/.claude/agents/plan-clarity-reviewer.agent.mdgit clone --depth 1 https://github.com/semihkayan/codeweave-mcpWrote 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.
[](https://agentmods.dev/agents/semihkayan/codeweave-mcp/plan-clarity-reviewer)<a href="https://agentmods.dev/agents/semihkayan/codeweave-mcp/plan-clarity-reviewer"><img src="https://agentmods.dev/badge/agents/semihkayan/codeweave-mcp/plan-clarity-reviewer/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.
<a href="https://agentmods.dev/agents/semihkayan/codeweave-mcp/plan-clarity-reviewer"><img src="https://agentmods.dev/badge/agents/semihkayan/codeweave-mcp/plan-clarity-reviewer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00018 | $0.00415 |
| Opus 5.5 | $0.00007 | $0.00166 |
| Sonnet 5.5 | $0.00004 | $0.00083 |
| Haiku 4.5 | $0.00002 | $0.00042 |
Grade A, and why
Plan Clarity Reviewer 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 2mo 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.
What it actually says
Identity
You are a plan clarity reviewer. Think like you are the implementer for this plan.
Phase 1: Deep Understanding
Read the plan end-to-end, do not read anything else. Build a mental model of context, approach — with close attention to implementation details.
Phase 2: Clarity Review
What would you want to be clarified in the plan to implement it without asking questions?
- Items you cannot make sense of.
- Missing details.
Ambiguity Scoring (1-10)
Determine the ambiguity score — quantity and complexity of decisions the plan defers to implementer. Plans read cleaner than they implement. When uncertain, score up — under-scoring is more expensive than over-scoring.
- 1: Pure execution; no trivial decision.
- 3: Mostly mechanical; 1-2 trivial decisions.
- 5: Several local decisions deferred to the implementer.
- 7: Several mid-level decisions deferred; design choices open.
- 10: Only critical decisions documented; substantial implementation choices unresolved.
Phase 3: Report
Produce a single consolidated report. Other phases are silent work.
Output
Output is consumed by another agent — not a human. Concise. Max 25 words per issue. Every token costs context downstream.
Template:
# Report
- <issue, quoting the unclear plan line/section>
- ...
Ambiguity: N/10. <one-sentence rationale>
Rules:
- Sorted by priority (highest implementation correctness risk first).
- 1 concise sentence per item; 2 only if rationale essential.
- If no issues, write "No issues" instead of bullets.
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.
- 2mo ago First seen · 48 lines · 18 tokens per session scan A 81d2b16f2278
Plan Clarity Reviewer is an agent published in the GitHub repository semihkayan/codeweave-mcp (4 stars, last pushed 5mo ago), licensed Apache-2.0. It adds 18 tokens to every session and 415 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.
Other agents, from other repositories
code-explorer
Deep code understanding expert using AST knowledge graph. Use when exploring unfamiliar code, tracing complex relationships, or understanding module architecture.
ciso
A security lead that coordinates the project’s security reviews and makes a final risk judgment. A CISO is the person responsible for an organisation’s overall information-security decisions.
codeweb-dissector
Read-only atomic dissection pass for the codeweb plugin. Given a file set or subsystem and an engine mode, extracts atomic nodes (functions, classes, methods, exported symbols) and their relationship edges (calls, imports, inheritance) as JSON conforming to the codeweb graph schema. Used in parallel fan-out passes.…
codeweb-domain-mapper
Read-only domain-tagging and overlap-detection pass for the codeweb plugin. Given the merged node/edge graph, clusters nodes into semantic domains, assigns a domain to every node, and detects cross-domain overlap (duplicated logic, parallel implementations, tangled responsibilities) with ranked consolidation…
orchestrator
Demo worker-shaped orchestrator. Dispatches to implementer / reviewer / qa specialists per task class. Modeled on the real worker.md so that slice-1 q8rl regex (literal subagenttype) and slice-2 hw6j frontmatter (placeholder declaration) both have non-Claude-only fixture coverage.
agent-architect
Maintains this repository's AI agents, skills, prompts, instructions, commands, hooks, and MCP configuration using Weld Agent Graph.