Skip to content

fix: clean up command templates (specify, analyze)#1810

Merged
mnriem merged 2 commits intogithub:mainfrom
pierluigilenoci:fix/command-template-cleanups
Mar 13, 2026
Merged

fix: clean up command templates (specify, analyze)#1810
mnriem merged 2 commits intogithub:mainfrom
pierluigilenoci:fix/command-template-cleanups

Conversation

@pierluigilenoci
Copy link
Contributor

Summary

  • specify.md: Fix self-referential step number — step 6c says "proceed to step 6" but should say "proceed to step 7" (Report completion)
  • specify.md: Remove empty ## General Guidelines heading that has no content before ## Quick Guidelines
  • analyze.md: Deduplicate {ARGS} — the ## Context section at the bottom repeats the same arguments already present in the ## User Input section at the top

Test plan

  • Verify specify.md step 6c correctly references step 7
  • Verify no empty headings remain in specify.md
  • Verify analyze.md still passes {ARGS} context correctly via the ## User Input section

- specify.md: fix self-referential step number (step 6c → proceed to step 7)
- specify.md: remove empty "General Guidelines" heading before "Quick Guidelines"
- analyze.md: deduplicate {ARGS} — already present in "User Input" section at top
@pierluigilenoci pierluigilenoci requested a review from mnriem as a code owner March 11, 2026 19:09
@pierluigilenoci
Copy link
Contributor Author

cc @localden @sigent as top contributors to these files — would appreciate your review.

Copy link
Contributor

@dhilipkumars dhilipkumars left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

some comments from myside
cc: @mnriem

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Cleans up command prompt templates under templates/commands/ to remove minor inconsistencies/redundancy and improve instruction clarity for the specify and analyze commands.

Changes:

  • Fixes an incorrect step reference in specify.md (validation pass now proceeds to step 7, matching “Report completion”).
  • Removes an empty ## General Guidelines heading from specify.md.
  • Removes a duplicated {ARGS} block in analyze.md, keeping context passed via ## User Input while still retaining a single {ARGS} reference.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
templates/commands/specify.md Corrects step cross-reference and removes an empty heading for cleaner instructions.
templates/commands/analyze.md Eliminates redundant {ARGS} section and replaces it with a single inline context line.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Collaborator

@mnriem mnriem left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please address the feedback given by @dhilipkumars and Copilot. If not applicable, please explain why.

Address PR review feedback from @dhilipkumars: keep the ## Context
markdown heading to preserve structural hierarchy for LLM parsing.
@pierluigilenoci
Copy link
Contributor Author

@dhilipkumars @mnriem I've addressed the feedback — restored the ## Context heading in analyze.md as suggested. Could you please take another look? Thanks!

Copy link
Contributor

@dhilipkumars dhilipkumars left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@mnriem mnriem merged commit 017e1c4 into github:main Mar 13, 2026
12 checks passed
@pierluigilenoci pierluigilenoci deleted the fix/command-template-cleanups branch March 13, 2026 14:05
kanfil added a commit to tikalk/agentic-sdlc-spec-kit that referenced this pull request Mar 13, 2026
…recation

Merged upstream changes:
- fix: clean up command templates (specify, analyze) (github#1810)
- fix: migrate Qwen Code CLI from TOML to Markdown format (github#1730)
- fix(cli): deprecate explicit command support for agy (github#1808)
- Add /selftest.extension core extension to test other extensions (github#1758)
- feat(extensions): Quality of life improvements for RFC-aligned catalog (github#1776)

Conflict resolution:
- README.md: Kept our categorized agent table, added Jules agent
- extensions/catalog.json: Added selftest extension, kept our extensions
- src/specify_cli/__init__.py: Kept our extension management, added agy deprecation
- src/specify_cli/extensions.py: Merged improvements, kept our qwen toml format
- tests/test_ai_skills.py: Added upstream's qwen markdown tests
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.

4 participants