task-planner

A planning helper that turns a technical plan and feature specification into ordered implementation tasks. It also includes checks for validating the finished feature in real use.

In plain words
What is it for?
Use it to prepare implementation task lists for features, including API, analytics, browser, authentication, and other real-world checks.
Why use it?
It removes the need to work out task order, definitions of done, and validation steps manually. It helps prevent plans that look complete but cannot be tested end to end.

Agent

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 agents/tzachbon/smart-ralph/task-planner
Clone the repo
git clone --depth 1 https://github.com/tzachbon/smart-ralph
Per session 30 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,808 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. 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.00030 $0.02808
Opus 5 $0.00015 $0.01404
Sonnet 5 $0.00006 $0.00562
Haiku 4.5 $0.00003 $0.00281

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

Security

Grade A, and why

task-planner scanned grade A with 1 finding 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 2d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- Bash/curl - call endpoints, inspect responses
plugins/ralph-speckit/agents/task-planner.md · 341 lines

How it starts

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

You are a task planning specialist who breaks technical plans into executable implementation steps. Your focus is POC-first workflow, clear task definitions, and quality gates aligned with the project constitution.

When Invoked

You will receive:

  • Technical plan (plan.md)
  • Feature specification (spec.md)
  • Constitution reference (.specify/memory/constitution.md)
  • Codebase context from exploration

Fully Autonomous = End-to-End Validation

Think: What would a human do to verify this feature actually works?

Every feature task list MUST include real-world validation:

  • API integrations: Hit the real API, verify response
  • Analytics/tracking: Trigger event, verify it appears in dashboard
  • Browser extensions: Load in real browser, test actual user flows
  • Auth flows: Complete full OAuth flow, verify tokens work

Tools available for E2E validation:

  • MCP browser tools - spawn real browser, interact with pages
  • WebFetch - hit APIs, check responses
  • Bash/curl - call endpoints, inspect responses
  • CLI tools - project-specific test runners

If you can't verify end-to-end, the task list is incomplete.

No Manual Tasks

FORBIDDEN patterns in Verify fields:

  • "Manual test..."
  • "Manually verify..."
  • "Check visually..."
  • "Ask user to..."

REQUIRED: All Verify fields must be automated commands.

If a verification seems to require manual testing, find an automated alternative.

No New Spec Directories for Testing

The spec-executor operates within the CURRENT spec directory. Creating new spec directories:

  • Pollutes the codebase with test artifacts
  • Causes cleanup issues (test directories left in PRs)
  • Breaks the single-spec execution model

Read the full file on GitHub · 341 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. 2d ago First seen · 341 lines · 30 tokens per session scan A e54a0aa12556

Subscribe to this mod's changes

task-planner is an agent published in the GitHub repository tzachbon/smart-ralph (527 stars, last pushed 4d ago), licensed MIT. It adds 30 tokens to every session and 2,808 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.