Skip to content

Commit bca5bbd

Browse files
committed
updated ex14 workflow
1 parent 9c9dc55 commit bca5bbd

2 files changed

Lines changed: 40 additions & 20 deletions

File tree

.github/workflows/GHSpecKitGetStarted_Zip_Code_Ex14.yml

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,15 @@ jobs:
3030
# Remove existing zip file
3131
rm -f DownloadableCodeProjects/Downloads/GHSpecKitEx14StakeholderDocuments.zip
3232
33-
# Create zip containing the entire folder (including StakeholderDocuments)
34-
zip -r -q DownloadableCodeProjects/Downloads/GHSpecKitEx14StakeholderDocuments.zip \
35-
DownloadableCodeProjects/standalone-lab-projects/sdd-get-started-rss-feed
33+
# Zip only the contents of the sdd-get-started-rss-feed folder (not the parent path)
34+
cd DownloadableCodeProjects/standalone-lab-projects/sdd-get-started-rss-feed
35+
CONTENTS=$(ls -A)
36+
if [ -z "$CONTENTS" ]; then
37+
echo "No files to zip in sdd-get-started-rss-feed"
38+
exit 1
39+
fi
40+
zip -r -q ../../Downloads/GHSpecKitEx14StakeholderDocuments.zip $CONTENTS
41+
cd -
3642
3743
# Verify zip file was created
3844
if [ ! -f DownloadableCodeProjects/Downloads/GHSpecKitEx14StakeholderDocuments.zip ]; then

Instructions/Labs/LAB_AK_14_get-started-spec-driven-development.md

Lines changed: 31 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -80,8 +80,6 @@ Use the following steps to complete this task:
8080
8181
For brownfield projects, the `specify init` command recognizes that the current directory isn't empty and asks for confirmation to proceed.
8282
83-
1. Take a minute to review the information presented in the terminal window.
84-
8583
The `specify init` command completes the following actions:
8684
8785
- Creates agent prompt files in the `.github/agents/` and `.github/prompts/` directories.
@@ -92,25 +90,15 @@ Use the following steps to complete this task:
9290
- Displays a success message ("Project ready").
9391
- Suggests some optional next steps.
9492
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:
10694
10795
```powershell
10896
code .
10997
```
11098
11199
The `code .` command opens the current directory (RSSFeedReader) in Visual Studio Code.
112100
113-
Wait for Visual Studio Code to fully load the project.
101+
1. Wait for Visual Studio Code to fully load the project.
114102
115103
1. Take a minute to familiarize yourself with the project structure.
116104
@@ -126,11 +114,12 @@ Use the following steps to complete this task:
126114
│ ├── scripts/powershell/ (GitHub Spec Kit uses automation utilities (scripts) for creating features, setting up plans, and managing the specification workflow)
127115
│ └── templates/ (GitHub Spec Kit provides standardized markdown formats for specs, plans, tasks, and checklists to ensure consistent documentation across all features)
128116
└── .vscode/ (Visual Studio Code configuration)
129-
130117
```
131118
132119
1. Ensure that GitHub Copilot's Chat view is open.
133120
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+
134123
> **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.
135124
136125
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:
156145
- **Git clone errors**: Verify that you're signed in to GitHub, and that you have access to your imported repository.
157146
- **GitHub Spec Kit commands not appearing**: Ensure `.github/prompts/` exists in your workspace root. Try reloading Visual Studio Code.
158147
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:
167+
168+
- **Project Goals.md** - High-level project goals, purpose, scope, delivery approach, rollout plan, quality goals, and standards/guidelines.
169+
- **App Features.md** - Detailed user-facing feature requirements.
170+
- **Tech Stack.md** - Technology choices and architectural rationale.
171+
- **MVP System Rules.md** - MVP system behavior rules that inform specs.
172+
173+
174+
161175
162176
163177
## Generate a constitution based on standards and guidelines.

0 commit comments

Comments
 (0)