Skip to content

Add changelog extension#2177

Open
Quratulain-bilal wants to merge 9 commits intogithub:mainfrom
Quratulain-bilal:add-changelog-extension
Open

Add changelog extension#2177
Quratulain-bilal wants to merge 9 commits intogithub:mainfrom
Quratulain-bilal:add-changelog-extension

Conversation

@Quratulain-bilal
Copy link
Copy Markdown
Contributor

Adds the Spec Changelog extension to the community catalog and README.

What it does

Auto-generates changelogs, release notes, human-readable diffs, and stakeholder notifications from spec
git history — turning silent spec evolution into visible, documented change communication.

Commands

Command Purpose
/speckit.changelog.generate Full changelog from spec history
/speckit.changelog.release Release notes for a specific version
/speckit.changelog.diff Human-readable diff between spec versions
/speckit.changelog.notify Stakeholder notifications from changes

Changes

  • Added changelog entry to catalog.community.json (alphabetically between canon and ci-guard)
  • Added Spec Changelog row to README extensions table (alphabetically between Ship Release and Spec Critique)
  • Bumped catalog updated_at

Adds spec-kit-scope: effort estimation and scope tracking from spec artifacts.

4 commands:
- /speckit.scope.estimate — data-driven effort estimation with three-point ranges
- /speckit.scope.compare — side-by-side spec scope comparison
- /speckit.scope.creep — scope creep detection via git history
- /speckit.scope.budget — sprint-ready time budget generation

1 hook: after_specify (auto-estimation)

Turns "how long will this take?" into a data-driven answer.
@mnriem mnriem self-assigned this Apr 13, 2026
@Quratulain-bilal Quratulain-bilal force-pushed the add-changelog-extension branch 2 times, most recently from be2c9c4 to 297967b Compare April 17, 2026 16:48
@mnriem mnriem requested a review from Copilot April 17, 2026 17:59
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

Adds the Spec Changelog community extension to the project’s extension catalog and surfaces it in the README so users can discover and install it.

Changes:

  • Added a new changelog extension entry to extensions/catalog.community.json
  • Added a corresponding “Spec Changelog” row to the README community extensions table
  • Updated the catalog-level updated_at timestamp
Show a summary per file
File Description
extensions/catalog.community.json Registers the new “Spec Changelog” extension with metadata, URLs, requirements, and tags.
README.md Adds the “Spec Changelog” entry to the community extensions list for discoverability.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 2/2 changed files
  • Comments generated: 0

@Quratulain-bilal Quratulain-bilal force-pushed the add-changelog-extension branch 2 times, most recently from 296bad7 to 5e9148e Compare April 23, 2026 02:47
@mnriem mnriem requested a review from Copilot April 23, 2026 12:20
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.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 2/2 changed files
  • Comments generated: 0 new

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.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 2/2 changed files
  • Comments generated: 0 new

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.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 2/2 changed files
  • Comments generated: 0 new

Copy link
Copy Markdown
Collaborator

@mnriem mnriem left a comment

Choose a reason for hiding this comment

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

Please address Copilot feedback

@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 6, 2026

Whoops I meant please resolve conflicts ;)

# Conflicts:
#	README.md
#	extensions/catalog.community.json
…in-bilal/spec-kit into add-changelog-extension

# Conflicts:
#	README.md
#	extensions/catalog.community.json
@Quratulain-bilal
Copy link
Copy Markdown
Contributor Author

Resolved merge conflicts with main (commit 236086a).

Conflicts resolved:

  • extensions/catalog.community.json:
    • Bumped top-level updated_at to 2026-05-07T00:00:00Z.
    • Kept both the catalog-ci entry (already on main) and my changelog entry — they sit in alphabetical order (catalog-ci < changelog < ci-guard).
    • Preserved my created_at / updated_at (2026-04-11T18:00:00Z) on the changelog entry.
  • README.md: removed a duplicate Spec Reference Loader row that the merge introduced; the row already exists at its correct alphabetical position.

Verification:

  • python -m json.tool extensions/catalog.community.json exits 0.
  • No remaining conflict markers in either file.

Ready for re-review.

@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 7, 2026

@copilot resolve the merge conflicts in this pull request

@mnriem mnriem requested review from Copilot and mnriem May 7, 2026 15:57
mnriem
mnriem previously approved these changes May 7, 2026
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.

Copilot's findings

  • Files reviewed: 2/2 changed files
  • Comments generated: 1

Comment thread extensions/catalog.community.json Outdated
Comment on lines +2223 to +2255
"scope": {
"name": "Spec Scope",
"id": "scope",
"description": "Effort estimation and scope tracking — estimate work, detect creep, and budget time per phase.",
"author": "Quratulain-bilal",
"version": "1.0.0",
"download_url": "https://github.com/Quratulain-bilal/spec-kit-scope-/archive/refs/tags/v1.0.0.zip",
"repository": "https://github.com/Quratulain-bilal/spec-kit-scope-",
"homepage": "https://github.com/Quratulain-bilal/spec-kit-scope-",
"documentation": "https://github.com/Quratulain-bilal/spec-kit-scope-/blob/main/README.md",
"changelog": "https://github.com/Quratulain-bilal/spec-kit-scope-/blob/main/CHANGELOG.md",
"license": "MIT",
"requires": {
"speckit_version": ">=0.4.0"
},
"provides": {
"commands": 4,
"hooks": 1
},
"tags": [
"estimation",
"scope",
"effort",
"planning",
"project-management",
"tracking"
],
"verified": false,
"downloads": 0,
"stars": 0,
"created_at": "2026-04-11T10:00:00Z",
"updated_at": "2026-04-11T10:00:00Z"
},
@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 7, 2026

@copilot apply changes based on the comments in this thread

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.

Copilot's findings

  • Files reviewed: 2/2 changed files
  • Comments generated: 2

Comment thread extensions/catalog.community.json Outdated
Comment on lines +2223 to +2255
"scope": {
"name": "Spec Scope",
"id": "scope",
"description": "Effort estimation and scope tracking — estimate work, detect creep, and budget time per phase.",
"author": "Quratulain-bilal",
"version": "1.0.0",
"download_url": "https://github.com/Quratulain-bilal/spec-kit-scope-/archive/refs/tags/v1.0.0.zip",
"repository": "https://github.com/Quratulain-bilal/spec-kit-scope-",
"homepage": "https://github.com/Quratulain-bilal/spec-kit-scope-",
"documentation": "https://github.com/Quratulain-bilal/spec-kit-scope-/blob/main/README.md",
"changelog": "https://github.com/Quratulain-bilal/spec-kit-scope-/blob/main/CHANGELOG.md",
"license": "MIT",
"requires": {
"speckit_version": ">=0.4.0"
},
"provides": {
"commands": 4,
"hooks": 1
},
"tags": [
"estimation",
"scope",
"effort",
"planning",
"project-management",
"tracking"
],
"verified": false,
"downloads": 0,
"stars": 0,
"created_at": "2026-04-11T10:00:00Z",
"updated_at": "2026-04-11T10:00:00Z"
},
Comment thread extensions/catalog.community.json Outdated
Comment on lines +2223 to +2226
"scope": {
"name": "Spec Scope",
"id": "scope",
"description": "Effort estimation and scope tracking — estimate work, detect creep, and budget time per phase.",
@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 7, 2026

Please address Copilot feedback

…tor README row, return Spec Reference Loader to original position

Per Copilot review on PR github#2177: this branch is supposed to add only the
Spec Changelog extension. The diff against main also showed (1) a duplicate
'scope' catalog entry, (2) a deletion of the Intelligent Agent Orchestrator
README row, and (3) Spec Reference Loader moved out of alphabetical order.
All three were merge artifacts and have been cleaned up here.
# Conflicts:
#	extensions/catalog.community.json
…in-bilal/spec-kit into add-changelog-extension

# Conflicts:
#	extensions/catalog.community.json
@Quratulain-bilal
Copy link
Copy Markdown
Contributor Author

Quratulain-bilal commented May 8, 2026

Thanks . that was accidental. The duplicate scope extension entry has been removed from extensions/catalog.community.json, and two README artifacts left behind by an earlier merge were also cleaned up: the Intelligent Agent Orchestrator row was restored and Spec Reference Loader was returned to its alphabetical position. The PR diff now matches the description: only the Spec Changelog catalog entry, the Spec Changelog README row, and the catalog timestamp bump. Pushed in 303f9f3.

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