Skip to content

Add CI Guard extension to community catalog#2157

Merged
mnriem merged 3 commits intogithub:mainfrom
Quratulain-bilal:feat/ci-guard-extension
Apr 10, 2026
Merged

Add CI Guard extension to community catalog#2157
mnriem merged 3 commits intogithub:mainfrom
Quratulain-bilal:feat/ci-guard-extension

Conversation

@Quratulain-bilal
Copy link
Copy Markdown
Contributor

Summary

Adds CI Guard — spec compliance gates for CI/CD pipelines that verify specs exist, check drift,
enforce task completion, and block merges when requirements have gaps.

Extension repo: https://github.com/Quratulain-bilal/spec-kit-ci-guard

The Problem

Spec Kit generates great artifacts (spec.md, plan.md, tasks.md) — but nothing enforces them. Teams
write detailed specs, then merge code that ignores half the requirements. Without enforcement, SDD
becomes documentation theater.

What CI Guard Does

5 commands that bridge SDD workflow → CI/CD enforcement:

Command Purpose
/speckit.ci.check Run all spec compliance checks with pass/fail status
/speckit.ci.report Generate requirement traceability matrix with coverage metrics
/speckit.ci.gate Configure merge gate rules — strict/moderate/relaxed profiles
/speckit.ci.drift Detect bidirectional spec-to-code drift with severity ratings
/speckit.ci.badge Generate spec compliance badges for README display

2 hooks: before_implement (pre-check), after_implement (drift detection)

Why This Matters

Completes the SDD enforcement loop:
specify → plan → tasks → implement → CI Guard ✅

  • Prevents merging code that doesn't match spec requirements
  • Gives reviewers quantitative compliance scores
  • Detects drift in both directions (spec→code AND code→spec)
  • Three gate profiles for different team needs (strict/moderate/relaxed)
  • All check commands are read-only — safe for any pipeline

Checklist

  • Extension repo published with v1.0.0 tag
  • extension.yml follows schema v1.0
  • Description under 100 characters (91)
  • Catalog entry alphabetically ordered (between canon and checkpoint)
  • README row alphabetically ordered (between Canon and Checkpoint Extension)
  • updated_at bumped
  • JSON validated
  • All 5 command files match extension.yml references
  • README, CHANGELOG, LICENSE included

Adds spec-kit-ci-guard: spec compliance gates for CI/CD pipelines.

5 commands:
- /speckit.ci.check — run all compliance checks with pass/fail
- /speckit.ci.report — generate requirement traceability matrix
- /speckit.ci.gate — configure merge gate rules and thresholds
- /speckit.ci.drift — detect bidirectional spec-to-code drift
- /speckit.ci.badge — generate spec compliance badges

2 hooks: before_implement, after_implement

Bridges the gap between SDD workflow and CI/CD enforcement.
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 CI Guard community extension to Spec Kit’s discovery surfaces (community catalog + README list) so users can find it via the community catalog and documentation.

Changes:

  • Add a new ci-guard entry to extensions/catalog.community.json (metadata, download URL, tags, requirements).
  • Add CI Guard to the Community Extensions table in README.md.
  • Update the community catalog’s top-level updated_at.
Show a summary per file
File Description
README.md Adds CI Guard to the documented list of community extensions.
extensions/catalog.community.json Registers CI Guard in the community extension catalog and updates catalog metadata.

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: 1

Set to 2026-04-10T15:00:00Z (later than previous 2026-04-10T12:34:56Z).
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 CI Guard community extension to Spec Kit’s community extension listings, making it discoverable via the main README and the catalog.community.json consumed by extension tooling.

Changes:

  • Added a new CI Guard entry to the Community Extensions table in README.md.
  • Added a new ci-guard extension record (v1.0.0) to extensions/catalog.community.json and bumped the catalog updated_at.
Show a summary per file
File Description
README.md Adds CI Guard to the community extensions table with category/effect and repository link.
extensions/catalog.community.json Registers the ci-guard extension metadata (version, URLs, requirements, tags) and updates catalog freshness timestamp.

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

Keep monotonically increasing: 2026-04-10T17:00:00Z.
Fix ci-guard created_at/updated_at to current timestamp per publishing guide.
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 CI Guard community extension to Spec Kit’s community extension catalog and surfaces it in the root README’s community extensions table.

Changes:

  • Added a new ci-guard entry to extensions/catalog.community.json (including metadata, version, URLs, tags, and timestamps).
  • Bumped the community catalog’s top-level updated_at.
  • Added CI Guard to the README’s Community Extensions table in alphabetical order.
Show a summary per file
File Description
README.md Adds CI Guard as a new row in the Community Extensions table.
extensions/catalog.community.json Adds the ci-guard catalog entry and updates the catalog’s updated_at.

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

@mnriem mnriem merged commit 97ea7cf into github:main Apr 10, 2026
12 checks passed
@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented Apr 10, 2026

Thank you!

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