Write and lint a delegation brief
Gate: none. A brief is the input of every delegated step of L0-understand to L10-lessons; the contract is C02.
- Create the brief and its ledger row (the ledger is
<coordination_root>/delegation/ledger.md):
python "${CLAUDE_PLUGIN_ROOT}/scripts/batuta.py" brief new --slug SLUG --topic TOPIC --agent AGENT --title "TITLE"
AGENT is any agent of the plugin (searcher, runner, implementer, test-author, doc-writer, adversary, reviewer) or
general-purpose. Use --agent test-author for a red step and --agent adversary for a gate check; the model and the kind
come from the agent file. Add --sizing PATH for a product, and --model only for an escalation you can justify.
- Fill every
<fill: ...> slot: goal, context, definitions, the files in scope, numbered deliverables (D1, D2, ...),
checks (C1, C2, ...) each with a backticked command, the working directory, the report path. Implement, job and
skeleton briefs also carry the contract-first sections: contracts, invariants, missing-data behavior, environment.
- Lint it until it passes:
python "${CLAUDE_PLUGIN_ROOT}/scripts/batuta.py" brief lint BRIEF
- Launch it with the
delegate skill. Never launch an agent on a brief that has not passed lint.
On a non-zero exit: exit 1 is a refusal (an unfilled slot, a missing section, a check without a command): fix the brief
and lint again. Exit 2 is a warning (an escalation, the fable model, more than eight deliverables, a write scope that
overlaps another open brief): resolve it or write the reason into the brief.
1---2name: brief3description: "Use when about to hand work to an agent: write the brief first. Creates a brief from the template with its ledger row and lints it before launch."4allowed-tools: Bash(python *scripts/batuta.py* *) Bash(py *scripts/batuta.py* *) Read Grep Glob Edit Write5argument-hint: <topic> <agent>6metadata:7 source: https://skillmd.com/skills/fsantibanezleal/brief8---910# Write and lint a delegation brief1112Gate: none. A brief is the input of every delegated step of L0-understand to L10-lessons; the contract is C02.13141. Create the brief and its ledger row (the ledger is `<coordination_root>/delegation/ledger.md`):15 `python "${CLAUDE_PLUGIN_ROOT}/scripts/batuta.py" brief new --slug SLUG --topic TOPIC --agent AGENT --title "TITLE"`16 AGENT is any agent of the plugin (searcher, runner, implementer, test-author, doc-writer, adversary, reviewer) or17 general-purpose. Use `--agent test-author` for a red step and `--agent adversary` for a gate check; the model and the kind18 come from the agent file. Add `--sizing PATH` for a product, and `--model` only for an escalation you can justify.192. Fill every `<fill: ...>` slot: goal, context, definitions, the files in scope, numbered deliverables (D1, D2, ...),20 checks (C1, C2, ...) each with a backticked command, the working directory, the report path. Implement, job and21 skeleton briefs also carry the contract-first sections: contracts, invariants, missing-data behavior, environment.223. Lint it until it passes:23 `python "${CLAUDE_PLUGIN_ROOT}/scripts/batuta.py" brief lint BRIEF`244. Launch it with the `delegate` skill. Never launch an agent on a brief that has not passed lint.2526On a non-zero exit: exit 1 is a refusal (an unfilled slot, a missing section, a check without a command): fix the brief27and lint again. Exit 2 is a warning (an escalation, the fable model, more than eight deliverables, a write scope that28overlaps another open brief): resolve it or write the reason into the brief.