Skip to content

Update openspec#871

Merged
johnml1135 merged 2 commits into
mainfrom
openspec_update
May 12, 2026
Merged

Update openspec#871
johnml1135 merged 2 commits into
mainfrom
openspec_update

Conversation

@johnml1135
Copy link
Copy Markdown
Contributor

@johnml1135 johnml1135 commented May 6, 2026

Update OpenSpec primitives


This change is Reviewable

Copilot AI review requested due to automatic review settings May 6, 2026 20:05
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 generatedBy across OpenSpec skills to 1.3.1.
  • Clarify contextFiles as “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.

Comment thread .github/skills/openspec-onboard/SKILL.md Outdated
Comment thread .github/prompts/opsx-onboard.prompt.md Outdated
Comment thread .github/skills/openspec-verify-change/SKILL.md
Comment thread .github/prompts/opsx-verify.prompt.md
Comment thread .github/skills/openspec-archive-change/SKILL.md Outdated
Comment thread .github/prompts/opsx-archive.prompt.md
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 6, 2026

NUnit Tests

    1 files  ± 0      1 suites  ±0   11m 4s ⏱️ + 4m 39s
4 187 tests +85  4 116 ✅ +85  71 💤 ±0  0 ❌ ±0 
4 196 runs  +85  4 125 ✅ +85  71 💤 ±0  0 ❌ ±0 

Results for commit 1f75e10. ± Comparison against base commit db39df6.

♻️ This comment has been updated with latest results.

Comment thread .github/skills/openspec-verify-change/SKILL.md
Copy link
Copy Markdown
Contributor

@jasonleenaylor jasonleenaylor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasonleenaylor reviewed 18 files and all commit messages.
Reviewable status: all files reviewed, 6 unresolved discussions (waiting on johnml1135).

@jasonleenaylor
Copy link
Copy Markdown
Contributor

openspec/AGENTS.md line 0 at r1 (raw file):
So this doesn't seem helpful anymore? I can see that, but Devin told me that we actually reference this file in other agents files in the repository.

@johnml1135
Copy link
Copy Markdown
Contributor Author

Addressed the openspec/AGENTS.md concern in 1f75e10. I restored the file because the repo still references it from the root agent/docs surfaces, and updated it so it works as the cross-agent OpenSpec entry point for both GitHub Copilot /opsx:* commands and non-Copilot agents via the CLI workflow.

Copy link
Copy Markdown
Contributor

@jasonleenaylor jasonleenaylor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:lgtm:

@jasonleenaylor reviewed 9 files and all commit messages, and made 1 comment.
Reviewable status: :shipit: complete! all files reviewed, all discussions resolved (waiting on johnml1135).

@johnml1135 johnml1135 merged commit 4162a17 into main May 12, 2026
8 checks passed
@johnml1135 johnml1135 deleted the openspec_update branch May 12, 2026 19:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants