chore: docs size + trifecta violations exposed by agentic-os v0.2.8 bump #16

Open
opened 2026-05-26 05:22:33 +00:00 by coilysiren · 0 comments
Owner

Problem

After bumping .pre-commit-config.yaml to rev: v0.2.8 in #32, the agentic-os pre-commit suite started running the previously-broken catalog-doc-size, documentation-layout, and catalog-trifecta hooks. v0.2.6's manifest had an unquoted-colon YAML parse error (fixed in agentic-os 13490a4) so those hooks were silently no-ops on the v0.2.6 cache.

Currently failing on main:

  • CODE_OF_CONDUCT.md: 5121 chars exceeds the 4000-char cap.
  • README.md: 98 lines / 4568 chars exceeds the 80-line / 4000-char caps.
  • AGENTS.md: missing required H2 headings (## Scope, ## Project shape, ## Repo boundaries, ## Commands, ## Validation, ## Safety, ## Cross-repo contracts, ## Release, ## Agent rules).

Fix

  • Split CODE_OF_CONDUCT.md and README.md into docs/*.md shards, leaving a short pointer in each root file.
  • Restructure AGENTS.md to the trifecta H2 layout. Most existing content already fits; mostly a rename / regroup pass.

Verify with pre-commit run catalog-doc-size documentation-layout catalog-trifecta --all-files (run each hook id separately, pre-commit does not accept multiple ids on one invocation).

Origin

Out-of-scope follow-up from #32. That commit landed with SKIP=catalog-doc-size,documentation-layout,catalog-trifecta for these three hooks; this issue is the close-out.


Ported from coilysiren/agent-guard#33.

**Problem** After bumping `.pre-commit-config.yaml` to `rev: v0.2.8` in #32, the agentic-os pre-commit suite started running the previously-broken `catalog-doc-size`, `documentation-layout`, and `catalog-trifecta` hooks. v0.2.6's manifest had an unquoted-colon YAML parse error (fixed in agentic-os 13490a4) so those hooks were silently no-ops on the v0.2.6 cache. Currently failing on `main`: - `CODE_OF_CONDUCT.md`: 5121 chars exceeds the 4000-char cap. - `README.md`: 98 lines / 4568 chars exceeds the 80-line / 4000-char caps. - `AGENTS.md`: missing required H2 headings (`## Scope`, `## Project shape`, `## Repo boundaries`, `## Commands`, `## Validation`, `## Safety`, `## Cross-repo contracts`, `## Release`, `## Agent rules`). **Fix** - Split `CODE_OF_CONDUCT.md` and `README.md` into `docs/*.md` shards, leaving a short pointer in each root file. - Restructure `AGENTS.md` to the trifecta H2 layout. Most existing content already fits; mostly a rename / regroup pass. Verify with `pre-commit run catalog-doc-size documentation-layout catalog-trifecta --all-files` (run each hook id separately, pre-commit does not accept multiple ids on one invocation). **Origin** Out-of-scope follow-up from #32. That commit landed with `SKIP=catalog-doc-size,documentation-layout,catalog-trifecta` for these three hooks; this issue is the close-out. --- _Ported from coilysiren/agent-guard#33._
Sign in to join this conversation.
No labels
P0
P1
P2
P3
P4
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
coilyco-flight-deck/ward#16
No description provided.