Repository navigation
Open
Labels
documentationDocs, prose, diagrams, READMEs, ADRsDocs, prose, diagrams, READMEs, ADRspriority:p2Normal - queue itNormal - queue itscope:repoConfined to this repositoryConfined to this repositorystatus:readyFully specified and ready to be picked upFully specified and ready to be picked up
Description
Summary
AGENTS.md, GEMINI.md, .junie/guidelines.md, and .claude/CLAUDE.generated.md all claim to be auto-generated from coordination.k9 via:
deno run --allow-read --allow-write generate.js coordination.k9
But generate.js does not exist anywhere in the repo:
$ find . -name "generate.js" -not -path "./node_modules/*"
(no results)
Surfaced by the panll#66 post-#65 doc-sweep meander.
Affected files (6 references)
AGENTS.md:3(HTML comment) +AGENTS.md:8(blockquote)GEMINI.md:3+GEMINI.md:8.junie/guidelines.md:3+.junie/guidelines.md:8.claude/CLAUDE.generated.md:2(related Source header — different sub-context but same generator-claim pattern)
Why this matters
coordination.k9 is the declared source-of-truth. Without an actual generator script:
- Any edit to
coordination.k9has to be mirrored manually across 3 (or 4) downstream files - panll#66 had to edit all of them in sync to prevent drift on a future regeneration
- Future contributors copy the header instruction, run it, get "file not found", and either give up or hand-edit — degrading the source-of-truth invariant
Hypotheses (one of)
generate.jsexisted and was deleted in a sweep — restore from git history.- The generator is now a different tool (e.g.
k9iser— seek9iser.toml) and the header is stale. - The generator was never committed (run-locally-then-commit-outputs); should be added.
k9iser.toml exists but appears to be a config-validation manifest (must: predicates over JSON configs), generating files into generated/k9iser/ — not the AGENTS/GEMINI/.junie generator. So hypothesis (2) is unlikely to be a 1:1 swap.
Suggested resolution
-
git log --diff-filter=D -- generate.jsto check if it was ever in-tree - If found, restore + update headers to match
- If never in-tree, either (a) write the generator (small Deno script reading
coordination.k9and emitting the four files), or (b) drop the auto-generated framing and letcoordination.k9+ the four files be co-equal source-of-truth (with a maintenance note) - Either way: update
.claude/CLAUDE.generated.mdto match whatever convention lands
Related
- panll#65 — npm→Deno migration (closed the broader migration debt)
- panll#66 — post-chore: migrate panll off npm onto Deno (standards#253 step) #65 doc sweep (manually synced all 4 files +
coordination.k9to prevent drift) - panll#67 — companion stale-doc-line PR
🤖 Filed by Claude Code
Metadata
Metadata
Assignees
Labels
documentationDocs, prose, diagrams, READMEs, ADRsDocs, prose, diagrams, READMEs, ADRspriority:p2Normal - queue itNormal - queue itscope:repoConfined to this repositoryConfined to this repositorystatus:readyFully specified and ready to be picked upFully specified and ready to be picked up
Activity
fix(launcher): regenerate panll launcher with the XDG pid/log ladder (#…