Skip to content

Give question files scannable slugs (Q-NNN-short-slug.md)#7

Merged
DustinVK merged 1 commit into
mainfrom
wherefore/question-filename-slugs
Jul 4, 2026
Merged

Give question files scannable slugs (Q-NNN-short-slug.md)#7
DustinVK merged 1 commit into
mainfrom
wherefore/question-filename-slugs

Conversation

@DustinVK

@DustinVK DustinVK commented Jul 4, 2026

Copy link
Copy Markdown
Owner

What

Question files move from Q-NNN.md to Q-NNN-short-slug.md, matching the scannable naming that log entries already use. The Q-NNN prefix keeps files ID-sorted and greppable by number; the slug is for human scanning. The id: frontmatter field stays the authoritative ID (the dashboard keys off it, not the filename), so nothing downstream breaks.

Skills

  • capture — creates questions with a log-style slug; next-ID sed regex made slug-tolerant, still filename-based.
  • resolve — finds the file by globbing Q-NNN-*.md (with a Q-NNN.md legacy fallback) instead of opening a fixed name; examples updated.
  • ask — layout diagram updated (its Q-*.md globs already worked unchanged).
  • supersede — unchanged; it never references question files.

Docs

AGENTS.md, CLAUDE.md, and README.md updated to match.

Migration

This repo's own tracked questions Q-001..Q-007 renamed to slugged names (git mv, no frontmatter change). Existing legacy Q-NNN.md files elsewhere keep working via the resolve fallback and the slug-tolerant next-ID regex.

Not included

Untracked WIP left out of this branch: the packages/wherefore-dashboard/ skill/template copies (synced in the working tree, to be committed with that bundle), the untracked Q-008 question, and the in-progress plan/roadmap docs.

🤖 Generated with Claude Code

Question files move from Q-NNN.md to Q-NNN-short-slug.md, matching the
scannable naming that log entries already use. The Q-NNN prefix keeps files
ID-sorted and greppable by number; the slug is for human scanning. The id:
frontmatter field stays the authoritative ID (the dashboard keys off it, not
the filename), so nothing downstream breaks.

Skills:
- capture: create questions with a log-style slug; next-ID sed regex made
  slug-tolerant, still filename-based.
- resolve: find the file by globbing Q-NNN-*.md (with a Q-NNN.md legacy
  fallback) instead of opening a fixed name; examples updated.
- ask: layout diagram updated (its Q-*.md globs already worked).
- supersede: unchanged; it never references question files.

Specs/docs updated to match: AGENTS.md, CLAUDE.md, README.md.

Migrate this repo's own tracked questions Q-001..Q-007 to slugged names
(git mv, no frontmatter change).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@DustinVK DustinVK merged commit 4a67a00 into main Jul 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant