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

New issue

Closed

opened 2026-05-23 20:54:20 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-05-23 20:54:20 +00:00

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 the

label

2026-05-31 01:54:26 +00:00

coilysiren commented

2026-06-17 08:23:33 +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:23:34 +00:00