docs(catalog): add claude-ask-questions to community preset catalog#2191
docs(catalog): add claude-ask-questions to community preset catalog#21910xrafasec wants to merge 4 commits intogithub:mainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates the /clarify and /checklist command templates to support Claude Code’s native AskUserQuestion structured picker by fencing the question-rendering blocks in the templates and post-processing them during Claude skill generation, while leaving non-Claude integrations functionally unchanged.
Changes:
- Added HTML comment fence markers around question-rendering sections in
clarify.mdandchecklist.md. - Extended
ClaudeIntegration.setup()to replace fenced blocks withAskUserQuestion-based instructions for the Claude-generated skills. - Added Claude integration tests covering replacement behavior, parity expectations, and basic downstream behavior preservation checks.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 8 comments.
| File | Description |
|---|---|
templates/commands/clarify.md |
Adds begin/end fence markers around the clarify question-rendering rules block. |
templates/commands/checklist.md |
Adds begin/end fence markers around the checklist question-formatting rules block. |
src/specify_cli/integrations/claude/__init__.py |
Adds fenced-block replacement logic and AskUserQuestion replacement instructions for clarify/checklist at skill generation time. |
tests/integrations/test_integration_claude.py |
Adds tests ensuring Claude output uses AskUserQuestion, and that non-Claude outputs do not. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
mnriem
left a comment
mnriem
left a comment
There was a problem hiding this comment.
Please deliver this as a preset similar to how it was done for VSCode (see https://github.com/github/spec-kit/tree/main/presets and foto see how it was done for VSCode see https://github.com/fdcastel/spec-kit-presets/tree/main/vscode-ask-questions)
Delivers the /speckit.clarify and /speckit.checklist AskUserQuestion
integration as a stackable preset under presets/claude-ask-questions/
instead of modifying core templates or ClaudeIntegration.
- presets/claude-ask-questions/preset.yml registers command overrides
for speckit.clarify and speckit.checklist following the same pattern
as the bundled lean preset.
- Override commands replace the Markdown-table question-rendering
blocks with AskUserQuestion instructions. Option | Description maps
to {label, description} for clarify; Option | Candidate | Why It
Matters maps to {label: Candidate, description: Why It Matters} for
checklist. Recommended option is placed first with a
"Recommended — <reasoning>" prefix; a final "Custom"/"Short" option
preserves the free-form ≤5-word escape hatch.
- Registered in presets/catalog.json as a bundled preset.
Core templates, ClaudeIntegration, and the existing test suite are
left untouched, so non-Claude agents and users who do not install
this preset see no behavior change.
Closes github#2181
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
0xrafasec
force-pushed
the
feat/claude-ask-user-question
branch
from
9ddb174 to
64ea94d
Compare
|
Thanks @mnriem for the thoughtful review and the pointer to the VSCode preset pattern — that's a much cleaner fit than modifying core. I've reworked the PR from scratch as a preset: the in-core changes to
Core templates, Ready for another look when you have a moment. 🙏 |
|
Looks good, but we also would like you to host this on a GitHub repository of your own. As per https://github.com/github/spec-kit/blob/main/presets/PUBLISHING.md |
Per maintainer feedback on github#2191, presets should be hosted on the author's own GitHub repository and registered in catalog.community.json rather than bundled in spec-kit. Removes the bundled preset directory and its entry from the official catalog, and adds a community catalog entry pointing at the external repository and release archive. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR updates the preset catalog timestamps and adds a new community preset entry (claude-ask-questions) to presets/catalog.community.json.
Changes:
- Bumped
updated_atinpresets/catalog.json. - Bumped
updated_atinpresets/catalog.community.json. - Added a new community preset entry:
claude-ask-questions(v1.0.0).
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| presets/catalog.json | Updates the catalog updated_at timestamp. |
| presets/catalog.community.json | Updates the catalog updated_at timestamp and adds the claude-ask-questions preset metadata entry. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
Thanks @mnriem — done. The preset now lives in its own repository and is submitted through
Changes in this PR (now scoped down to a single file):
PUBLISHING.md checklist:
Ready for another look whenever you have a moment 🙏 |
There was a problem hiding this comment.
Pull request overview
This PR updates the preset catalogs by adding a new community preset entry (claude-ask-questions) and bumping catalog timestamps, making the preset discoverable via the built-in community preset catalog.
Changes:
- Add
claude-ask-questionstopresets/catalog.community.json. - Bump
updated_atin bothpresets/catalog.community.jsonandpresets/catalog.json.
Show a summary per file
| File | Description |
|---|---|
| presets/catalog.json | Updates top-level updated_at timestamp. |
| presets/catalog.community.json | Updates top-level updated_at and adds the claude-ask-questions community preset entry. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 2/2 changed files
- Comments generated: 2
mnriem
left a comment
mnriem
left a comment
There was a problem hiding this comment.
Please address Copilot feedback. Should be the latest thing I hope
No entries in the official catalog changed in this PR, so the timestamp bump was spurious. Addresses Copilot review feedback on github#2191.
0xrafasec
changed the title
There was a problem hiding this comment.
Pull request overview
Registers the new claude-ask-questions community preset in presets/catalog.community.json so it can be discovered via specify preset search.
Changes:
- Bumps the catalog’s top-level
updated_attimestamp. - Adds the
claude-ask-questionspreset entry (includingdownload_url, metadata, andrequires/provides).
Show a summary per file
| File | Description |
|---|---|
presets/catalog.community.json |
Adds the new preset entry in the correct alphabetical position and updates catalog metadata timestamp. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 1/1 changed files
- Comments generated: 0
Summary
Registers the claude-ask-questions preset in
presets/catalog.community.jsonso it becomes discoverable viaspecify preset search.The preset itself is hosted on an external repository, as required by
presets/PUBLISHING.md:Closes #2181.
What the preset does
Replaces the Markdown-table question rendering in
/speckit.clarifyand/speckit.checklistwith Claude Code's nativeAskUserQuestionstructured picker, with a recommended option and reasoning surfaced on every question. Pure presentation-layer change — the upstream ambiguity taxonomy, 5-question cap, and spec-integration rules are preserved verbatim.Only users who explicitly install the preset see any change; everyone else is unaffected.
What changed in this PR
This PR is catalog-only. Every earlier approach (template fence markers,
ClaudeIntegrationpost-processing, bundling the preset underpresets/claude-ask-questions/) has been removed per maintainer feedback.presets/catalog.community.jsonclaude-ask-questionsentry (alphabetical position betweencanon-coreandexplicit-task-dependencies), bumpsupdated_atto2026-04-13.No core changes, no template changes, no test changes.
PUBLISHING.md checklist
preset.ymlmanifest (lowercase-hyphenid, semver, description < 200 chars, dot-notation command names)README.mdwith description + usageCONTRIBUTING.mdLICENSE(MIT)CHANGELOG.mdv1.0.0release with a verified 200 archive URLcatalog.community.jsonspecify preset add --dev— command overrides register to.claude/commands/speckit.clarify.mdand.claude/commands/speckit.checklist.mdAI assistance disclosure
This submission was prepared with assistance from Claude Code (Claude Opus 4.6). I reviewed and verified all changes manually.
Test plan
python3 -m json.tool presets/catalog.community.json— valid JSONcurl -sI -L https://github.com/0xrafasec/spec-kit-preset-claude-ask-questions/archive/refs/tags/v1.0.0.zip— returns 200specify preset add --dev🤖 Generated with Claude Code