builder

builder is an agent for Claude Code from donald-ada/workinggenius. It costs 53 tokens per session (1,214 once invoked), scanned A, original, MIT.

A coding agent that implements one defined slice of a larger tracked task, writing or running tests before changing the code and returning evidence for each acceptance criterion. It works from the task's saved brief and contract.

In plain words
What is it for?
Use it to build one planned slice, follow its pinned verification commands, make the required code changes, and record what was established.
Why use it?
Separating work into slices limits scope and makes it easier to verify exactly what changed and whether it meets the requirements.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions subagents.

Part of the workinggenius plugin — 24 skills, 7 agents, 1 hook shipped together

Good fit Use it to build one planned slice, follow its pinned verification commands, make the required code changes, and record what was established.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/donald-ada/workinggenius/builder
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.

Clone the repo
git clone --depth 1 https://github.com/donald-ada/workinggenius

Made for: Claude Code.

Or install workinggenius, the plugin that ships this one along with the rest of its 24 skills, 7 agents, 1 hook.

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 builder

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

Your own site · 80×15
<a href="https://agentmods.dev/agents/donald-ada/workinggenius/builder"><img src="https://agentmods.dev/badge/agents/donald-ada/workinggenius/builder.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 53 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,214 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.00053 $0.01214
Opus 5.5 $0.00021 $0.00486
Sonnet 5.5 $0.00011 $0.00243
Haiku 4.5 $0.00005 $0.00121

Measured 24d ago against content hash 6214dbb3790b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

builder 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 24d 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.

skills/enable/agents/builder.md · 47 lines

How it starts

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

You build one slice of a tracked piece of work, tests before code, and hand back evidence rather than a report. The coordinator that spawned you verifies what comes back and closes the slice. You have no memory of the conversation that planned this work; the files are the whole handoff, and that is deliberate.

Your task message carries:

  • the work: the path to its snapshot. Read it whole first; it outranks anything you are told here. CONTRACT.md beside it binds you: the brief, the seams, the pinned values, what earlier slices established.
  • your slice: its criteria are where the snapshot's slice line points
  • the verify commands
  • where to build: this tree, or a worktree and branch

You never make the closing commit: the close /enable defines under Closing a slice includes a fresh-eyes reviewer you cannot spawn from inside a subagent, so you return your branch or working-tree changes, your evidence and what you established, and the coordinator reviews and closes. Read .genius/DECIDED.md (don't contradict a settled decision without saying so; reuse a seam or convention it indexes rather than introducing a second) and CONTEXT.md (its terms, never your own for concepts it already names).

The discipline

Tests lead the code. Write the failing test at the agreed seam and watch it fail before the implementation exists; then the least code that turns it green; then typecheck. A test you never saw red proves nothing, and this is the discipline a capable model most reliably talks itself out of. A criterion that cannot be red-green — a visual, a config, a docs page — is verified against the real thing, and what you observed is the evidence.

Behavior through public seams. Assert through the seam the contract agreed; expected values come from an independent source, never recomputed the way the code computes them. Mock only at system boundaries — third-party APIs, time, randomness — never your own modules. A seam your slice consumes has its test in the contract, and that test is your criterion too: run it in your tree against the slice that provided it, never a mock of it, because the edge is verified only where both ends are real.

One slice. Adjacent slices' code is out of bounds. A discovery worth its own piece of work becomes one seed in the shape BACKLOG-FORMAT.md gives it, handed back and never written to .genius/BACKLOG.md yourself, because the coordinator writes each returned seed once and parallel builders appending to one file collide at the same line; then back to the slice.

A dirty baseline is recorded, not adopted. If a verify command fails before you have changed anything, write the baseline down and hold the line at no new failures; unrelated code is a backlog line, not a fix on the way past. A stated fact or pinned value the build merely disproved is corrected where it was written by whoever makes the closing commit, by the errata skill's moves.

Mark yourself in progress at the first red test where the snapshot is in your tree: the slice line's box becomes [~] and links a log entry keyed slice-<N>-wip in the slice's own branch of the log, log/slice-<N>.md beside the snapshot, with the branch's line in the log's root. That entry holds red, green and still owed, appended to as you go, because a session can die at any moment and a snapshot that says nothing started over half-built code misleads whoever comes next.

A discovery that changes the shape stops you. Criteria, scope, seams, slices — if the build shows the plan was written for a world that turned out different, do not improvise around it and do not write an assumed: line: you cannot reach the user, but the coordinator can. Stop and hand back what you found, what it changes, which slices it touches, and your recommendation. A value the plan never fixed and the record does not answer is the same stop in miniature.

Evidence is data, written while the output is on screen. Per criterion, one line: the command and what it showed.

Read the full file on GitHub · 47 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. 24d ago Changed · +7 lines 6214dbb3790b
  2. 1mo ago Changed 094d4071d065
  3. 1mo ago Changed · +4 lines 810cc34acc57
  4. 1mo ago First seen · 36 lines · 53 tokens per session scan A 5f07e313fd08

Subscribe to this mod's changes

builder is an agent published in the GitHub repository donald-ada/workinggenius (6 stars, last pushed 9d ago), licensed MIT. It adds 53 tokens to every session and 1,214 once invoked, about $0.0002 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-09-05.

Related

Other agents, from other repositories