Skip to content

Commit 8b2102d

Browse files
committed
Clarify terminology in lab instructions and improve consistency in references to specifications
1 parent aa75ae6 commit 8b2102d

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

Instructions/Labs/LAB_AK_13_implement-spec-driven-development.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ This exercise includes the following tasks:
3636
1. Create the feature specification using stakeholder requirements and the constitution.
3737
1. Update the specification with clarified requirements.
3838
1. Generate the technical plan using the specification and constitution.
39-
1. Generate the tasks file using the spec, plan, and constitution.
39+
1. Generate the tasks file using the specification, plan, and constitution.
4040
1. Implement the tasks required for an MVP application.
4141

4242
## Import the ContosoDashboard repository and initialize GitHub Spec Kit
@@ -149,7 +149,7 @@ Use the following steps to complete this task:
149149
150150
## Review the ContosoDashboard project and GitHub Spec Kit files
151151
152-
GitHub Spec Kit works with GitHub Copilot through Visual Studio Code's chat interface. When you run `specify init --ai copilot` in your project directory, the toolkit configures your workspace to recognize `/speckit.*` commands.
152+
GitHub Spec Kit works with GitHub Copilot through Visual Studio Code's chat interface. When you run "specify init --ai copilot" in your project directory, the toolkit configures your workspace to recognize "/speckit.*" commands.
153153
154154
In this task, you explore the ContosoDashboard project files in Visual Studio Code, verify that GitHub Spec Kit is properly initialized, and then *push* the updated files to your GitHub repository.
155155
@@ -211,7 +211,7 @@ Use the following steps to complete this task:
211211
- `/speckit.tasks` - Break down work into actionable tasks.
212212
- `/speckit.taskstoissues` - Convert the tasks in tasks.md into GitHub issues.
213213
214-
> **Note**: If the `/speckit` commands don't appear, try closing and then reopening the project in Visual Studio Code.
214+
> **Note**: If the '/speckit.' commands don't appear, try closing and then reopening the project in Visual Studio Code.
215215
216216
**Troubleshooting**: If you encounter issues:
217217
@@ -614,7 +614,7 @@ Use the following steps to complete this task:
614614
615615
The technical plan now serves as a blueprint for implementation. It translates business requirements into concrete technical decisions while respecting organizational constraints.
616616
617-
## Generate the tasks file using the spec, plan, and constitution
617+
## Generate the tasks file using the specification, plan, and constitution
618618
619619
The tasks.md file breaks down the technical plan into specific, actionable implementation steps. Each task should be small enough to complete in a reasonable timeframe (typically a few hours to a day when implemented without AI assistance) and have clear acceptance criteria.
620620
@@ -803,9 +803,9 @@ Use the following steps to complete this task:
803803
804804
Key Observations:
805805
806-
- GitHub Copilot generates code that aligns with your spec because it references the `spec.md`, `plan.md`, and `tasks.md` files in your workspace.
806+
- GitHub Copilot generates code that aligns with your spec because it references the *spec.md*, *plan.md*, and *tasks.md* files in your workspace.
807807
- Detailed comments based on specification requirements guide GitHub Copilot to produce accurate implementations.
808-
- The spec-driven approach ensures you don't forget requirements (file size limits, supported types, etc.) because they're explicitly documented.
808+
- The spec-driven development approach ensures you don't forget requirements (file size limits, supported types, etc.) because they're explicitly documented.
809809
- Having clear acceptance criteria makes it easy to verify that your implementation meets requirements.
810810
811811
In a full implementation, you would continue through all remaining tasks in the tasks.md file, using a phased approach to systematically build out the complete feature. The spec-driven development approach keeps you focused on requirements and prevents scope creep or missed functionality.

0 commit comments

Comments
 (0)