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

Doc-layout cleanup: remove .agentic-os.toml opt-outs added for the v0.6.0 hook bump in issue 14 #15

New issue
Open
opened 2026-05-28 04:49:56 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-28 04:49:56 +00:00
Owner
Copy link

Context

Issue #14 bumped the agentic-os pre-commit hook to v0.6.0 (required to make providesApis optional so it could be dropped from the catalog block). That bump also tightened documentation-layout: every Markdown file now caps at 80 lines / 4000 chars, skill folders must be flat, and root Markdown is restricted to an allowlist. The repo was compliant under the looser v0.3.0 rules, so the bump surfaced ~28 pre-existing doc-layout violations all at once.

To land #14 without bundling a repo-wide doc reorg into a catalog chore, those files were opted out via .agentic-os.toml (and catalog-trifecta was disabled for the AGENTS.md section requirement). This issue tracks doing the real cleanup and removing those opt-outs.

Cleanup work (remove each .agentic-os.toml exclude as it's resolved)

  • readme.md - rename to README.md (root allowlist is case-sensitive) and trim under 80 lines / 4000 chars. Update any links pointing at readme.md.
  • development.md - relocate to docs/development.md. Update references (AGENTS.md points at it).
  • pkg/ - generated by wasm-pack and gitignored, but the hook walks the filesystem. Either keep the pkg/ exclude permanently or clean the dir; decide which.
  • docs/perf-rewrite.md (1162 lines) - split into flat docs/perf-*.md fragments under the cap, or archive it.
  • docs/FEATURES.md (4881 chars) - trim under 4000 chars.
  • AGENTS.md (4100 chars) - trim under 4000 chars AND restructure into the 8 catalog-trifecta H2 sections (## Scope, ## Project shape, ## Repo boundaries, ## Validation, ## Safety, ## Cross-repo contracts, ## Release, ## Agent rules). Re-enable catalog-trifecta afterward.
  • Skills - coding-galaxy-gen-astrophysics, coding-galaxy-gen-cosmology, coding-galaxy-gen-references, tooling-skill-authoring: SKILL.md files exceed the cap and three have nested references/ subfolders (skill folders must be flat). Split content and flatten.

Done when

.agentic-os.toml is deleted (or reduced to only intentional, permanent excludes like generated pkg/), catalog-trifecta is re-enabled, and documentation-layout passes on --all-files with no opt-outs.

Parent: coilysiren/agentic-os-kai#433. Follow-up to #14.

## Context Issue #14 bumped the agentic-os pre-commit hook to `v0.6.0` (required to make `providesApis` optional so it could be dropped from the catalog block). That bump also tightened `documentation-layout`: every Markdown file now caps at **80 lines / 4000 chars**, skill folders must be **flat**, and root Markdown is restricted to an allowlist. The repo was compliant under the looser `v0.3.0` rules, so the bump surfaced ~28 pre-existing doc-layout violations all at once. To land #14 without bundling a repo-wide doc reorg into a catalog chore, those files were opted out via `.agentic-os.toml` (and `catalog-trifecta` was disabled for the AGENTS.md section requirement). This issue tracks doing the real cleanup and removing those opt-outs. ## Cleanup work (remove each `.agentic-os.toml` exclude as it's resolved) - **`readme.md`** - rename to `README.md` (root allowlist is case-sensitive) and trim under 80 lines / 4000 chars. Update any links pointing at `readme.md`. - **`development.md`** - relocate to `docs/development.md`. Update references (AGENTS.md points at it). - **`pkg/`** - generated by `wasm-pack` and gitignored, but the hook walks the filesystem. Either keep the `pkg/` exclude permanently or clean the dir; decide which. - **`docs/perf-rewrite.md`** (1162 lines) - split into flat `docs/perf-*.md` fragments under the cap, or archive it. - **`docs/FEATURES.md`** (4881 chars) - trim under 4000 chars. - **`AGENTS.md`** (4100 chars) - trim under 4000 chars AND restructure into the 8 `catalog-trifecta` H2 sections (`## Scope`, `## Project shape`, `## Repo boundaries`, `## Validation`, `## Safety`, `## Cross-repo contracts`, `## Release`, `## Agent rules`). Re-enable `catalog-trifecta` afterward. - **Skills** - `coding-galaxy-gen-astrophysics`, `coding-galaxy-gen-cosmology`, `coding-galaxy-gen-references`, `tooling-skill-authoring`: SKILL.md files exceed the cap and three have nested `references/` subfolders (skill folders must be flat). Split content and flatten. ## Done when `.agentic-os.toml` is deleted (or reduced to only intentional, permanent excludes like generated `pkg/`), `catalog-trifecta` is re-enabled, and `documentation-layout` passes on `--all-files` with no opt-outs. Parent: coilysiren/agentic-os-kai#433. Follow-up to #14.
coilysiren added
P4
 and removed
P3
 labels 2026-05-31 07:00:27 +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#15
No description provided.