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

New issue

Closed

opened 2026-05-30 17:37:50 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-05-30 17:37:50 +00:00

Owner

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.

coilysiren added the

label

2026-06-04 08:16:53 +00:00

coilysiren commented

2026-06-17 08:22:40 +00:00

Author

Owner

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:22:40 +00:00