coilyco-bridge/eco-cycle-prep
1
0
Fork 0
Code Issues 7 Pull requests Projects Releases Packages Wiki Activity Actions 1

Doc compliance: remove .agentic-os.toml hook opt-outs added for v0.6.0 bump #9

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

Background

The v0.6.0 agentic-os pre-commit hook bump (landed in #8, commit 2d2d24e) introduced whole-repo Markdown size/layout caps (80 lines / 4000 chars) and an AGENTS.md required-H2-heading set. This repo's pre-existing docs don't satisfy them, so #8 added a minimal .agentic-os.toml opting the offenders out to unblock the catalog migration. This issue tracks bringing the docs into actual compliance and removing those opt-outs.

Current opt-outs in .agentic-os.toml

  • [documentation-layout] agents_md_max_chars = 8000 - AGENTS.md runs ~4972 chars.
  • [documentation-layout] excludes:
    • README.md (~4878 chars) - trim under 4000.
    • docs/FEATURES.md (~4863 chars) - trim under 4000.
    • docs/worldgen.md (~17356 chars) - large worldgen schema reference.
    • docs/biomes.md (~13675 chars) - large per-biome catalog.
    • rolls/** - generated roll preview artifacts (narrative.md) living outside the allowed Markdown locations.
  • [catalog-trifecta] enabled = false - AGENTS.md is missing the required H2 set: ## Scope, ## Project shape, ## Repo boundaries, ## Commands, ## Validation, ## Safety, ## Cross-repo contracts, ## Release, ## Agent rules.

What to decide / do

  1. Trim README.md and docs/FEATURES.md under the 4000-char cap (or split into docs/*.md), then drop them from excludes.
  2. Decide policy for the large reference docs (docs/worldgen.md, docs/biomes.md): split into per-topic docs/*.md chunks, or keep a permanent exclude if they're legitimately catalog-style references.
  3. Decide whether generated rolls/**/narrative.md artifacts should be committed at all, relocated, or stay excluded.
  4. Restructure AGENTS.md under the required H2 headings and re-enable catalog-trifecta (or raise the issue upstream if the heading set doesn't fit this repo's shape).

Done when

.agentic-os.toml opt-outs are removed (or deliberately narrowed to justified permanent excludes) and all v0.6.0 doc hooks pass without them.

## Background The v0.6.0 agentic-os pre-commit hook bump (landed in #8, commit 2d2d24e) introduced whole-repo Markdown size/layout caps (80 lines / 4000 chars) and an AGENTS.md required-H2-heading set. This repo's pre-existing docs don't satisfy them, so #8 added a minimal `.agentic-os.toml` opting the offenders out to unblock the catalog migration. This issue tracks bringing the docs into actual compliance and removing those opt-outs. ## Current opt-outs in `.agentic-os.toml` - `[documentation-layout] agents_md_max_chars = 8000` - AGENTS.md runs ~4972 chars. - `[documentation-layout] excludes`: - `README.md` (~4878 chars) - trim under 4000. - `docs/FEATURES.md` (~4863 chars) - trim under 4000. - `docs/worldgen.md` (~17356 chars) - large worldgen schema reference. - `docs/biomes.md` (~13675 chars) - large per-biome catalog. - `rolls/**` - generated roll preview artifacts (`narrative.md`) living outside the allowed Markdown locations. - `[catalog-trifecta] enabled = false` - AGENTS.md is missing the required H2 set: `## Scope`, `## Project shape`, `## Repo boundaries`, `## Commands`, `## Validation`, `## Safety`, `## Cross-repo contracts`, `## Release`, `## Agent rules`. ## What to decide / do 1. Trim `README.md` and `docs/FEATURES.md` under the 4000-char cap (or split into `docs/*.md`), then drop them from `excludes`. 2. Decide policy for the large reference docs (`docs/worldgen.md`, `docs/biomes.md`): split into per-topic `docs/*.md` chunks, or keep a permanent exclude if they're legitimately catalog-style references. 3. Decide whether generated `rolls/**/narrative.md` artifacts should be committed at all, relocated, or stay excluded. 4. Restructure AGENTS.md under the required H2 headings and re-enable `catalog-trifecta` (or raise the issue upstream if the heading set doesn't fit this repo's shape). ## Done when `.agentic-os.toml` opt-outs are removed (or deliberately narrowed to justified permanent excludes) and all v0.6.0 doc hooks pass without them.
coilysiren added
P4
 and removed
P3
 labels 2026-05-31 06:59:57 +00:00
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-bridge/eco-cycle-prep#9
No description provided.