Skip to content

Commit dfffbc2

Browse files
committed
ai(rules[AGENTS]) Add lean writing defaults
why: the slop rules covered detection but not change footprint or coded labels, and nothing kept this file itself from growing. what: - Coded Labels: plain imperatives, no [R1]/Option B in human text - Change Discipline: smallest coherent change, reuse before create - Keep Instructions Lean: prune, move procedures to skills/hooks/CI
1 parent a29e76a commit dfffbc2

1 file changed

Lines changed: 28 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -360,6 +360,11 @@ patterns:
360360
robust, seamless, production-ready, leverage, delve, tapestry,* and
361361
*best practices* with concrete descriptions of behavior,
362362
constraints, or trade-offs.
363+
- **Coded Labels:** Write rules, options, and findings as plain
364+
imperatives. Don't tag them with codes like `[R1]`, `A1`, or
365+
`Option B` in artifacts a human reads — the reader shouldn't have to
366+
decode an index. Internal agent bookkeeping may use ids; shipped text
367+
may not.
363368

364369
### Preservation & Context
365370

@@ -412,3 +417,26 @@ to identify which commits this branch actually introduced. Then:
412417
- **Scope guard:** If cleaning prior slop would touch a colleague's
413418
work or expand the branch beyond its stated goal, stay in lane:
414419
protect the current goal and leave prior slop alone.
420+
421+
### Change Discipline
422+
423+
- Make the smallest coherent change that solves the verified problem;
424+
keep unrelated cleanup out of it.
425+
- Reuse an existing file, component, helper, API, or test before adding
426+
a new one. Modify in place when the change fits the file's
427+
responsibility.
428+
- Keep new APIs private until a caller outside the module needs them.
429+
- Add a file only for a durable boundary — a distinct responsibility,
430+
independent reuse, or splitting an oversized high-touch module — not
431+
for a single-use helper or a one-line re-export.
432+
433+
### Keep Instructions Lean
434+
435+
Treat this file like code and prune it.
436+
437+
- Delete a line whose removal would not cause a mistake.
438+
- Move multi-step procedures into skills, path-specific rules into
439+
nested AGENTS.md files, and hard limits into hooks or CI.
440+
- Keep only non-obvious, broadly applicable defaults here. Anything a
441+
reader can infer from the code, a manifest, or a linter does not
442+
belong.

0 commit comments

Comments
 (0)