Add Copilot instructions for writing specifications#6205
Merged
denelon merged 2 commits intomicrosoft:masterfrom May 4, 2026
Merged
Add Copilot instructions for writing specifications#6205denelon merged 2 commits intomicrosoft:masterfrom
denelon merged 2 commits intomicrosoft:masterfrom
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>
Trenly
approved these changes
May 4, 2026
Trenly
reviewed
May 4, 2026
- 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
Trenly
approved these changes
May 4, 2026
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) |
Collaborator
Author
There was a problem hiding this comment.
I suspect most specs wouldn't have them.
Collaborator
Author
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. |
Member
There was a problem hiding this comment.
Isn't this one about the installer, not about winget?
florelis
reviewed
May 4, 2026
| 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. |
Member
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.
Collaborator
Author
There was a problem hiding this comment.
Good call out. Another TODO
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 free
to 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