chore: fix catalog-doc-size violations exposed by agentic-os v0.2.8 #83

New issue

Open

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

coilysiren commented

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

Owner

Problem

The agentic-os v0.2.8 bump (#254 sweep) exposes pre-existing Markdown size-cap violations. v0.2.6 silently parse-errored on the documentation-layout hook (fixed in agentic-os@13490a4); v0.2.7+ enforce it.

Failing files:

AGENTS.md - 4978 chars > 4000 cap.
README.md - 94 lines > 80 cap, 4353 chars > 4000.
docs/FEATURES.md - 4990 chars > 4000.
.agents/skills/tooling-autonomous-pickup/SKILL.md - 87 lines > 80, 6826 chars > 4000.
cert-and-localhost-mess.md - 203 lines, 8350 chars (also a documentation-layout violation - see sibling issue).

Fix

Split each over-cap file into smaller docs/*.md files, leaving a pointer at the original location. Per AGENTS.md docs/ is flat - use filename prefixes.

Verify with:

pre-commit run catalog-doc-size --all-files

Context

Filed as follow-up to #254 so the code-comments sweep could land without scope creep. The #254 commit skipped this hook via SKIP=catalog-doc-size.

Ported from coilysiren/repo-recall#255.

**Problem** The agentic-os v0.2.8 bump (#254 sweep) exposes pre-existing Markdown size-cap violations. v0.2.6 silently parse-errored on the documentation-layout hook (fixed in agentic-os@13490a4); v0.2.7+ enforce it. Failing files: - `AGENTS.md` - 4978 chars > 4000 cap. - `README.md` - 94 lines > 80 cap, 4353 chars > 4000. - `docs/FEATURES.md` - 4990 chars > 4000. - `.agents/skills/tooling-autonomous-pickup/SKILL.md` - 87 lines > 80, 6826 chars > 4000. - `cert-and-localhost-mess.md` - 203 lines, 8350 chars (also a documentation-layout violation - see sibling issue). **Fix** Split each over-cap file into smaller `docs/*.md` files, leaving a pointer at the original location. Per AGENTS.md `docs/` is flat - use filename prefixes. Verify with: ``` pre-commit run catalog-doc-size --all-files ``` **Context** Filed as follow-up to #254 so the code-comments sweep could land without scope creep. The #254 commit skipped this hook via `SKIP=catalog-doc-size`. --- _Ported from coilysiren/repo-recall#255._

coilysiren added the

label

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

coilysiren added

and removed

labels

2026-05-31 07:01:07 +00:00

No labels

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/repo-recall#83

No description provided.

Rows
Columns