chore: fix documentation-layout violations exposed by agentic-os v0.2.8 #85

New issue

Open

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

coilysiren commented

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

Owner

Problem

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

Failing:

docs/pr-screenshots/ - docs/ must stay flat. Use filename prefixes or move screenshots out of docs/.
cert-and-localhost-mess.md - top-level Markdown filename not allowed. Move into docs/ (e.g. docs/cert-and-localhost-mess.md).
tests/fixtures/README.md - Markdown allowed only at repo root, docs/*.md, or inside a skill folder.
tests/fixtures/github/errors/README.md - same.

Fix

Move or rename each file to comply. Cross-check against the catalog-doc-size sibling (#255) since some files violate both.

Verify with:

pre-commit run documentation-layout --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=documentation-layout.

Ported from coilysiren/repo-recall#257.

**Problem** The agentic-os v0.2.8 bump (#254 sweep) exposes pre-existing documentation-layout violations. v0.2.6 silently parse-errored on this hook (fixed in agentic-os@13490a4); v0.2.7+ enforce it. Failing: - `docs/pr-screenshots/` - `docs/` must stay flat. Use filename prefixes or move screenshots out of `docs/`. - `cert-and-localhost-mess.md` - top-level Markdown filename not allowed. Move into `docs/` (e.g. `docs/cert-and-localhost-mess.md`). - `tests/fixtures/README.md` - Markdown allowed only at repo root, `docs/*.md`, or inside a skill folder. - `tests/fixtures/github/errors/README.md` - same. **Fix** Move or rename each file to comply. Cross-check against the catalog-doc-size sibling (#255) since some files violate both. Verify with: ``` pre-commit run documentation-layout --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=documentation-layout`. --- _Ported from coilysiren/repo-recall#257._

coilysiren added the

label

2026-05-31 01:54:57 +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#85

No description provided.

Rows
Columns