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

Fix doc-layout debt blocking v0.3.0 pre-commit adoption #8

New issue
Closed
opened 2026-05-28 09:59:46 +00:00 by coilysiren · 1 comment
coilysiren commented 2026-05-28 09:59:46 +00:00
Owner
Copy link

Pre-existing doc-layout debt blocks adopting the agentic-os v0.3.0 pre-commit block (blocks #7). The documentation-layout / catalog-doc-size hooks run repo-wide and currently fail on files unrelated to the rollout. Fix the four categories below, then the #7 commit can land.

1. Markdown in disallowed directories

Markdown may only live at repo root, docs/*.md, or inside a skill folder. Relocate (flatten into docs/ with filename prefixes, or move into a skill):

  • All of ideas/ (22 files): art-creative.md, atfile-storage.md, atproto-messaging.md, atproto-x-my-streams.md, categories.md, chat.md, clients.md, constellation-backlinks.md, dev-tools.md, events.md, feed-agent-engineering.md, feed-ai-infra.md, feed-atproto-dev.md, feed-go-cli.md, feed-homelab-k8s.md, feed-observability.md, feed-platform-eng.md, feed-supply-chain-sec.md, front-page.md, infra-primitives-overlap.md, jetstream-parser.md, joke-apps.md, kapwing-atproto-media.md, moderation-labelers.md, profile-link-in-bio.md, README.md, reviews-tracking.md, topic-feeds.md, whitewind-blog.md, wiki-walker.md
  • reference/atproto-ecosystem.md

2. Files over the size cap (80 lines / 4000 chars)

Split into smaller docs/*.md:

  • reference/atproto-ecosystem.md (125 lines, 5613 chars)
  • .agents/skills/writing-bluesky/docs/THREADING.md (198 lines, 6994 chars)
  • .agents/skills/writing-bluesky/README.md (103 lines)
  • .agents/skills/writing-bluesky/SKILL.md (97 lines)

3. AGENTS.md missing required H2 sections

Add: ## Scope, ## Project shape, ## Repo boundaries, ## Commands, ## Validation, ## Safety, ## Cross-repo contracts, ## Release, ## Agent rules.

4. After fixes

Land the v0.3.0 .pre-commit-config.yaml (closes #7) and sweep the regenerated coily lockdown files into the same commit.

Pre-existing doc-layout debt blocks adopting the agentic-os v0.3.0 pre-commit block (blocks #7). The `documentation-layout` / `catalog-doc-size` hooks run repo-wide and currently fail on files unrelated to the rollout. Fix the four categories below, then the #7 commit can land. ## 1. Markdown in disallowed directories Markdown may only live at repo root, `docs/*.md`, or inside a skill folder. Relocate (flatten into `docs/` with filename prefixes, or move into a skill): - All of `ideas/` (22 files): `art-creative.md`, `atfile-storage.md`, `atproto-messaging.md`, `atproto-x-my-streams.md`, `categories.md`, `chat.md`, `clients.md`, `constellation-backlinks.md`, `dev-tools.md`, `events.md`, `feed-agent-engineering.md`, `feed-ai-infra.md`, `feed-atproto-dev.md`, `feed-go-cli.md`, `feed-homelab-k8s.md`, `feed-observability.md`, `feed-platform-eng.md`, `feed-supply-chain-sec.md`, `front-page.md`, `infra-primitives-overlap.md`, `jetstream-parser.md`, `joke-apps.md`, `kapwing-atproto-media.md`, `moderation-labelers.md`, `profile-link-in-bio.md`, `README.md`, `reviews-tracking.md`, `topic-feeds.md`, `whitewind-blog.md`, `wiki-walker.md` - `reference/atproto-ecosystem.md` ## 2. Files over the size cap (80 lines / 4000 chars) Split into smaller `docs/*.md`: - `reference/atproto-ecosystem.md` (125 lines, 5613 chars) - `.agents/skills/writing-bluesky/docs/THREADING.md` (198 lines, 6994 chars) - `.agents/skills/writing-bluesky/README.md` (103 lines) - `.agents/skills/writing-bluesky/SKILL.md` (97 lines) ## 3. AGENTS.md missing required H2 sections Add: `## Scope`, `## Project shape`, `## Repo boundaries`, `## Commands`, `## Validation`, `## Safety`, `## Cross-repo contracts`, `## Release`, `## Agent rules`. ## 4. After fixes Land the v0.3.0 `.pre-commit-config.yaml` (closes #7) and sweep the regenerated coily lockdown files into the same commit.
coilysiren commented 2026-05-30 05:43:15 +00:00
Author
Owner
Copy link

Merged into #4 in the 2026-05-29 backlog burn-down. Doc-layout debt sweep, same cluster as #4 Reopen if it should stand alone.

Merged into #4 in the 2026-05-29 backlog burn-down. Doc-layout debt sweep, same cluster as #4 Reopen if it should stand alone.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels
  
P0
now / blocking / urgent

  
P1
next / important

  
P2
backlog / will do

  
P3
someday / low

  
P4
icebox / frozen / reopen if it becomes real

No labels
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
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/atmosphere#8
No description provided.