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

Split grandfathered oversized docs under the documentation-layout size cap #183

New issue
Open
opened 2026-05-30 17:37:50 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-30 17:37:50 +00:00
Owner
Copy link

When the agentic-os v0.11.1 hook block landed (#181), the new documentation-layout / catalog-doc-size Markdown size caps (80 lines / 4000 chars) surfaced a pile of pre-existing oversized docs. Rather than split 10+ runbooks inside a hook-adoption change, they were grandfathered via [tool.agentic-os.documentation-layout] excludes in pyproject.toml. This issue tracks splitting them so they can come back under the cap and off the exclude list.

Grandfathered files (current size):

  • docs/k3s-deploy-notes.md - 960 lines / 43327 chars (the big one; split by section)
  • docs/forgejo-deploy-plan.md - 321 / 22211
  • docs/glitchtip-deploy-plan.md - 293 / 17332
  • docs/repo-recall-deploy.md - 119 / 5305
  • docs/tailscale.md - 101 / 5227
  • docs/claude-remote-control.md - 110 / 7082
  • docs/claude-session-watcher.md - 127 / 4595
  • docs/certificates.md - 85 / 4421
  • docs/eco-server-setup.md - 347 / 14103 (moved from root eco.md in #181)
  • docs/FEATURES.md - 4938 chars (trifecta file; trim under 4000)
  • skills/ops-investigation-k3s-pod-eviction/SKILL.md - 89 lines
  • skills/ops-investigation-k3s-upgrade-homelab/SKILL.md - 85 / 4501

Use docs/ filename prefixes (flat, no subdirs) to split. Drop each path from the excludes list as it comes under cap. docs/certificates.md and the two SKILL.md entries are just over the line and are the cheap wins.

When the agentic-os v0.11.1 hook block landed (#181), the new `documentation-layout` / `catalog-doc-size` Markdown size caps (80 lines / 4000 chars) surfaced a pile of pre-existing oversized docs. Rather than split 10+ runbooks inside a hook-adoption change, they were grandfathered via `[tool.agentic-os.documentation-layout] excludes` in `pyproject.toml`. This issue tracks splitting them so they can come back under the cap and off the exclude list. Grandfathered files (current size): - `docs/k3s-deploy-notes.md` - 960 lines / 43327 chars (the big one; split by section) - `docs/forgejo-deploy-plan.md` - 321 / 22211 - `docs/glitchtip-deploy-plan.md` - 293 / 17332 - `docs/repo-recall-deploy.md` - 119 / 5305 - `docs/tailscale.md` - 101 / 5227 - `docs/claude-remote-control.md` - 110 / 7082 - `docs/claude-session-watcher.md` - 127 / 4595 - `docs/certificates.md` - 85 / 4421 - `docs/eco-server-setup.md` - 347 / 14103 (moved from root `eco.md` in #181) - `docs/FEATURES.md` - 4938 chars (trifecta file; trim under 4000) - `skills/ops-investigation-k3s-pod-eviction/SKILL.md` - 89 lines - `skills/ops-investigation-k3s-upgrade-homelab/SKILL.md` - 85 / 4501 Use `docs/` filename prefixes (flat, no subdirs) to split. Drop each path from the `excludes` list as it comes under cap. `docs/certificates.md` and the two SKILL.md entries are just over the line and are the cheap wins.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
dispatch/issue-294
tangled-knot
dispatch/issue-216
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/infrastructure#183
No description provided.