Clear pre-commit documentation-layout / catalog violations #5

New issue

Closed

opened 2026-05-28 03:21:17 +00:00 by coilysiren · 0 comments

coilysiren commented

2026-05-28 03:21:17 +00:00

Owner

Clear pre-commit documentation-layout / catalog violations

Goal: make the full pre-commit gate pass on this repo. Reproduce with:

coily exec pre-commit-all

Failing hooks and findings as of 2026-05-27:

stale worktree, fix first - several violations point at .claude/worktrees/eager-hermann/... (a committed/tracked stale git worktree, including its own AGENTS.md and mod READMEs). Remove it from tracking and gitignore .claude/worktrees/ so it stops being scanned. That clears roughly half the findings.
documentation-layout - mod READMEs under Mods/UserCode/BunWulf*/README.md and Mods/UserCode/MinesQuarries/README.md are flagged for location. These are part of each mod's directory structure, so exclude Mods/** via a [tool.agentic-os.documentation-layout] excludes entry rather than moving them.
catalog-trifecta - AGENTS.md is missing required H2 headings: ## Scope, ## Project shape, ## Repo boundaries, ## Commands, ## Validation, ## Safety, ## Cross-repo contracts, ## Release, ## Agent rules.

Voice rules apply (no em-dashes, no semicolons in prose, she/her). Verify with coily exec pre-commit-all, then commit to main with closes <this issue url>.

## Clear pre-commit documentation-layout / catalog violations Goal: make the full pre-commit gate pass on this repo. Reproduce with: ``` coily exec pre-commit-all ``` Failing hooks and findings as of 2026-05-27: - **stale worktree, fix first** - several violations point at `.claude/worktrees/eager-hermann/...` (a committed/tracked stale git worktree, including its own `AGENTS.md` and mod READMEs). Remove it from tracking and gitignore `.claude/worktrees/` so it stops being scanned. That clears roughly half the findings. - **documentation-layout** - mod READMEs under `Mods/UserCode/BunWulf*/README.md` and `Mods/UserCode/MinesQuarries/README.md` are flagged for location. These are part of each mod's directory structure, so exclude `Mods/**` via a `[tool.agentic-os.documentation-layout]` `excludes` entry rather than moving them. - **catalog-trifecta** - `AGENTS.md` is missing required H2 headings: `## Scope`, `## Project shape`, `## Repo boundaries`, `## Commands`, `## Validation`, `## Safety`, `## Cross-repo contracts`, `## Release`, `## Agent rules`. Voice rules apply (no em-dashes, no semicolons in prose, she/her). Verify with `coily exec pre-commit-all`, then commit to main with `closes <this issue url>`.

coilysiren referenced this issue from a commit

2026-05-28 03:28:35 +00:00

chore: clear pre-commit documentation-layout and catalog violations

coilysiren closed this issue

2026-05-28 03:28:35 +00:00

Commenting is not possible because the repository is archived.