docs(agents): lead with the minimalism / DRY / anti-bloat bar #309

johnride · 2026-05-29T13:22:30Z

johnride commented

2026-05-29 13:22:30 +00:00

Rewrite AGENTS.md to open with a blunt,
non-negotiable engineering bar: match the implementation to the real
complexity of the problem, DRY in the purest sense (one authoritative
representation; the trust-boundary discriminator for what is and isn't
duplication), no speculative abstraction (Rule of Three / YAGNI), no
ceremony, core logic in one cohesive home (no leaking into external
modules), WHY-only comments. Applies to all agent output — code, tests,
docs, commits, replies. Reference sections compressed; 171 -> fewer
lines, strictly more pointed.

Rewrite AGENTS.md to open with a blunt, non-negotiable engineering bar: match the implementation to the real complexity of the problem, DRY in the purest sense (one authoritative representation; the trust-boundary discriminator for what is and isn't duplication), no speculative abstraction (Rule of Three / YAGNI), no ceremony, core logic in one cohesive home (no leaking into external modules), WHY-only comments. Applies to all agent output — code, tests, docs, commits, replies. Reference sections compressed; 171 -> fewer lines, strictly more pointed.

johnride added 1 commit 2026-05-29 13:22:31 +00:00

docs(agents): lead with the minimalism / DRY / anti-bloat bar

Run Check Script / check (pull_request) Successful in 2m20s

Details

164f1ede88

Rewrite AGENTS.md (CLAUDE.md symlinks to it) to open with a blunt,
non-negotiable engineering bar: match the implementation to the real
complexity of the problem, DRY in the purest sense (one authoritative
representation; the trust-boundary discriminator for what is and isn't
duplication), no speculative abstraction (Rule of Three / YAGNI), no
ceremony, core logic in one cohesive home (no leaking into external
modules), WHY-only comments. Applies to all agent output — code, tests,
docs, commits, replies. Reference sections compressed; 171 -> fewer
lines, strictly more pointed.

johnride force-pushed docs/agents-minimal from 164f1ede88 to 224d60907d

2026-05-29 13:26:22 +00:00

Compare

johnride merged commit 1dafd61bfe into master

2026-05-29 13:26:31 +00:00

johnride deleted branch docs/agents-minimal

2026-05-29 13:26:31 +00:00

johnride referenced this issue from a commit

2026-05-29 13:26:33 +00:00

Merge pull request 'docs(agents): lead with the minimalism / DRY / anti-bloat bar' (#309) from docs/agents-minimal into master

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: NationTech/harmony#309