Uh oh!
There was an error while loading. Please reload this page.
Add Copilot instructions for writing specifications - #6205
Merged
Demitrius Nelon (denelon) merged 2 commits intoMay 4, 2026
Merged
Conversation
Add specs.instructions.md with guidance for specification document structure, front matter, deprecation paths, cross-repository schema impact, settings/arguments, and CLI argument tables. Update copilot-instructions.md to reference the new scoped instruction file for the doc/specs/ directory. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Kaleb Luedtke (Trenly)
approved these changes
May 4, 2026
Demitrius Nelon (denelon)
marked this pull request as ready for review
May 4, 2026 03:36
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
- Remove redundant scope line (frontmatter covers it) - Update schema version example to 1.28.0 → 1.29.0 - Add winget-create to cross-repository impact section - Add --no-vt interactivity mode documentation - Change 'new words' to 'uncommon words' for spelling section Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
JohnMcPMS
approved these changes
May 4, 2026
Kaleb Luedtke (Trenly)
approved these changes
May 4, 2026
Flor Chacón (florelis)
approved these changes
May 4, 2026
| - Client behavior (CLI commands affected and how they behave) | ||
| - COM API surface changes (IDL definitions) | ||
| - PowerShell cmdlet changes (affected cmdlets, interactive vs. pipeline behavior, output objects) | ||
| - Settings changes (new or modified settings with JSON examples and interaction tables) |
There was a problem hiding this comment.
What about group policies?
CollaboratorAuthor
There was a problem hiding this comment.
I suspect most specs wouldn't have them.
CollaboratorAuthor
There was a problem hiding this comment.
I added a TODO with my robot
| - **Interactive** (default) — Prompts are shown and user input is accepted. | ||
| - **`--no-vt`** — I/O stream is available but VT (virtual terminal) escape sequences are not processed. This is a layer between fully interactive and non-interactive — specs should consider whether features need special handling when VT is unavailable. | ||
| - **`--disable-interactivity`** — No prompts; operations proceed automatically. | ||
| - **`--silent`** — Implies non-interactive. |
There was a problem hiding this comment.
Isn't this one about the installer, not about winget?
| When proposing a replacement for an existing field or feature: | ||
| - Define a phased deprecation path (Introduction → Transition → Deprecation → Removal). | ||
| - Make timelines conditional on adoption telemetry, not fixed dates. |
There was a problem hiding this comment.
The timeline should also depend on the version of winget that ships out of the box with Windows.
CollaboratorAuthor
There was a problem hiding this comment.
Good call out. Another TODO
Uh oh!
There was an error while loading. Please reload this page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📖 Description
Adds
.github/instructions/specs.instructions.mdfor specification authoring guidance and updates.github/copilot-instructions.mdto reference it. This was split from #6201 to keep the specification content separate from tooling guidance.Created with GitHub Copilot assistance.
🔗 References
Resolves#6204
🔍 Validation
✅ Checklist
📋 Issue Type