Compress AGENTS.md and add a standing rule to trim it on every edit #61

Merged
lilleman merged 1 commits from agents-md-prune into node-modules-ownership 2026-08-05 22:04:11 +02:00
Owner

Every agent session reads AGENTS.md in full, so its length is a cost paid on every task. It had grown to 37 KB with no expiry mechanism.

New ## Maintaining this file section — trim as you add, record the decision and not the investigation, give every accepted risk an expiry, one home per fact.

Compressed the rest: 37673 -> 28867 bytes, 443 -> 359 lines. The 30 flat 'deviations' bullets are now grouped under Structure & contracts / Authorization / i18n / UI / Build, test & release, so the section is scannable.

Verified nothing actionable was lost by diffing every backticked identifier across both versions; that caught four real drops, all restored (the div + ARIA rule, bootstrap's ./plugins mount footgun, the watchedPage() half of the console guard, and fetch-tags: true). What stayed cut is history, superseded guidance and duplicate examples.

Also fixes a copy-paste defect: the RTL entry ended with two sentences duplicated verbatim from the locales/ entry above it.

Stacked on node-modules-ownership (PR #60) — merge that one first.

Every agent session reads AGENTS.md in full, so its length is a cost paid on every task. It had grown to 37 KB with no expiry mechanism. **New `## Maintaining this file` section** — trim as you add, record the decision and not the investigation, give every accepted risk an expiry, one home per fact. **Compressed the rest**: 37673 -> 28867 bytes, 443 -> 359 lines. The 30 flat 'deviations' bullets are now grouped under Structure & contracts / Authorization / i18n / UI / Build, test & release, so the section is scannable. Verified nothing actionable was lost by diffing every backticked identifier across both versions; that caught four real drops, all restored (the `div` + ARIA rule, bootstrap's `./plugins` mount footgun, the `watchedPage()` half of the console guard, and `fetch-tags: true`). What stayed cut is history, superseded guidance and duplicate examples. Also fixes a copy-paste defect: the RTL entry ended with two sentences duplicated verbatim from the `locales/` entry above it. Stacked on node-modules-ownership (PR #60) — merge that one first.
lilleman added 1 commit 2026-08-05 21:53:09 +02:00
Compress AGENTS.md and add a standing rule to trim it on every edit
CI / full-gate (push) Successful in 2m34s
Mirror / github-mirror (push) Successful in 3s
e8b91ecd09
lilleman merged commit e8b91ecd09 into node-modules-ownership 2026-08-05 22:04:11 +02:00
lilleman deleted branch agents-md-prune 2026-08-05 22:04:11 +02:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: larvit/plainpages#61