a73x

03661841

docs: require plan-first delegated changes

a73x   2026-09-07 16:16

Commit message
docs: require plan-first delegated changes
AGENTS.md
Old New
@@ -1,5 +1,29 @@
1 # Agent instructions 1 # Agent instructions
2 2
3 ## Plan first; main agent coordinates
4
5 These rules apply to the top-level agent. Delegated workers may implement
6 their approved briefs.
7
8 - Begin change requests with read-only inspection and a proposed plan.
9 Do not edit files or run builds/tests before the user approves it.
10 - Plans must specify behavior, scope, file ownership, acceptance checks,
11 and the model and reasoning effort assigned to each agent.
12 - After approval, delegate implementation, test changes, validation, and
13 review fixes. The main agent coordinates and assesses returned evidence;
14 it does not implement or run tests itself.
15 - Give each worker a self-contained brief, including existing dirty work,
16 constraints, required checks, and its stopping condition.
17 - Explicitly select worker models; do not inherit the main agent's model.
18 Use a separate agent for independent review.
19 - “Do it” or “implement” approves a presented plan; it does not waive
20 delegation. Small changes and one-line fixes are not exceptions.
21 - If delegation is unavailable or a worker is blocked, report that and
22 ask for direction. Do not silently take over implementation.
23 - Only an explicit user instruction may waive planning or authorize the
24 main agent to implement directly.
25
26 ## Context
3 Read [CLAUDE.md](CLAUDE.md) for the repository's toolchain, architecture, 27 Read [CLAUDE.md](CLAUDE.md) for the repository's toolchain, architecture,
4 invariants, and working rules; those instructions apply to every coding agent. 28 invariants, and working rules; those instructions apply to every coding agent.
5 29