coilyco-flight-deck/session-lattice
1
0
Fork 0
Code Issues 7 Pull requests Projects Releases Packages Wiki Activity Actions

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

New issue
Open
opened 2026-05-26 05:23:19 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-26 05:23:19 +00:00
Owner
Copy link

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
P2
 and removed
P1
 labels 2026-05-31 07:01:22 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
dispatch/issue-37
v0.10.2
v0.10.1
v0.10.0
v0.9.0
v0.8.5
v0.8.4
v0.8.3
v0.8.2
v0.8.1
v0.8.0
v0.7.0
v0.6.1
v0.6.0
v0.5.3
v0.5.2
v0.5.1
v0.5.0
v0.4.4
v0.4.3
v0.4.2
v0.4.1
v0.4.0
v0.3.0
v0.2.0
v0.1.1
v0.1.0
v0.0.1
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/session-lattice#8
No description provided.