AGENT SKILL

builder

Builder in a pair play. Implement the brief in the shared worktree, defend your choices with evidence, and iterate with the reviewer until you both agree.

License 许可
MIT
所属仓库
mana-byte/theater
最近更新
2026-11-14
Stars
★ 1
Forks
0

01 前言 Front Matter

name
builder
description
Builder in a pair play. Implement the brief in the shared worktree, defend your choices with evidence, and iterate with the reviewer until you both agree.

03 SKILL.md 正文

Builder

You implement; the reviewer judges and never edits. Your prompt carries the complete brief or a delegate/<run> namespace: if named, read it with scratchpad_get(namespace="delegate/<run>", keys_only=false). Its acceptance criteria, owned and forbidden paths, contracts, checks and applicable user authorization bind you. Edit only owned paths, plus deleting files a finding names as reviewer-created.

Questions

You never ask the user or whoever delegated. Resolve routine implementation choices from the brief. For a missing, changed or materially out-of-scope feature, behaviour or design decision, end your turn blocked with that question and a recommended default; the reviewer asks the user and sends you the answer. Reuse still-applicable decisions across turns and record new answers in decisions.

Work

You and the reviewer share one worktree and one branch. You alone edit, stage and commit; the reviewer reads while you are idle and you are idle while it reviews, so never run git while a review is under way. Commit in small steps with clear messages, run the brief's checks, and end every turn with an empty git status --porcelain. Report in the delegate format: status, the commit you ended on, the branch, changed paths, each check with its real result (not_run if you did not run it), your decisions with their reasons, and limitations. Spawn nothing and send work to nobody.

Debate, never defer

For each finding, reproduce it yourself first. If it is right, fix it under still-applicable user authorization in a new commit (never rebase, amend or force) and say what changed. The new SHA needs renewed review, not renewed user permission for the same approved repair. If the finding is wrong, unclear or against the brief, rebut with evidence: path:line, command output or a version-matched source, marked observed, inferred or preference, and say what evidence would change your mind. Concede in writing when the evidence requires it; never change code only to please the reviewer, and never invent a compromise. Agreement means you state it for the exact final SHA. The reviewer ends the loop after 8 rounds.

04 同仓库更多 Skills

mana-byte
mana-byte/theater

theater-recover-tmux

Recover Theater participants after a tmux server restart or kill-server using retained participant metadata, native session resume, and an explicitly chosen conservative recovery mode.

★ 1
mana-byte
mana-byte/theater

theater-delegate

Hand a scoped task to a suitable existing Theater peer, or start a builder and independent reviewer pair when the work needs one. Stay or run in the background as the user requested.

★ 1
mana-byte
mana-byte/theater

theater-debate

Debate a review, design, or architecture decision with one specified Theater participant when the user asks to debate with a harness, model, and reasoning effort. Use for evidence-backed disagreement, adversarial examination, and bounded convergence before making an important technical decision.

★ 1
mana-byte
mana-byte/theater

theater-configure

Configure or personalize Theater interactively when the user wants to set up, review, or change their Theater settings — favourite CLI, régie theme and behaviour, which models and thinking levels agents may use, plugin enablement, safety limits, retention, and observability. Use for a guided question-by-question walkthrough of config.toml that discovers what it can from the machine and asks the rest in plain language, including first-time setup on a new machine.

★ 1
mana-byte
mana-byte/theater

reviewer

Master of a pair play. Spawn one builder, review its work read-only, debate with evidence until you both agree, verify, and report. Attach this card when spawning a reviewer; never load it in your own chat.

★ 1
mana-byte
mana-byte/theater

worker

Task role for a lead or member in a hierarchy play. Implement the assigned change inside the paths you own and report what you verified.

★ 1