pre-commit baseline drift after agentic-os v0.2.8 bump blocks new commits #23

Open
opened 2026-05-28 00:20:09 +00:00 by coilysiren · 0 comments
Owner

Problem

pre-commit fails on a clean tree after the agentic-os v0.2.6 → v0.2.8 bump (e868dc2). Three hooks block any new commit:

  • catalog-trifecta: AGENTS.md is missing the required H2 set — ## Scope, ## Project shape, ## Repo boundaries, ## Commands, ## Validation, ## Safety, ## Cross-repo contracts, ## Release, ## Agent rules.
  • documentation-layout + catalog-doc-size: investigation/**/*.md (11 files) live outside the allowed layout (docs/*.md or skill folders), and most exceed the 80-line / 4000-char cap. docs/FEATURES.md is also over the cap (92 lines / 4877 chars).

Surfaced while landing #22. AGENTS.md forbids --no-verify, so any commit is blocked until the baseline is restored.

Proposal

  • Rewrite AGENTS.md to the trifecta H2 layout (sections can be one line each pointing at the inherited default where appropriate).
  • Decide on investigation/ — either promote useful pieces into docs/ under the cap, move into a skill folder, or git-rm. They were a one-shot post-mortem dump.
  • Trim docs/FEATURES.md back under cap (matches the spirit of b830469).
**Problem** `pre-commit` fails on a clean tree after the `agentic-os v0.2.6 → v0.2.8` bump (e868dc2). Three hooks block any new commit: - `catalog-trifecta`: `AGENTS.md` is missing the required H2 set — `## Scope`, `## Project shape`, `## Repo boundaries`, `## Commands`, `## Validation`, `## Safety`, `## Cross-repo contracts`, `## Release`, `## Agent rules`. - `documentation-layout` + `catalog-doc-size`: `investigation/**/*.md` (11 files) live outside the allowed layout (`docs/*.md` or skill folders), and most exceed the 80-line / 4000-char cap. `docs/FEATURES.md` is also over the cap (92 lines / 4877 chars). Surfaced while landing #22. AGENTS.md forbids `--no-verify`, so any commit is blocked until the baseline is restored. **Proposal** - Rewrite `AGENTS.md` to the trifecta H2 layout (sections can be one line each pointing at the inherited default where appropriate). - Decide on `investigation/` — either promote useful pieces into `docs/` under the cap, move into a skill folder, or git-rm. They were a one-shot post-mortem dump. - Trim `docs/FEATURES.md` back under cap (matches the spirit of b830469).
coilysiren added
P1
and removed
P0
labels 2026-05-31 07:00:21 +00:00
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/eco-mcp-app#23
No description provided.