coilyco-flight-deck/voice-flow-learning-loop
Archived
1
0
Fork 0
Code Issues 11 Pull requests Projects Releases Packages Wiki Activity Actions

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

New issue
Open
opened 2026-05-28 09:59:47 +00:00 by coilysiren · 0 comments
coilysiren commented 2026-05-28 09:59:47 +00:00
Owner
Copy link

Pre-existing doc-layout debt blocks adopting the agentic-os v0.3.0 pre-commit block (blocks #15). The documentation-layout, catalog-doc-size, and catalog-trifecta hooks run repo-wide and currently fail. Fix the items below, then the #15 commit can land.

1. docs/ must stay flat

docs/snippets-mining-runs/ is a disallowed subdirectory. Flatten into docs/*.md with filename prefixes:

  • docs/snippets-mining-runs/2026-05-20.md (5621 chars, over cap)
  • docs/snippets-mining-runs/2026-05-20-layer2.md (110 lines, 10312 chars, over cap)

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

  • README.md (168 lines, 14100 chars) - split into docs/*.md
  • the two snippets-mining-runs files above

3. Trifecta (catalog-trifecta)

  • AGENTS.md is missing - create it at repo root with the standard H2 sections.
  • README.md needs a ## See also section linking to AGENTS.md, docs/FEATURES.md, and .coily/coily.yaml, plus the convention citation coilysiren/agentic-os#59.
  • Likely also need docs/FEATURES.md for the trifecta to resolve.

4. After fixes

The catalog block in .coily/coily.yaml already needs dependsOn: [] / providesApis: [] (already added in the working tree). Land the v0.3.0 .pre-commit-config.yaml (closes #15) 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 #15). The `documentation-layout`, `catalog-doc-size`, and `catalog-trifecta` hooks run repo-wide and currently fail. Fix the items below, then the #15 commit can land. ## 1. `docs/` must stay flat `docs/snippets-mining-runs/` is a disallowed subdirectory. Flatten into `docs/*.md` with filename prefixes: - `docs/snippets-mining-runs/2026-05-20.md` (5621 chars, over cap) - `docs/snippets-mining-runs/2026-05-20-layer2.md` (110 lines, 10312 chars, over cap) ## 2. Files over the size cap (80 lines / 4000 chars) - `README.md` (168 lines, 14100 chars) - split into `docs/*.md` - the two `snippets-mining-runs` files above ## 3. Trifecta (catalog-trifecta) - `AGENTS.md` is missing - create it at repo root with the standard H2 sections. - `README.md` needs a `## See also` section linking to `AGENTS.md`, `docs/FEATURES.md`, and `.coily/coily.yaml`, plus the convention citation `coilysiren/agentic-os#59`. - Likely also need `docs/FEATURES.md` for the trifecta to resolve. ## 4. After fixes The catalog block in `.coily/coily.yaml` already needs `dependsOn: []` / `providesApis: []` (already added in the working tree). Land the v0.3.0 `.pre-commit-config.yaml` (closes #15) and sweep the regenerated coily lockdown files into the same commit.
coilysiren added
P2
 and removed
P1
 labels 2026-05-31 07:01:23 +00:00
Commenting is not possible because the repository is archived.
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
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/voice-flow-learning-loop#16
No description provided.