Skip to content

Commit e728fda

Browse files
docs: carry the fleet-wide reuse and size-budget rules into AGENTS.md
Two author-side rules the fleet states and this file did not, verbatim from obin-ai/handbook#313 (merged 2026-10-13): prove reuse before you build, and build the simplest thing that works — a ~500 hand-written line budget, where past 2,000 the change has become a second system and the agent stops and asks the person who wanted it instead of finishing it. The wording is byte-identical across every repo in this sweep; only the list marker follows this file's own style. Docs only: no code, no gate, no behaviour change. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent 1b389b4 commit e728fda

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

‎AGENTS.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,22 @@ These are the fleet's rules, not this repo's, and they are stated here because
7070
an agent reads this file and not the tracker:
7171
https://github.com/obin-ai/handbook/issues/68.
7272

73+
- **Prove reuse before you build.** The default answer is that the platform
74+
already has it and your change fills a gap or adds a helper on it, so the PR
75+
body names what you reused and what you deliberately did not. A second
76+
mechanism for a job one seam already does is refused however clean it is. Two
77+
tells you are reinventing: what you are writing re-answers a question an
78+
existing seam answered, and your reason for its placement is that a
79+
convenient loop was already there rather than that the responsibility belongs
80+
to it.
81+
- **Build the simplest thing that works; size is the signal.** A coding task's
82+
budget is about **500 hand-written lines** — generated output does not count,
83+
tests count apart — and past **2,000** the change has become a second system,
84+
so **stop and ask the user** instead of finishing it. Two tells, checkable
85+
before the code exists: you cannot name the one responsibility the change
86+
adds, and it is growing to make the end goal pass rather than to put a
87+
behaviour where it belongs. Wanting it to work licenses no means to get
88+
there.
7389
- **A gap in the tooling is a bug in the tooling** — never a reason to reach
7490
around it. Not as a "workaround", not "just this once", not "until the verb
7591
lands". A missing capability in `codefly`, `buf` or the generation scripts is

0 commit comments

Comments
 (0)