Skip to content

Added openspec extension - #4765

Merged
mnriem merged 8 commits into
github:mainfrom
aaronrsun:aaronrsun-openspec-ext
Sep 28, 2026
Merged

mnriem merged 8 commits into
github:mainfrom
aaronrsun:aaronrsun-openspec-ext

Conversation

@aaronrsun

Copy link
Copy Markdown
Contributor

OpenSpec is a Spec Kit extension that adds structured, spec-driven change-management workflows to a project. Instead of jumping straight into code, it guides you through a lifecycle for each change:

  1. explore – investigate the codebase/problem space
  2. propose – scaffold a change with a proposal, spec delta, and design doc
  3. apply – implement the change, tracked via a generated task list
  4. verify – audit the implementation against the spec for completeness, correctness, and coherence
  5. archive – move the completed change to an archive and sync spec deltas into the canonical specs

It also offers supporting commands (new, continue, ff, update, sync, bulk-archive, onboard) and a Python helper (change.py) that handles change discovery, status tracking, scaffolding, and archival — giving teams a lightweight, file-based system for proposing, implementing, and recording changes with traceability from requirement → design → task → code.

@aaronrsun
aaronrsun requested a review from mnriem as a code owner September 27, 2026 04:52
Copilot AI balanced review requested due to automatic review settings September 27, 2026 04:52

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The release manifest version conflicts with the catalog, and the catalog timestamp and product-name casing need correction.

Review effort: Balanced
Findings: 1 High severity · 3 Low severity

Open (4)
What changed in this PR

Adds the OpenSpec community extension to the Spec Kit catalog and documentation.

Changes:

  • Registers OpenSpec v0.1.0 with metadata and capabilities.
  • Adds OpenSpec to the community extensions table.
File Description
extensions/​catalog.community.json Adds the extension catalog entry.
docs/​community/​extensions.md Documents the extension.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread extensions/catalog.community.json Outdated
Comment thread docs/community/extensions.md Outdated
Comment thread extensions/catalog.community.json Outdated
Comment thread extensions/catalog.community.json Outdated
@lilisalinas936-design

This comment was marked as spam.

@lilisalinas936-design

This comment was marked as spam.

@mnriem mnriem added the triage-can-wait Verdict: valid and in-scope but deprioritized; held behind the evidence gate label Sep 27, 2026
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings September 27, 2026 21:42

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The catalog has an unresolved release-version mismatch and omits required metadata updates and archive integrity data.

Review effort: Balanced
Findings: 1 High severity · 2 Low severity

Open (3)
Resolved since last review (3)

Comment thread extensions/catalog.community.json Outdated
Comment thread extensions/catalog.community.json Outdated
Copilot AI review requested due to automatic review settings September 27, 2026 21:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🔵 Needs a closer look

The release manifest version mismatches the catalog, and the catalog timestamp was not refreshed.

Review effort: Balanced
Findings: 1 High severity · 1 Low severity

Open (2)
Resolved since last review (1)

@lilisalinas936-design

This comment was marked as spam.

Copilot AI review requested due to automatic review settings September 27, 2026 22:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🔵 Needs a closer look

The release manifest version conflicts with the catalog, and the catalog timestamp remains stale.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
Resolved since last review (1)

Copilot AI review requested due to automatic review settings September 28, 2026 00:11

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The release manifest version mismatches the catalog, and catalog metadata requirements remain unmet.

Review effort: Balanced
Findings: 1 High severity · 1 Low severity

Open (2)
Previously missed (1)

In code that hasn't changed since last review

Low severity Extension description exceeds the 100-character limit

extensions/​catalog.community.json:3702

This 149-character description exceeds the publishing guide's under-100-character requirement (extensions/EXTENSION-PUBLISHING-GUIDE.md:84-89). Please shorten it here and make the same change in the generated community table so the two listings remain synchronized.

Comment thread extensions/catalog.community.json Outdated
Copilot AI review requested due to automatic review settings September 28, 2026 00:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The download URL is invalid, the manifest version conflicts with the catalog, and the catalog timestamp was not refreshed.

Review effort: Balanced
Findings: 2 High severity · 1 Low severity

Open (3)

Comment thread extensions/catalog.community.json Outdated
Copilot AI review requested due to automatic review settings September 28, 2026 13:28
…estamp

The openspec entry's sha256 did not match the bytes of the published
openspec-v0.1.0/openspec.zip release asset, which would cause install
integrity verification to fail. Recompute it from the tagged archive.

Also refresh the catalog's top-level updated_at to reflect this change.

Assisted-by: GitHub Copilot (model: Claude Opus 4.8, autonomous)
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@mnriem

mnriem commented Sep 28, 2026

Copy link
Copy Markdown
Collaborator

Review round: addressed remaining findings (commit fe1bfa3)

Pushed via maintainer edit access on behalf of @mnriem. Fixes and analysis were AI-generated by GitHub Copilot (model: Claude Opus 4.8), operating autonomously under maintainer direction.

Two metadata fixes in extensions/catalog.community.json:

  1. sha256 corrected — the entry's digest (21b55eff…) did not match the bytes of the published openspec-v0.1.0/openspec.zip asset. Installs would fail integrity verification. Recomputed from the exact tagged archive: 9d3b384d5a13c36547352009cc11ce059d45c5f0624b3e3311559e2e5766cdf9.
  2. Top-level updated_at refreshed to 2026-09-28 so catalog consumers see the change.

The two remaining high-severity findings are now stale — since they were filed, the author published the openspec-v0.1.0 release with the openspec.zip asset, and that archive's extension.yml declares version 0.1.0, matching the catalog:

  • Nonexistent release asset — the openspec-v0.1.0/openspec.zip asset now exists and downloads successfully.
  • Version mismatch (v0.1.0 tag manifest was 1.0.0) — the catalog points at the openspec-v0.1.0 release, whose bundled extension.yml declares 0.1.0. No mismatch remains against the referenced archive.

Verified: openspec.zip downloads cleanly, its extension.yml version is 0.1.0, the recomputed digest is stable across re-downloads, and tests/contract/test_catalog_schema.py passes (46 tests).

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🔵 Needs a closer look

The new entry’s timestamps do not match the required addition date.

Review effort: Balanced
Findings: 2 High severity

Open (2)
Resolved since last review (1)
Previously missed (1)

In code that hasn't changed since last review

Low severity New extension entry uses an outdated timestamp

extensions/​catalog.community.json:3733

For a new extension, the repository workflow requires both per-entry timestamps to use today’s UTC date (.github/workflows/add-community-extension.md:267-300). This catalog change is dated 2026-09-28 at the top level, but the new entry is dated 2026-09-26, so its metadata incorrectly predates its addition. Set both values to 2026-09-28.

Use the PR addition date for both OpenSpec catalog timestamps.

Assisted-by: GitHub Copilot (model: GPT-5.6 Sol Fast, autonomous)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings September 28, 2026 15:30
@mnriem

mnriem commented Sep 28, 2026

Copy link
Copy Markdown
Collaborator

Addressed this review round in 78590d351e389710701b4816d2211343dd365846.

Validated the published openspec-v0.1.0/openspec.zip asset: its manifest declares 0.1.0, and its SHA-256 is 9d3b384d5a13c36547352009cc11ce059d45c5f0624b3e3311559e2e5766cdf9, matching the catalog. Updated the OpenSpec entry’s created_at and updated_at to 2026-09-28T00:00:00Z; JSON parsing and metadata assertions pass.

Posted on behalf of @mnriem with GitHub Copilot using GPT-5.6 Sol Fast in autonomous mode; release-metadata validation, catalog edit, and validation.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot review overview

🟢 Approval recommended

The catalog metadata, release version, checksum, ordering, and JSON syntax were validated successfully.

Review effort: Balanced
Findings: 2 High severity

Open (2)

@mnriem
mnriem merged commit c648d96 into github:main Sep 28, 2026
15 checks passed
@mnriem

mnriem commented Sep 28, 2026

Copy link
Copy Markdown
Collaborator

Thank you! To avoid PR churn on catalog entries please use the catalog submission issue templates the next time

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

triage-can-wait Verdict: valid and in-scope but deprioritized; held behind the evidence gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants