coilyco-flight-deck/atmosphere
Archived
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

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

New issue
Closed
opened 2026-05-26 04:45:22 +00:00 by coilysiren · 1 comment
coilysiren commented 2026-05-26 04:45:22 +00:00
Owner
Copy link

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.

**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 added
P3
 and removed
P2
 labels 2026-06-04 08:16:39 +00:00
coilysiren commented 2026-06-17 08:24:21 +00:00
Author
Owner
Copy link

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: burndown-2026-06.

Backlog burndown 2026-06-17: closing low-priority (P3/P4) to bring the open count to a manageable level. Nothing lost — reopen if this resurfaces. Batch tag: `burndown-2026-06`.
coilysiren 2026-06-17 08:24:21 +00:00
Commenting is not possible because the repository is archived.
No Branch/Tag specified
Branches Tags
main
chore/coilysiren-org-ref-update
No results found.
Labels
Clear labels   
burndown-2026-06
Backlog burndown June 2026

  
coherence-core
Core review set for the warded control plane coherence milestone. These issues form the release spine; adjacent milestone issues are stretch or supporting work.

  
consult
A human decision, design, or external action must happen first. Fail-closed default for unlabeled/low-confidence.

  
headless
Agent can take it from open issue to merged change with no human in the loop. The auto-burndown queue.

  
interactive
Agent does the work but pauses at a human checkpoint mid-flight (design choice, destructive step, human-only verification).

  
P0
now / blocking / urgent

  
P1
next / important

  
P2
backlog / will do

  
P3
someday / low

  
P4
icebox / frozen / reopen if it becomes real

No labels
burndown-2026-06
coherence-core
consult
headless
interactive
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
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/atmosphere#4
No description provided.