K9 coordination generator `generate.js` referenced in AGENTS/GEMINI/.junie headers but missing from repo

[hyperpolymath]

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.k9 has 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)

1. generate.js existed and was deleted in a sweep — restore from git history.
2. The generator is now a different tool (e.g. k9iser — see k9iser.toml) and the header is stale.
3. 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.js to 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.k9 and emitting the four files), or (b) drop the auto-generated framing and let coordination.k9 + the four files be co-equal source-of-truth (with a maintenance note)
• Either way: update .claude/CLAUDE.generated.md to 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.k9 to prevent drift)
• panll#67 — companion stale-doc-line PR

🤖 Filed by Claude Code