Skip to content

docs(dox): optimize root AGENTS.md (−49.5% lines / −38.8% bytes)#81

Merged
edheltzel merged 1 commit into
mainfrom
chore/dox-agents-md-optimization
Jun 16, 2026
Merged

docs(dox): optimize root AGENTS.md (−49.5% lines / −38.8% bytes)#81
edheltzel merged 1 commit into
mainfrom
chore/dox-agents-md-optimization

Conversation

@edheltzel

Copy link
Copy Markdown
Owner

Summary

Optimizes the root `AGENTS.md` agent context while keeping the binding DOX rail intact. Two logical changes land together in one PR:

  1. DOX rollout baseline (`57f57b7`) — captures the in-flight DOX framework rollout as a clean baseline.
  2. AGENTS.md optimization (`231ef07`) — slims the root context file.

What changed

  • Root `AGENTS.md`: −49.5% lines / −38.8% bytes. The verbose project-structure file tree is replaced with a directory-purpose map that points agents at `codegraph` and `fd` for live structure instead of a hand-maintained tree that drifts.
  • New `docs/agents/dox-framework.md`: the DOX procedure is extracted here, with codegraph guidance woven into the Read-Before-Editing and Closeout steps (never assume structure codegraph can answer).
  • `docs/AGENTS.md`: child DOX index updated to reference the new framework doc.
  • Binding rail kept inline: project-wide instructions and the top-level Child DOX Index remain in root `AGENTS.md` — only the procedural detail moved.

Rationale

The root context file is loaded into every agent session; trimming drift-prone duplication (the file tree) and relocating procedure to a referenced doc reduces token cost without weakening any DOX contract.

- lean directory-purpose map replaces the drifted file tree (points to codegraph/fd for the live source tree; docs/architecture.md noted as runtime/install layout)
- generic DOX procedure extracted to docs/agents/dox-framework.md with codegraph guidance woven into Read Before Editing and Closeout
- binding rail kept inline: Core Contract, User Preferences, Child DOX Index
@edheltzel edheltzel force-pushed the chore/dox-agents-md-optimization branch from 231ef07 to bba43e7 Compare June 16, 2026 17:21
@edheltzel edheltzel merged commit 0cd0c2f into main Jun 16, 2026
2 checks passed
@edheltzel edheltzel deleted the chore/dox-agents-md-optimization branch June 16, 2026 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant