documentation-layout - revert tier policy, single 80/4000 cap for all Markdown including AGENTS.md and SKILL.md #83

New issue

Closed

opened 2026-05-28 01:36:14 +00:00 by coilysiren · 0 comments

coilysiren commented

2026-05-28 01:36:14 +00:00

Owner

Problem

The tier policy I added in #82 (commit f82d966) was wrong. AGENTS.md, CLAUDE.md, and SKILL.md should follow the same 80-line / 4000-char cap as every other Markdown file. There is no loader-bound exception. CLAUDE.md is intended to be a one-line @AGENTS.md pointer, not a full doc.

Fix

Remove LOADER_BOUND_BASENAMES, LOADER_MAX_LINES, LOADER_MAX_CHARS, and caps_for() from check_documentation_layout.py. Restore the single-cap size check.
Update each pointer-reference doc to drop "loader-bound tier" / "standard tier" framing. The validator has one cap; docs point at it without claiming tiers exist.
Module docstring updated to match.

Out of scope

Trimming AGENTS.md and SKILL.md files down to 80/4000. Tracked in #81 (agentic-os) and agentic-os-kai#370.

Acceptance

grep -n 'LOADER\|loader-bound\|tier' agentic_os/check_documentation_layout.py returns nothing.
Validator has one set of size constants.
Pointer-reference docs no longer mention tiers.

**Problem** The tier policy I added in #82 (commit f82d966) was wrong. AGENTS.md, CLAUDE.md, and SKILL.md should follow the **same** 80-line / 4000-char cap as every other Markdown file. There is no loader-bound exception. CLAUDE.md is intended to be a one-line `@AGENTS.md` pointer, not a full doc. **Fix** - Remove `LOADER_BOUND_BASENAMES`, `LOADER_MAX_LINES`, `LOADER_MAX_CHARS`, and `caps_for()` from `check_documentation_layout.py`. Restore the single-cap size check. - Update each pointer-reference doc to drop "loader-bound tier" / "standard tier" framing. The validator has one cap; docs point at it without claiming tiers exist. - Module docstring updated to match. **Out of scope** - Trimming AGENTS.md and SKILL.md files down to 80/4000. Tracked in #81 (agentic-os) and agentic-os-kai#370. **Acceptance** - `grep -n 'LOADER\|loader-bound\|tier' agentic_os/check_documentation_layout.py` returns nothing. - Validator has one set of size constants. - Pointer-reference docs no longer mention tiers.

coilysiren referenced this issue from a commit

2026-05-28 01:38:15 +00:00

revert(documentation-layout): drop loader-bound tier, single 80/4000 cap for all Markdown

coilysiren closed this issue

2026-05-28 01:38:15 +00:00

coilysiren referenced this issue from a commit

2026-05-28 01:38:41 +00:00

docs(AGENTS): drop tier language from size-cap pointer references

coilysiren referenced this issue

2026-05-28 03:22:02 +00:00

documentation-layout - per-repo AGENTS.md cap override, relocate doctrine to skills #84