Proposed AGENTS.md rule changes split from #3891 (for owner review)

Draft
BI
6d ago
+3-3

Owner review required — do not merge, mark ready, or arm auto-merge without Josh's explicit approval.

This draft holds only the AGENTS.md changes from #3891, split out so they can be reviewed separately. The diff is copied exactly from #3891. Nothing else is included, and #3891 itself is unchanged.

Note: the new rule 2 text refers to docs/agents/shared-context-and-memory.md for claims, reconciliation and exclusions. The document-draft guidance #3891 adds to that file is not part of this PR.

Rule 2 (replaced)

Before:

Establish scope, branch, ownership and existing changes before editing. Preserve concurrent work and use an isolated checkout when needed.

After:

Check scope, branch, owners and changes; preserve existing work. Prefer task-owned document drafts; copying needs no takeover. Routine exact-file handoffs and isolated takeovers within the authorised project, purpose and audience need no renewed approval. Follow docs/agents/shared-context-and-memory.md for claims, reconciliation and exclusions.

Rule 8 (sentence added before "Every publication names and verifies its repository.")

The current request can supply that authority; ask again only when it is missing or scope, target, exposure, cost or material risk changes.

Rule 11 (clause appended to the save sentence)

…save nothing for duplicates, chatter or no eligible fact; after a long conversation (about 20+ exchanges or a context compaction) the final response may instead save a digest of up to five separate settled facts, each with its own topic key.

Summary by cubic

Splits the AGENTS.md rule changes from #3891 into a standalone draft for owner review; #3891 itself is unchanged.

  • Rule 2 now covers task-owned document drafts, and says routine exact-file handoffs and isolated takeovers within the authorised scope need no renewed approval, pointing to docs/agents/shared-context-and-memory.md for claims, reconciliation and exclusions.
  • Rule 8 adds that the current request can supply publication authority, requiring a fresh ask only when authority is missing or scope, target, exposure, cost or material risk changes.
  • Rule 11 allows the final response of a long conversation (about 20+ exchanges or after a context compaction) to save a digest of up to five separate settled facts, each with its own topic key.

The referenced docs/agents/shared-context-and-memory.md guidance from #3891 is not part of this PR.