coilyco-flight-deck/gauntlet
1
0
Fork 0
Code Issues 5 Pull requests Projects Releases Packages Wiki Activity Actions 3

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

New issue
Open
opened 2026-05-26 05:22:59 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-26 05:22:59 +00:00
Owner
Copy link

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
P3
 and removed
P2
 labels 2026-05-31 07:00:31 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
claude/peaceful-khorana-f0a719
worktree-agent-ac17b823
worktree-agent-a1cf7102
worktree-agent-a9e4ff5f
worktree-agent-abb6c04a
claude/loving-herschel-af53e4
claude/crazy-gould
No results found.
Labels
Clear labels
  
P0
now / blocking / urgent

  
P1
next / important

  
P2
backlog / will do

  
P3
someday / low

  
P4
icebox / frozen / reopen if it becomes real

No labels
P0
P1
P2
P3
P4
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
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/gauntlet#14
No description provided.