coilyco-flight-deck/gauntlet
1
0
Fork 0
Code Issues 5 Pull requests Projects Releases Packages Wiki Activity Actions 3

lp-rollout: land v0.11.1 hook block (SCOPE.md + oversized docs + trifecta) #21

New issue
Closed
opened 2026-05-30 17:23:45 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-30 17:23:45 +00:00
Owner
Copy link

Sub-issue of coilysiren/agentic-os-kai#548 (parent rollout: #505).

Land the agentic-os v0.11.1 hook block (context-load-points + owner-agnostic closes-issue) on gauntlet. It could not auto-land because committing the bump trips other managed hooks (pre-existing debt).

Hook block reference

Already adopted in eco-configs / luca / session-lattice .pre-commit-config.yaml: managed block at rev: v0.11.1. Re-apply fresh in your worktree (run agentic-os/scripts/apply-agentic-os-hooks.py or copy the block). Do not rely on uncommitted changes in the canonical checkout.

Diagnosed violations

  • documentation-layout: root SCOPE.md not allowed; agents/*.md nested.
  • catalog-doc-size: README.md 4943c and SCOPE.md 5060c, over the 4000c cap.
  • catalog-trifecta: AGENTS.md missing the 9 required H2 sections: Scope, Project shape, Repo boundaries, Commands, Validation, Safety, Cross-repo contracts, Release, Agent rules.

Fix pattern

  • Relocate/rename genuinely-misplaced root docs (SCOPE.md → fold into AGENTS.md or docs/); add documentation-layout excludes for legit nested agents/*.md if they are real load points.
  • Split oversized docs into docs/*.md to get under the 4000c cap; keep real content.
  • Restructure AGENTS.md to the 9-section catalog-trifecta template.
  • Run agentic_os.check_documentation_layout / check_catalog_trifecta / check_catalog_doc_size until clean.

Landing

Commit, run pre-commit clean (never --no-verify), then push to canonical Forgejo main:
git push $(git config --get-all remote.origin.pushurl | grep forgejo) HEAD:main
GitHub mirror stays PR-gated. Use closes <this forgejo issue url> in the commit. Close this issue when landed.

Sub-issue of coilysiren/agentic-os-kai#548 (parent rollout: #505). Land the agentic-os **v0.11.1** hook block (context-load-points + owner-agnostic closes-issue) on **gauntlet**. It could not auto-land because committing the bump trips other managed hooks (pre-existing debt). ## Hook block reference Already adopted in `eco-configs` / `luca` / `session-lattice` `.pre-commit-config.yaml`: managed block at `rev: v0.11.1`. Re-apply fresh in your worktree (run `agentic-os/scripts/apply-agentic-os-hooks.py` or copy the block). Do not rely on uncommitted changes in the canonical checkout. ## Diagnosed violations - **documentation-layout**: root `SCOPE.md` not allowed; `agents/*.md` nested. - **catalog-doc-size**: `README.md` 4943c and `SCOPE.md` 5060c, over the 4000c cap. - **catalog-trifecta**: `AGENTS.md` missing the 9 required H2 sections: Scope, Project shape, Repo boundaries, Commands, Validation, Safety, Cross-repo contracts, Release, Agent rules. ## Fix pattern - Relocate/rename genuinely-misplaced root docs (`SCOPE.md` → fold into AGENTS.md or `docs/`); add `documentation-layout` excludes for legit nested `agents/*.md` if they are real load points. - Split oversized docs into `docs/*.md` to get under the 4000c cap; keep real content. - Restructure `AGENTS.md` to the 9-section catalog-trifecta template. - Run `agentic_os.check_documentation_layout` / `check_catalog_trifecta` / `check_catalog_doc_size` until clean. ## Landing Commit, run pre-commit clean (never `--no-verify`), then push to canonical Forgejo main: `git push $(git config --get-all remote.origin.pushurl | grep forgejo) HEAD:main` GitHub mirror stays PR-gated. Use `closes <this forgejo issue url>` in the commit. Close this issue when landed.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
claude/peaceful-khorana-f0a719
worktree-agent-ac17b823
worktree-agent-a1cf7102
worktree-agent-a9e4ff5f
worktree-agent-abb6c04a
claude/loving-herschel-af53e4
claude/crazy-gould
No results found.
Labels
Clear labels
  
P0
now / blocking / urgent

  
P1
next / important

  
P2
backlog / will do

  
P3
someday / low

  
P4
icebox / frozen / reopen if it becomes real

No labels
P0
P1
P2
P3
P4
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
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/gauntlet#21
No description provided.