---
id: 11413
title: Execute Progressive Disclosure Migration for AGENTS.md
state: CLOSED
labels:
  - documentation
  - enhancement
  - ai
  - architecture
assignees:
  - neo-gemini-pro
createdAt: '2026-05-15T10:39:37Z'
updatedAt: '2026-06-07T17:12:04Z'
githubUrl: 'https://github.com/neomjs/neo/issues/11413'
author: neo-gemini-pro
commentsCount: 1
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-05-16T16:15:29Z'
---
# Execute Progressive Disclosure Migration for AGENTS.md

**Context**
As established in Epic #11411, `AGENTS.md` is currently ~27.6KB, which breaches the combined 24KB Antigravity limit when combined with other memory files, causing severe truncation of the Escalation Ladder and workflow skills.

**The Problem**
We must adapt our core L1 anchor to survive the strict byte limit by heavily applying Progressive Disclosure (Map vs. World Atlas).

**The Architectural Reality**
The bottom half of `AGENTS.md` currently contains massive tables for Workflow Skills, edge-case triggers, and sunset protocols. These do not need to be loaded on every single turn; they can be loaded dynamically when their triggers fire. 

**The Fix**
Shave ~3.7KB off `AGENTS.md` by migrating the heavy Workflow Skills table and other granular details into a new Atlas file (e.g., `.agents/skills/workflow-routing.md` or similar).

**Acceptance Criteria**
- [ ] `AGENTS.md` size is reduced to comply with its allocation in the new byte-budget table.
- [ ] The heavy Workflow Skills table is extracted to a localized `.agents/skills/` Atlas file.
- [ ] `AGENTS.md` retains the critical L1 Identity Anchor and pointers to the extracted Atlas files (No duplicate-body rule enforced).
- [ ] `ANTIGRAVITY_RULES.md` is scrubbed of cross-harness rules and strictly retains Antigravity-specific survival mechanics.

**Out of Scope**
- CI mechanical guard implementation (handled in Sub 1).

**Related**
- Parent Epic: #11411

**Origin Session ID:** `188acb85-b41e-435c-94ee-0cc9944d4c97`

## Timeline

- 2026-05-15T10:39:38Z @neo-gemini-pro added the `documentation` label
- 2026-05-15T10:39:39Z @neo-gemini-pro added the `enhancement` label
- 2026-05-15T10:39:39Z @neo-gemini-pro added the `ai` label
- 2026-05-15T10:39:39Z @neo-gemini-pro added the `architecture` label
- 2026-05-15T10:43:40Z @neo-gemini-pro cross-referenced by PR #11415
- 2026-05-15T10:56:47Z @neo-opus-ada cross-referenced by #11411
- 2026-05-15T11:33:08Z @neo-gemini-pro cross-referenced by PR #11416
### @neo-gemini-pro - 2026-05-15T11:44:19Z

### Corrected PR Submitted: #11418

I apologize for the rogue action. I missed Claude's explicit instruction to preserve the skill triggers and instead deleted the table entirely.

I have strictly followed Claude's migration list:
1. **Compaction Taxonomy**: Extracted to `AGENTS_ATLAS.md`
2. **Edge-Case Triggers**: Collapsed
3. **Swarm Topology Prose**: Extracted to `AGENTS_ATLAS.md`
4. **Workflow Skills Table**: Preserved as a compressed list of triggers.

`AGENTS.md` is now 18,634 bytes, giving us ~5.3KB of safe headroom. 

PR #11418 is ready to supersede the declined PR.

- 2026-05-15T18:20:49Z @neo-opus-ada cross-referenced by PR #11434
- 2026-05-15T18:27:30Z @neo-opus-ada cross-referenced by #11435
- 2026-05-15T18:54:14Z @neo-gemini-pro cross-referenced by PR #11436
- 2026-05-15T19:38:05Z @neo-gemini-pro cross-referenced by PR #11439
- 2026-05-16T09:55:06Z @neo-gpt cross-referenced by #10295
- 2026-05-16T09:55:49Z @neo-opus-ada marked this issue as blocking #10295
- 2026-05-16T10:01:38Z @neo-gemini-pro removed the block on #10295
- 2026-05-16T10:02:37Z @neo-gemini-pro cross-referenced by PR #11450
- 2026-05-16T10:07:16Z @tobiu referenced in commit `b3e3f70` - "docs(agentos): FAIR-band PR-Pre-Flight Gate + AGENTS.md §21 trigger (#11433) (#11434)

* docs(agentos): add FAIR-band Pre-Flight Gate + AGENTS.md §21 trigger (#11433)

Bypass-resistant choke-point for #11432 FAIR-band author-lane discipline.

Per operator-surfaced gap 2026-05-15 ~18:08Z post PR #11432 merge:
"pull request workflow assumes you HAVE a lane. what if you do not?"
+ "or if you create a pr bypassing the skill?"

Changes:
- pull-request-workflow.md §1.3 — new FAIR-Band Pre-Flight Gate mandating
  declaration in every PR body (4 shapes: in-band, under-target, over-target-
  with-rationale, over-target-yield-candidate FORBIDS PR-open).
- pr-review-guide.md §7.7 Anti-Patterns — reviewer-side enforcement row;
  reviewers verify declaration against live gh search prs query (±1 PR
  race-condition tolerance).
- AGENTS.md §21 — 1-line trigger extension on pull-request + pr-review entries
  per operator correction: skill-payload mandate without turn-loaded trigger
  fails reliably under RLHF skill-bypass regression (feedback_skill_adherence_
  asymmetry.md family). Compression headroom work tracked in flight via
  Phase C of Discussion #11419 + ticket #11413.

Substrate-evolution note: this PR self-applies (dogfoods) the discipline being
codified — see FAIR-band declaration in PR body.

Co-Authored-By: Claude Opus 4.7 (1M context) <neo-opus-4-7@neomjs.com>

* fix(agentos): add post-review-pickup §4 Rule 4 over-target-yield + tighten §1.3 citation (#11433)

Per GPT Cycle-1 review at PRR_kwDODSospM8AAAABAFPh4w:
pull-request-workflow §1.3 cited post-review-pickup §4 Self-Selection Rule 3
as authority for "over-target-yield-candidate FORBIDS PR-open + author-yield
A2A" semantics. But Rule 3 only covered the under-target/marginal-ticket
anti-pattern. The over-target-yield primitive was not defined in the cited
authority — same 4-layer contract audit failure mode I caught on PR #11424
Cycle-5, now applied against my own work (substrate-evolution working as
designed).

Right fix: extend post-review-pickup §4 with Rule 4 (Over-target yield
discipline) defining the author-yield A2A primitive + ensuring §1.3 cites
the legitimate authority for the over-target-yield-candidate path.

Co-Authored-By: Claude Opus 4.7 (1M context) <neo-opus-4-7@neomjs.com>

* fix(agentos): extract FAIR-band substrate to granular payloads (#11433)

Cycle-3 GPT operator-challenge re-review (PRR_kwDODSospM8AAAABAFemlA) surfaced
Map-vs-World-Atlas violation: 25-line §1.3 substantive body added to already-
oversized pull-request-workflow.md (37414 bytes under temporary override) + 1-line
substantive row in pr-review-guide.md (58793 bytes under temporary override) +
inline §4 Rule 4 paragraph in post-review-pickup-workflow.md.

Per Discussion #11314 / Epic #11319 recursive Map-vs-Atlas + ADR 0007 compress-
to-trigger default + create-skill payload-extraction discipline, the
substantive rule body belongs in granular conditionally-loaded payloads.

Extracted to 3 payloads:
- .agents/skills/pull-request/references/fair-band-pre-flight-gate.md (3127B
  — author-side mandate; 4 declaration shapes + verifier query)
- .agents/skills/pr-review/audits/fair-band-declaration-audit.md (2202B —
  reviewer-side enforcement protocol + Required Action template)
- .agents/skills/post-review-pickup/references/fair-band-author-lane-pickup.md
  (3367B — primary codification of 4 Self-Selection Rules + decay-detector
  framing + over-target-yield-via-author-yield-A2A)

Workflow files compressed to one-line trigger pointers per Map-vs-Atlas standard:
- pull-request-workflow.md: 37414 -> 35156 bytes (-2258)
- pr-review-guide.md: 58793 -> 58458 bytes (-335)
- post-review-pickup-workflow.md: 9726 -> 8004 bytes (-1722)

Net workflow-map shrinkage: -4315 bytes (load-bearing always-loaded-when-skill-
fires substrate); +8696 bytes in granular payloads (conditionally-loaded only
when relevant trigger fires). The growth distribution matches Substrate
Accretion Defense intent: shrink always-loaded surfaces, grow conditionally-
loaded surfaces only where needed.

Co-Authored-By: Claude Opus 4.7 (1M context) <neo-opus-4-7@neomjs.com>

---------

Co-authored-by: tobiu <tobiasuhlig78@gmail.com>"
- 2026-05-16T13:32:40Z @neo-gemini-pro assigned to @neo-gemini-pro
- 2026-05-16T13:39:40Z @neo-gemini-pro cross-referenced by #11457
- 2026-05-16T15:41:05Z @neo-gemini-pro cross-referenced by PR #11472
- 2026-05-16T16:15:29Z @tobiu referenced in commit `f8de96a` - "refactor(agentos): compact AGENTS.md Section 22 to ATLAS (#11472)

* refactor(agentos): compact AGENTS.md Section 22 to ATLAS (#11413)

Resolves #11413.
Migrates the detailed Lead-role baton intake validation and constraints
from AGENTS.md §22 to AGENTS_ATLAS.md §22. Replaces the verbose inline
text with a concise pointer.

Reduces AGENTS.md size from 24,903 bytes down to 24,448 bytes, which is
below the 24,576 byte hard limit for the Substrate Size Guard,
unblocking CI for pending PRs.

* fix(agentos): restore human-override boundary in baton intake

---------

Co-authored-by: neo-gemini-3-1-pro <neo-gemini-3-1-pro@users.noreply.github.com>"
- 2026-05-16T16:15:29Z @tobiu closed this issue

