Clean up 43 documentation-layout violations, then re-enable the hook #11

New issue

Closed

opened 2026-05-29 05:19:45 +00:00 by coilysiren · 1 comment

coilysiren commented

2026-05-29 05:19:45 +00:00

Owner

Adopting the agentic-os pre-commit fleet surfaced 43 documentation-layout violations across atmosphere. The documentation-layout hook is deferred in .pre-commit-config.yaml until these are cleaned up, matching the fleet pattern used in agentic-os-kai.

Violations to resolve:

ideas/*.md and reference/*.md - markdown may live only at repo root, docs/*.md, or inside a skill folder. Decide whether ideas and reference move under docs/ or the layout rule gets a repo-scoped exception.
80-line / 4000-char doc caps exceeded by apps/bsky-scorer/seed-skill.md, reference/atproto-ecosystem.md, and the writing-bluesky skill's README.md, SKILL.md, and docs/THREADING.md. Split into smaller docs.
writing-bluesky skill folders are not flat (docs/, scripts/, tests/ subfolders). Flatten so contents sit beside SKILL.md, or adjust the skill layout rule.

Once resolved, re-enable documentation-layout in the managed block. This is the cleanup a fleet-wide cascade tool would automate.

Adopting the agentic-os pre-commit fleet surfaced 43 documentation-layout violations across atmosphere. The `documentation-layout` hook is deferred in `.pre-commit-config.yaml` until these are cleaned up, matching the fleet pattern used in agentic-os-kai. Violations to resolve: - `ideas/*.md` and `reference/*.md` - markdown may live only at repo root, `docs/*.md`, or inside a skill folder. Decide whether ideas and reference move under `docs/` or the layout rule gets a repo-scoped exception. - 80-line / 4000-char doc caps exceeded by `apps/bsky-scorer/seed-skill.md`, `reference/atproto-ecosystem.md`, and the `writing-bluesky` skill's `README.md`, `SKILL.md`, and `docs/THREADING.md`. Split into smaller docs. - `writing-bluesky` skill folders are not flat (`docs/`, `scripts/`, `tests/` subfolders). Flatten so contents sit beside SKILL.md, or adjust the skill layout rule. Once resolved, re-enable `documentation-layout` in the managed block. This is the cleanup a fleet-wide cascade tool would automate.

coilysiren referenced this issue from a commit

2026-05-29 05:22:52 +00:00

chore: adopt agentic-os pre-commit hook fleet

coilysiren referenced this issue

2026-05-29 05:26:58 +00:00

bsky-scorer: capture pre-flight spec and decisions as docs #12

coilysiren commented

2026-05-30 05:43:15 +00:00

Author

Owner

Merged into #4 in the 2026-05-29 backlog burn-down. Doc-layout violation cleanup, duplicate of #4 Reopen if it should stand alone.

coilysiren closed this issue