Skip to content

Commit 75b93c3

Browse files
committed
feat(prompts): enhance Show & Tell requirements for GitHub Copilot execution
1 parent 66ef9ee commit 75b93c3

2 files changed

Lines changed: 33 additions & 6 deletions

File tree

.specify/extensions/prompts/speckit.plan.prompt.ext.md

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,22 @@ You **MUST** adhere to the following mandatory requirements when creating a deve
1414

1515
## Show & Tell Sections (Mandatory)
1616

17-
Each phase and user story in `plan.md` must include a `### Show & Tell` subsection. This subsection defines the demonstration steps that will be:
17+
Each phase and user story in `plan.md` must include a `Show & Tell` subsection. This subsection defines the demonstration steps that will be:
1818

1919
1. Expanded with specific commands in `tasks.md` (next phase)
2020
2. Executed by the user during implementation to verify completion
2121

22+
### GitHub Copilot Execution Requirement (Mandatory)
23+
24+
Show & Tell steps must be written so GitHub Copilot can execute and validate them without guessing.
25+
26+
- Use explicit, runnable commands, URLs, and API calls
27+
- Include an expected result for every step (output text, status code, or visible UI state)
28+
- Avoid vague language such as "check it works" or "verify manually"
29+
- State pass/fail criteria clearly so steps cannot be skipped or missed during `/speckit.implement`
30+
31+
During implementation, GitHub Copilot **MUST** execute every Show & Tell step and confirm the expected result before marking the phase or user story complete.
32+
2233
## Plan Completion Checklist (Mandatory)
2334

2435
Before marking `plan.md` as complete, verify:
@@ -36,8 +47,10 @@ Before marking `plan.md` as complete, verify:
3647
- [ ] Tool Version Management
3748
- [ ] Each phase and user story includes a `### Show & Tell` subsection
3849
- [ ] Show & Tell subsections are placed at the end of each phase or user story
50+
- [ ] Show & Tell steps are specific enough for GitHub Copilot to execute and validate without ambiguity
51+
- [ ] Show & Tell steps define explicit expected outcomes and pass/fail criteria
3952

4053
---
4154

42-
> **Version**: 1.5.1
43-
> **Last Amended**: 2026-01-21
55+
> **Version**: 1.5.2
56+
> **Last Amended**: 2026-02-20

.specify/extensions/prompts/speckit.tasks.prompt.ext.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ You **MUST** adhere to the following mandatory requirements when generating deve
1414

1515
## Show & Tell Sections (Mandatory)
1616

17-
Each phase and user story in `tasks.md` must include a `### Show & Tell` subsection. Expand the outline from `plan.md` with specific executable steps:
17+
Each phase and user story in `tasks.md` must include a `Show & Tell` subsection. Expand the outline from `plan.md` with specific executable steps:
1818

1919
- Terminal commands to run (with expected output)
2020
- Browser URLs to navigate (if applicable)
@@ -23,6 +23,17 @@ Each phase and user story in `tasks.md` must include a `### Show & Tell` subsect
2323

2424
These steps will be executed during implementation to verify each phase is complete.
2525

26+
### GitHub Copilot Execution Requirement (Mandatory)
27+
28+
GitHub Copilot **MUST** execute every Show & Tell step during `/speckit.implement` and validate that the expected result is achieved.
29+
30+
- Do not allow placeholder or ambiguous steps
31+
- Every step must include explicit pass/fail criteria
32+
- If a step fails, update tasks and/or implementation, then re-run the step
33+
- Do not mark a phase or user story complete until all Show & Tell steps pass
34+
35+
This requirement is non-optional and must not be skipped or missed.
36+
2637
**Format example:**
2738

2839
````markdown
@@ -49,8 +60,11 @@ Before marking `tasks.md` as complete, verify:
4960
- [ ] Test tasks are listed before their corresponding implementation tasks
5061
- [ ] Each phase and user story ends with a task that runs `make lint` and `make test`
5162
- [ ] Each phase and user story includes a `### Show & Tell` subsection with executable steps
63+
- [ ] GitHub Copilot executes every Show & Tell step during implementation
64+
- [ ] Every Show & Tell step has explicit expected output/state and clear pass/fail criteria
65+
- [ ] No phase or user story is marked complete if any Show & Tell step has not passed
5266

5367
---
5468

55-
> **Version**: 1.5.1
56-
> **Last Amended**: 2026-01-21
69+
> **Version**: 1.5.2
70+
> **Last Amended**: 2026-02-20

0 commit comments

Comments
 (0)