Trim README, AGENTS, FEATURES to 100 lines and 5000 bytes #2

Open
opened 2026-05-23 20:54:20 +00:00 by coilysiren · 0 comments
Owner

Originally filed by @coilysiren on 2026-05-16T01:13:58Z - https://github.com/coilysiren/galaxy-gen/issues/64

Problem - One or more of README.md / AGENTS.md / docs/FEATURES.md exceed the catalog-doc-size cap (100 lines / 5000 bytes). These three files are pulled wholesale into agentic-os-kai's per-repo digest (coilysiren/agentic-os-kai#543). Size discipline lives at the source.

Over-cap files (README,AGENTS,FEATURES)

README 158L/8144B, AGENTS 95L/5213B (bytes only), FEATURES 93L/7733B (bytes only)

Plan - Trim each over-cap file to fit within 100 lines / 5000 bytes. Suggested split strategies:

  • README.md: keep the top pitch + quick start. Push deeper structure into AGENTS.md, docs/FEATURES.md, or a new docs/<topic>.md.
  • AGENTS.md: split per-area operating rules into skill files under .claude/skills/ or sibling docs under docs/. Keep only what's needed to override workspace-level conventions.
  • docs/FEATURES.md: keep one-line feature inventory. Push per-feature deep dives into docs/<feature>.md.

After the trim lands, re-stamp the catalog-doc-size hook so the new caps enforce locally going forward:

coily apply-catalog-doc-size-hook ARGS="--repo galaxy-gen"

Why - Fits the file into the daily digest cleanly. The digest is what agents loaded from agentic-os-kai's project context read for cross-repo questions; bloated source files push the digest dir out of useful range.

Umbrella - coilysiren/agentic-os-kai#549.

_Originally filed by @coilysiren on 2026-05-16T01:13:58Z - [https://github.com/coilysiren/galaxy-gen/issues/64](https://github.com/coilysiren/galaxy-gen/issues/64)_ **Problem** - One or more of `README.md` / `AGENTS.md` / `docs/FEATURES.md` exceed the catalog-doc-size cap (100 lines / 5000 bytes). These three files are pulled wholesale into agentic-os-kai's per-repo digest ([coilysiren/agentic-os-kai#543](https://github.com/coilysiren/agentic-os-kai/issues/543)). Size discipline lives at the source. **Over-cap files** (README,AGENTS,FEATURES) README 158L/8144B, AGENTS 95L/5213B (bytes only), FEATURES 93L/7733B (bytes only) **Plan** - Trim each over-cap file to fit within 100 lines / 5000 bytes. Suggested split strategies: - `README.md`: keep the top pitch + quick start. Push deeper structure into `AGENTS.md`, `docs/FEATURES.md`, or a new `docs/<topic>.md`. - `AGENTS.md`: split per-area operating rules into skill files under `.claude/skills/` or sibling docs under `docs/`. Keep only what's needed to override workspace-level conventions. - `docs/FEATURES.md`: keep one-line feature inventory. Push per-feature deep dives into `docs/<feature>.md`. After the trim lands, re-stamp the catalog-doc-size hook so the new caps enforce locally going forward: ``` coily apply-catalog-doc-size-hook ARGS="--repo galaxy-gen" ``` **Why** - Fits the file into the daily digest cleanly. The digest is what agents loaded from agentic-os-kai's project context read for cross-repo questions; bloated source files push the digest dir out of useful range. **Umbrella** - [coilysiren/agentic-os-kai#549](https://github.com/coilysiren/agentic-os-kai/issues/549).
coilysiren added
P3
and removed
P2
labels 2026-05-31 07:00:30 +00:00
Sign in to join this conversation.
No labels
P0
P1
P2
P3
P4
No milestone
No project
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/galaxy-gen#2
No description provided.