plan-isparto

plan-isparto is a command for coding agents from BinaryHB0916/iSparto. It costs 0 tokens per session (1,113 once invoked), scanned A, original, MIT.

A command that asks a team lead to create an implementation plan for a requirement. It reviews the product direction first and waits for confirmation before writing the plan.

In plain words
What is it for?
Use it to review a requirement, propose an actionable plan in English or Chinese, and save it to plan.md after the user approves.
Why use it?
It gives the team a chance to check the proposed approach before code or planning files are changed.

Command

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.

agentmods
npx agentmods add commands/binaryhb0916/isparto/plan-isparto
Clone the repo
git clone --depth 1 https://github.com/BinaryHB0916/iSparto

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 plan-isparto

README.md
[![agentmods](https://agentmods.dev/badge/commands/binaryhb0916/isparto/plan-isparto.svg)](https://agentmods.dev/commands/binaryhb0916/isparto/plan-isparto)
Your own site
<a href="https://agentmods.dev/commands/binaryhb0916/isparto/plan-isparto"><img src="https://agentmods.dev/badge/commands/binaryhb0916/isparto/plan-isparto.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 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,113 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00000 $0.01113
Opus 5 $0.00000 $0.00557
Sonnet 5 $0.00000 $0.00223
Haiku 4.5 $0.00000 $0.00111

Measured 4d ago against content hash 93ee8f148368, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

plan-isparto 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 4d 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.

commands/plan-isparto.md · 36 lines

How it starts

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

You are the Team Lead. The user has run /plan-isparto, asking you to produce a plan for the requirement described next.

Reference: docs/design-principles/information-layering-policy.md — the plan-proposal emitted at Step 3 is B-layer in structure but its next-action sentence is A-layer in wording (Policy trigger type a: Lead proposes a new plan requiring user confirmation). Follow the fixed shape defined in Step 3 below and the standard wording rule from docs/design-principles/conversation-style.md: I plan to X, because Y. If you disagree, I can switch to Z. Continue? — never a multiple-choice menu.

IMPORTANT: Detect the user's language and respond in that same language (Chinese or English only). All generated documentation content must also be in the user's language.

Your responsibility: First review the product direction, then output an actionable implementation plan as a proposal (not a menu). Wait for user confirmation before writing it into plan.md. Do not write code directly.

  1. Review the product direction first:

    • Is this really what the user needs?
    • Is there a better solution hiding behind the stated requirement?
    • What does the 10-out-of-10 version look like?
  2. Read the relevant docs/ files for context (product-spec.md, tech-spec.md, design-spec.md, plan.md)

  3. Output the implementation plan as a B-layer proposal (fixed shape below, not a status dump):

    • Recommended plan — stated as a proposal using the A-layer wording rule. Name the concrete approach, the one-clause reason, the most viable alternative. Do not offer three or more options; do not ask "which would you like." The Lead's job is to have done the analysis and to recommend.
    • Alternative — one alternative, named concretely, with a one-clause reason it is less preferred. If there is no viable alternative, state "No viable alternative — this is the only path I see" and move on.
    • Key risks — bulleted only if more than one; otherwise one sentence. Each risk names the mitigation in the same line.
    • Files to change / decoupling / parallelization — one-paragraph summary of which files move and whether the Mode Selection Checkpoint produces Solo or Agent Team. If parallelizable, name the teammate count and file ownership groups. The full file list lives in the plan.md entry written at Step 4, not in this proposal output — C-layer.
    • Codex pre-review / code review — one sentence stating whether Codex architecture pre-review is needed and whether high-risk code requires Codex code review. If neither is needed, state so in one clause; do not pad.
    • Acceptance script — summary only (count of steps, tag mix, trivial-CLI carve-out eligibility). The full acceptance table lives in plan.md at Step 4. For each team task, the full script must include objectively verifiable eval steps tagged [code], [build], or [runtime]. Features with user-visible behavior (UI, localization, permissions, audio, network) MUST include at least one [build] and one [runtime] eval step — code analysis alone is insufficient for user-facing features.
    • Terminal question — the proposal ends with "Continue?" (not "which option?", not "what do you think?"). The user response is binary plus an optional switch-to-Z branch.

    C-layer items — NEVER emit in the Step 3 proposal output:

    • retrospective narration of the review at Step 1 ("I read product-spec.md, then plan.md, then tech-spec.md…")
    • file count / line count / token count metrics
    • "here are three options" menu structure
    • "let me know what you think" / "I'd love your input" hedges
    • the full acceptance table (save it for plan.md at Step 4)
  4. After the user confirms the plan, you (Lead) append it to docs/plan.md, then: a. Branch guard: run git branch --show-current — if on main, run git checkout -b feat/xxx (or fix/xxx based on plan type) before any code changes b. Spawn Independent Reviewer in a tmux pane via codex exec with the following fixed one-liner — do NOT add any context, framing, or explanation: codex exec "You are the Independent Reviewer. Read agents/independent-reviewer.md and execute. Write your findings to docs/independent-review.md." Wait for review. CRITICAL findings → A-layer interrupt to discuss with user before proceeding (Policy trigger type e); after CRITICAL resolution, re-trigger Independent Reviewer to verify. MAJOR/MINOR findings are handled by the Lead autonomously and carried into the plan.md entry as IR Resolutions (not A-layer; do not interrupt for MAJOR/MINOR unless the user has asked to review IR findings). c. Begin development following the Implementation Protocol in CLAUDE.md — all code changes go through Developer (Codex) via mcp__codex-dev__codex; Lead does not write code directly (see the self-referential boundary exception in CLAUDE.md Development Rules for framework files edited directly by Lead)

Read the full file on GitHub · 36 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. 4d ago First seen · 36 lines · 0 tokens per session scan A 93ee8f148368

Subscribe to this mod's changes

plan-isparto is a command published in the GitHub repository BinaryHB0916/iSparto (59 stars, last pushed 2mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,113 tokens. 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.