coilyco-flight-deck/galaxy-gen
1
0
Fork 0
Code Issues 11 Pull requests Projects Releases Packages Wiki Activity Actions

Clean up documentation-layout / catalog-trifecta violations on agentic-os hooks #11

New issue
Open
opened 2026-05-27 09:20:24 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-27 09:20:24 +00:00
Owner
Copy link

Problem

The agentic-os pre-commit hooks (currently pinned to v0.3.0 after coilysiren/galaxy-gen#10) ship documentation-layout and catalog-trifecta validators that fail on long-standing files in this repo. They are bypassed today via SKIP=documentation-layout,catalog-trifecta on commits that touch unrelated files.

Violations

documentation-layout (26 entries):

  • readme.md (wrong-case filename + over 80 lines / 4000 chars)
  • development.md (top-level non-allowlisted filename)
  • pkg/README.md (gitignored wasm-pack artifact, also over cap)
  • docs/FEATURES.md (over 4000 chars)
  • docs/perf-rewrite.md (1162 lines / 36k chars - very over)
  • AGENTS.md (86 lines / 4813 chars)
  • .agents/skills/coding-galaxy-gen-{astrophysics,cosmology,references}/SKILL.md and references/wikipedia-concepts.md (over caps)
  • .agents/skills/tooling-skill-authoring/SKILL.md and references/handbook.md (over caps)

catalog-trifecta (1 entry):

  • AGENTS.md missing required H2 sections (Scope / Project shape / Repo boundaries / Validation / Safety / Cross-repo contracts / Release / Agent rules)

Proposal

Pick one:

  1. Fix the content: rename readme.md → README.md, move development.md → docs/, split oversized SKILL.md / handbook / perf-rewrite into smaller files, restructure AGENTS.md to the trifecta shape.
  2. Add a per-repo .agentic-os.toml with excludes/enabled for the legitimately-large or out-of-shape paths. Requires bumping the pin to v0.4.0+ (where agentic_os.config ships, per agentic-os@68ff09e).

Option 2 is cheaper and matches the upstream escape hatch. Option 1 is more correct but invasive (the perf-rewrite session journal is a deliberate long-form artifact).

See also

## Problem The agentic-os pre-commit hooks (currently pinned to v0.3.0 after coilysiren/galaxy-gen#10) ship `documentation-layout` and `catalog-trifecta` validators that fail on long-standing files in this repo. They are bypassed today via `SKIP=documentation-layout,catalog-trifecta` on commits that touch unrelated files. ## Violations `documentation-layout` (26 entries): - `readme.md` (wrong-case filename + over 80 lines / 4000 chars) - `development.md` (top-level non-allowlisted filename) - `pkg/README.md` (gitignored wasm-pack artifact, also over cap) - `docs/FEATURES.md` (over 4000 chars) - `docs/perf-rewrite.md` (1162 lines / 36k chars - very over) - `AGENTS.md` (86 lines / 4813 chars) - `.agents/skills/coding-galaxy-gen-{astrophysics,cosmology,references}/SKILL.md` and `references/wikipedia-concepts.md` (over caps) - `.agents/skills/tooling-skill-authoring/SKILL.md` and `references/handbook.md` (over caps) `catalog-trifecta` (1 entry): - `AGENTS.md` missing required H2 sections (Scope / Project shape / Repo boundaries / Validation / Safety / Cross-repo contracts / Release / Agent rules) ## Proposal Pick one: 1. Fix the content: rename `readme.md` → `README.md`, move `development.md` → `docs/`, split oversized SKILL.md / handbook / perf-rewrite into smaller files, restructure AGENTS.md to the trifecta shape. 2. Add a per-repo `.agentic-os.toml` with `excludes`/`enabled` for the legitimately-large or out-of-shape paths. Requires bumping the pin to v0.4.0+ (where `agentic_os.config` ships, per agentic-os@68ff09e). Option 2 is cheaper and matches the upstream escape hatch. Option 1 is more correct but invasive (the perf-rewrite session journal is a deliberate long-form artifact). ## See also - coilysiren/galaxy-gen#10 - pin bump that surfaced these. - coilysiren/agentic-os@68ff09e - per-repo excludes feature.
coilysiren added
P3
 and removed
P2
 labels 2026-05-31 07:00:28 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
dispatch/issue-76
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/galaxy-gen#11
No description provided.