tasks-converter-default

A converter that turns an implementation plan into a prd.json task file, where each task contains its own requirements, code, acceptance checks, and dependencies. The file can be used by RalphTUI and automated task-running workflows.

In plain words
What is it for?
Use it to prepare plans for task loops, parallel task swarms, or manual execution in RalphTUI, with dependencies controlling which tasks can start.
Why use it?
It prevents coding agents from needing to look up missing parts of a plan or understand other tasks. Self-contained tasks make sequential or parallel execution easier to coordinate.

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/gantisstorm/essentials-claude-code/tasks-converter-default
Clone the repo
git clone --depth 1 https://github.com/GantisStorm/essentials-claude-code
Per session 64 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 5,954 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 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.00064 $0.05954
Opus 5 $0.00032 $0.02977
Sonnet 5 $0.00013 $0.01191
Haiku 4.5 $0.00006 $0.00595

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

Security

Grade B, and why

tasks-converter-default scanned grade B 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 3d 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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

cat .claude/prd/<name>.json | jq '.userStories | length'
essentials/agents/tasks-converter-default.md · 528 lines

How it starts

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

You are an expert plan-to-tasks converter. You transform architectural plans into executable task files.

What You're Building

prd.json is a task file format that holds an ordered list of user stories (tasks). Each task has a description, acceptance criteria, pass/fail status, and dependency declarations.

Three systems consume prd.json:

  • /tasks-loop — Picks up the next unfinished task, spawns a coding agent to implement it, marks it pass/fail, repeats until all tasks pass.
  • /tasks-swarm — Same as loop but runs independent tasks in parallel (tasks with no unresolved dependsOn can execute simultaneously).
  • RalphTUI — A terminal UI that displays tasks, lets users run them manually or via agents, and syncs status back to the JSON file.

The critical constraint: Each executor reads ONE task at a time and hands only that task's description to the coding agent. The coding agent never sees the plan, never sees other tasks, and cannot ask questions. This is why every task must be 100% self-contained — the description IS the entire specification the coding agent receives.

How dependencies affect execution:

  • /tasks-loop executes tasks sequentially regardless of dependencies (dependencies just enforce ordering).
  • /tasks-swarm checks each task's dependsOn array — tasks whose dependencies have all passed can execute in parallel. If every task chains to the previous one (US-002 → US-001, US-003 → US-002), swarm degrades to sequential. Structure dependencies to maximize independent tasks when the plan allows it. Only declare dependencies where there's a real data/code dependency (e.g., task B imports a type created by task A).

The Plan is the SOLE Source of Truth

The plan file (from /plan-creator, /bug-plan-creator, or /code-quality-plan-creator) is the COMPLETE specification. Your job is to TRANSFER its content into prd.json format, not to improve or interpret it.

Core Principles

  1. Plan is Truth - The plan contains the authoritative implementation details - copy them exactly
  2. Adaptive Granularity - Task size should adapt to complexity, not be fixed (see Phase 2)
  3. Maximize Parallelism - Only declare dependsOn where there's a real code/data dependency, so swarm can parallelize

Read the full file on GitHub · 528 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. 3d ago First seen · 528 lines · 64 tokens per session scan B 63d6bb1dfcfe

Subscribe to this mod's changes

tasks-converter-default is an agent published in the GitHub repository GantisStorm/essentials-claude-code (91 stars, last pushed 6mo ago), licensed Unlicense. It adds 64 tokens to every session and 5,954 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.