Sweep pre-existing documentation-layout and code-comments violations #4

New issue

Open

opened 2026-05-26 04:45:22 +00:00 by coilysiren · 0 comments

coilysiren commented

2026-05-26 04:45:22 +00:00

Owner

Problem

The apply-agentic-os-hooks pre-commit config (untracked locally as of this issue) surfaces ~40 pre-existing violations across the repo:

reference/atproto-ecosystem.md over 80-line / 4000-char cap
.agents/skills/writing-bluesky/docs/THREADING.md over 4000-char cap
.claude/lockdown-deny.sh contiguous-comment blocks of 3-5 lines
~37 more documentation-layout violations not yet enumerated

Until these are resolved, every commit hits the full repo-wide validator set even for unrelated changes.

Plan

Enumerate full violation set with pre-commit run --all-files.
Split oversized docs into multiple files under docs/.
Trim comment blocks in .claude/lockdown-deny.sh (move long context to docs/).
Commit .pre-commit-config.yaml once green.

Context

Filed alongside coilysiren/atmosphere#3 (marker-file commit), which used SKIP=documentation-layout,code-comments to land scoped without sweeping these unrelated violations.

**Problem** The `apply-agentic-os-hooks` pre-commit config (untracked locally as of this issue) surfaces ~40 pre-existing violations across the repo: - `reference/atproto-ecosystem.md` over 80-line / 4000-char cap - `.agents/skills/writing-bluesky/docs/THREADING.md` over 4000-char cap - `.claude/lockdown-deny.sh` contiguous-comment blocks of 3-5 lines - ~37 more documentation-layout violations not yet enumerated Until these are resolved, every commit hits the full repo-wide validator set even for unrelated changes. **Plan** 1. Enumerate full violation set with `pre-commit run --all-files`. 2. Split oversized docs into multiple files under `docs/`. 3. Trim comment blocks in `.claude/lockdown-deny.sh` (move long context to `docs/`). 4. Commit `.pre-commit-config.yaml` once green. **Context** Filed alongside coilysiren/atmosphere#3 (marker-file commit), which used `SKIP=documentation-layout,code-comments` to land scoped without sweeping these unrelated violations.

coilysiren referenced this issue from a commit

2026-05-26 04:59:41 +00:00

chore: add catalog trifecta (marker, AGENTS, FEATURES, README See also)

coilysiren referenced this issue from coilyco-bridge/eco-mods-assets-embeded

2026-05-26 17:39:39 +00:00

Sweep pre-existing validator violations after agentic-os-hooks apply #2

coilysiren referenced this issue from coilyco-flight-deck/eco-replay

2026-05-26 17:39:40 +00:00

Sweep pre-existing validator violations after agentic-os-hooks apply #10

coilysiren referenced this issue from coilysiren/algo-zone

2026-05-26 17:39:41 +00:00

Sweep pre-existing validator violations after agentic-os-hooks apply #2