coilyco-flight-deck/atmosphere
1
0
Fork 0
Code Issues 4 Pull requests Projects Releases Packages Wiki Activity Actions

lp-rollout: land v0.11.1 hook block (fix doc-layout + catalog-trifecta) #15

New issue
Closed
opened 2026-05-30 17:23:44 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-30 17:23:44 +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 atmosphere. It could not auto-land during the fleet rollout 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: the managed block # BEGIN managed by agentic-os/scripts/apply-agentic-os-hooks.py at rev: v0.11.1. Re-apply it 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 — your dispatch worktree starts from clean main.

Diagnosed violations

  • documentation-layout: nested docs under apps/bsky-scorer/docs/*.md, apps/bsky-scorer/seed-skill.md, ideas/README.md.
  • 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

  • Add [tool.agentic-os.documentation-layout] excludes = [...] (and catalog-doc-size excludes if needed) for legitimately-nested module/app docs; relocate or rename genuinely-misplaced docs. Use judgment on exclude-vs-move; 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 the fix + hook bump, 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 **atmosphere**. It could not auto-land during the fleet rollout 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`: the managed block `# BEGIN managed by agentic-os/scripts/apply-agentic-os-hooks.py` at `rev: v0.11.1`. Re-apply it 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 — your dispatch worktree starts from clean main. ## Diagnosed violations - **documentation-layout**: nested docs under `apps/bsky-scorer/docs/*.md`, `apps/bsky-scorer/seed-skill.md`, `ideas/README.md`. - **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 - Add `[tool.agentic-os.documentation-layout] excludes = [...]` (and `catalog-doc-size` excludes if needed) for legitimately-nested module/app docs; relocate or rename genuinely-misplaced docs. Use judgment on exclude-vs-move; 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 the fix + hook bump, 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
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/atmosphere#15
No description provided.