chore: shrink AGENTS.md and docs/architecture.md under 4000-char cap #8

New issue

Closed

opened 2026-05-26 05:23:19 +00:00 by coilysiren · 0 comments

coilysiren commented

2026-05-26 05:23:19 +00:00

Owner

Problem

catalog-doc-size and documentation-layout hooks (agentic-os v0.2.6+) cap markdown at 4000 chars. Current state:

AGENTS.md is 4249 chars (249 over)
docs/architecture.md is 4069 chars (69 over)

These violations predate session-lattice#37 (the code-comments sweep) and block clean pre-commit runs.

Fix

Split each file. AGENTS.md can spin post-push release detail off to docs/release.md. docs/architecture.md likely needs splitting along major boundaries (puller vs reads vs DuckDB layout).

Discovered while working on coilysiren/session-lattice#37.

Ported from coilysiren/session-lattice#38.

**Problem** `catalog-doc-size` and `documentation-layout` hooks (agentic-os v0.2.6+) cap markdown at 4000 chars. Current state: - `AGENTS.md` is 4249 chars (249 over) - `docs/architecture.md` is 4069 chars (69 over) These violations predate session-lattice#37 (the code-comments sweep) and block clean pre-commit runs. **Fix** Split each file. AGENTS.md can spin post-push release detail off to `docs/release.md`. `docs/architecture.md` likely needs splitting along major boundaries (puller vs reads vs DuckDB layout). **Discovered while working on** coilysiren/session-lattice#37. --- _Ported from coilysiren/session-lattice#38._

coilysiren added the

label

2026-05-31 01:55:09 +00:00

coilysiren added

and removed

labels

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

coilysiren closed this issue

2026-06-17 18:52:27 +00:00

Commenting is not possible because the repository is archived.