You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Instructions/Labs/LAB_AK_14_get-started-spec-driven-development.md
+31-17Lines changed: 31 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -80,8 +80,6 @@ Use the following steps to complete this task:
80
80
81
81
For brownfield projects, the `specify init` command recognizes that the current directory isn't empty and asks for confirmation to proceed.
82
82
83
-
1. Take a minute to review the information presented in the terminal window.
84
-
85
83
The `specify init` command completes the following actions:
86
84
87
85
- Creates agent prompt files in the `.github/agents/` and `.github/prompts/` directories.
@@ -92,25 +90,15 @@ Use the following steps to complete this task:
92
90
- Displays a success message ("Project ready").
93
91
- Suggests some optional next steps.
94
92
95
-
## Review the project files and prepare stakeholder documents
96
-
97
-
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.
98
-
99
-
In this task, you verify that GitHub Spec Kit is properly initialized, review the RSSFeedReader documents provided by the Contoso stakeholders, and then add the stakeholder documents to a project folder.
100
-
101
-
Use the following steps to complete this task:
102
-
103
-
1. Open the RSSFeedReader project in Visual Studio Code.
104
-
105
-
For example, if the terminal window is still open, you can use the following command to open the project:
93
+
1. To open the RSSFeedReader project in Visual Studio Code, enter the following command:
106
94
107
95
```powershell
108
96
code .
109
97
```
110
98
111
99
The `code .` command opens the current directory (RSSFeedReader) in Visual Studio Code.
112
100
113
-
Wait for Visual Studio Code to fully load the project.
101
+
1. Wait for Visual Studio Code to fully load the project.
114
102
115
103
1. Take a minute to familiarize yourself with the project structure.
116
104
@@ -126,11 +114,12 @@ Use the following steps to complete this task:
126
114
│ ├── scripts/powershell/ (GitHub Spec Kit uses automation utilities (scripts) for creating features, setting up plans, and managing the specification workflow)
127
115
│ └── templates/ (GitHub Spec Kit provides standardized markdown formats for specs, plans, tasks, and checklists to ensure consistent documentation across all features)
128
116
└── .vscode/ (Visual Studio Code configuration)
129
-
130
117
```
131
118
132
119
1. Ensure that GitHub Copilot's Chat view is open.
133
120
121
+
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.
122
+
134
123
> **NOTE:** This lab exercise was tested using the GPT-5.2 and Claude Sonnet 4.5 models. Results were similar between these two models. However, using GPT-4 and GPT-5 mini models produced inconsistent and unexpected results. We suggest using newer language models that are optimized for complex reasoning when running GitHub Spec Kit commands.
135
124
136
125
1. In the Chat view, to verify that GitHub Spec Kit commands are available, type **/speckit**
@@ -156,8 +145,33 @@ Use the following steps to complete this task:
156
145
- **Git clone errors**: Verify that you're signed in to GitHub, and that you have access to your imported repository.
157
146
- **GitHub Spec Kit commands not appearing**: Ensure `.github/prompts/` exists in your workspace root. Try reloading Visual Studio Code.
158
147
159
-
1. In Visual Studio Code's EXPLORER view, create a new folder named **StakeholderDocs** in the root of the RSSFeedReader project.
160
-
1.
148
+
## Download and review the stakeholder documents
149
+
150
+
In this task, you download the RSSFeedReader documents provided by the Contoso stakeholders, add them to your project, and then evaluate how the documents relate to GitHub Spec Kit commands.
151
+
152
+
Use the following steps to complete this task:
153
+
154
+
1. To download the stakeholder documents, open the following link in a browser: [RSSFeedReader - stakeholder documents](https://github.com/MicrosoftLearning/mslearn-github-copilot-dev/raw/refs/heads/main/DownloadableCodeProjects/Downloads/GHSpecKitEx14StakeholderDocuments.zip).
155
+
156
+
1. Open the folder containing the downloaded ZIP file.
157
+
158
+
1. Extract the contents of the downloaded ZIP file to a temporary folder.
159
+
160
+
1. In Visual Studio Code's EXPLORER view, right-click the RSSFeedReader project root folder, and then select **Reveal in File Explorer** (or **Reveal in Finder** on macOS).
161
+
162
+
1. In File Explorer (or Finder), open the temporary folder where you extracted the ZIP file.
163
+
164
+
1. Select all files in the temporary folder, copy them, and then paste them into the RSSFeedReader project root folder.
165
+
166
+
The stakeholder documents include the following files:
0 commit comments