Update openspec#871
Conversation
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Updates OpenSpec “primitives” and workflow guidance by refreshing generated metadata and tightening instructions around how the CLI returns artifact context (especially contextFiles), plus revising onboarding and command references.
Changes:
- Bump
generatedByacross OpenSpec skills to1.3.1. - Clarify
contextFilesas “artifact ID -> array of file paths” and adjust task/design reading instructions accordingly. - Update onboarding preflight and command reference docs (introduce
/opsx:propose, add Windows command notes, and add guardrails about not copying<context>/<rules>blocks).
Reviewed changes
Copilot reviewed 18 out of 18 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| openspec/AGENTS.md | Removes the OpenSpec agent instruction file content (file deleted). |
| .github/skills/openspec-verify-change/SKILL.md | Updates verify instructions to treat contextFiles as an artifact-to-paths map. |
| .github/skills/openspec-sync-specs/SKILL.md | Bumps generatedBy metadata version. |
| .github/skills/openspec-onboard/SKILL.md | Updates onboarding flow: CLI install check, command reference tables, Windows notes. |
| .github/skills/openspec-new-change/SKILL.md | Bumps generatedBy metadata version. |
| .github/skills/openspec-ff-change/SKILL.md | Bumps generatedBy metadata version. |
| .github/skills/openspec-explore/SKILL.md | Updates explore guidance to “create a proposal” and formatting tweaks. |
| .github/skills/openspec-continue-change/SKILL.md | Bumps generatedBy metadata version. |
| .github/skills/openspec-bulk-archive-change/SKILL.md | Minor wording/formatting tweaks and removes /opsx:new mention in “no changes” case. |
| .github/skills/openspec-archive-change/SKILL.md | Changes sync behavior guidance to explicitly invoke openspec-sync-specs via tooling instructions. |
| .github/skills/openspec-apply-change/SKILL.md | Clarifies contextFiles shape and instructs reading all paths. |
| .github/prompts/opsx-verify.prompt.md | Mirrors verify guidance updates around contextFiles. |
| .github/prompts/opsx-onboard.prompt.md | Mirrors onboarding updates (CLI install check, tables, Windows notes). |
| .github/prompts/opsx-ff.prompt.md | Adds guardrails about not copying <context>/<rules> blocks into artifacts. |
| .github/prompts/opsx-explore.prompt.md | Mirrors explore guidance updates to “create a proposal”. |
| .github/prompts/opsx-bulk-archive.prompt.md | Minor wording/formatting tweaks and removes /opsx:new mention in “no changes” case. |
| .github/prompts/opsx-archive.prompt.md | Mirrors archive sync behavior guidance update to invoke openspec-sync-specs. |
| .github/prompts/opsx-apply.prompt.md | Mirrors apply guidance updates around contextFiles. |
jasonleenaylor
left a comment
There was a problem hiding this comment.
@jasonleenaylor reviewed 18 files and all commit messages.
Reviewable status: all files reviewed, 6 unresolved discussions (waiting on johnml1135).
|
|
|
Addressed the |
jasonleenaylor
left a comment
There was a problem hiding this comment.
@jasonleenaylor reviewed 9 files and all commit messages, and made 1 comment.
Reviewable status:complete! all files reviewed, all discussions resolved (waiting on johnml1135).
Update OpenSpec primitives
This change is