chore: clean up documentation-layout violations after v0.2.8 #14

New issue

Closed

opened 2026-05-26 05:22:59 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-05-26 05:22:59 +00:00

Owner

Problem

The agentic-os pre-commit suite v0.2.8 enabled documentation-layout with a strict allow-list of root Markdown files and an 80-line / 4000-char cap per file. Running pre-commit run --all-files surfaces 24 violations:

SCOPE.md not on the root Markdown allow-list (move under docs/).
agents/*.md not allowed at that path (move into docs/ or a skill folder).
README.md, SCOPE.md, docs/FEATURES.md, docs/architecture.md, docs/development.md, docs/hardening-prompt-template.md, docs/usage.md, skills/gauntlet/SKILL.md, skills/gauntlet-author/SKILL.md over the 80-line / 4000-char cap.

Fix

Move and split until pre-commit run documentation-layout --all-files is clean. Then drop documentation-layout from the SKIP list in the commit that resolves this.

Context

Surfaced while landing #39 (code-comments cleanup). Skipped there to keep that commit scoped.

Ported from coilysiren/gauntlet#40.

**Problem** The agentic-os pre-commit suite v0.2.8 enabled `documentation-layout` with a strict allow-list of root Markdown files and an 80-line / 4000-char cap per file. Running `pre-commit run --all-files` surfaces 24 violations: - `SCOPE.md` not on the root Markdown allow-list (move under `docs/`). - `agents/*.md` not allowed at that path (move into `docs/` or a skill folder). - `README.md`, `SCOPE.md`, `docs/FEATURES.md`, `docs/architecture.md`, `docs/development.md`, `docs/hardening-prompt-template.md`, `docs/usage.md`, `skills/gauntlet/SKILL.md`, `skills/gauntlet-author/SKILL.md` over the 80-line / 4000-char cap. **Fix** Move and split until `pre-commit run documentation-layout --all-files` is clean. Then drop `documentation-layout` from the SKIP list in the commit that resolves this. **Context** Surfaced while landing #39 (code-comments cleanup). Skipped there to keep that commit scoped. --- _Ported from coilysiren/gauntlet#40._

coilysiren added the

label

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

coilysiren commented

2026-06-17 08:24:14 +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:24:14 +00:00