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

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

New issue
Closed
opened 2026-05-27 09:20:24 +00:00 by coilysiren · 1 comment
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
P4
 and removed
P3
 labels 2026-06-04 08:16:37 +00:00
coilysiren commented 2026-06-17 08:23:31 +00:00
Author
Owner
Copy link

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: burndown-2026-06.

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: `burndown-2026-06`.
coilysiren 2026-06-17 08:23:32 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
issue-32
ward-salvage/galaxy-gen-ed9610f6
No results found.
Labels
Clear labels   
burndown-2026-06
Backlog burndown June 2026

  
coherence-core
Core review set for the warded control plane coherence milestone. These issues form the release spine; adjacent milestone issues are stretch or supporting work.

  
consult
A human decision, design, or external action must happen first. Fail-closed default for unlabeled/low-confidence.

  
headless
Agent can take it from open issue to merged change with no human in the loop. The auto-burndown queue.

  
interactive
Agent does the work but pauses at a human checkpoint mid-flight (design choice, destructive step, human-only verification).

  
P0
now / blocking / urgent

  
P1
next / important

  
P2
backlog / will do

  
P3
someday / low

  
P4
icebox / frozen / reopen if it becomes real

No labels
burndown-2026-06
coherence-core
consult
headless
interactive
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.