Skip to content

feat: Add DocGuard CDD enforcement extension to community catalog#1838

Merged
mnriem merged 5 commits intogithub:mainfrom
raccioly:add-docguard-extension
Mar 13, 2026
Merged

feat: Add DocGuard CDD enforcement extension to community catalog#1838
mnriem merged 5 commits intogithub:mainfrom
raccioly:add-docguard-extension

Conversation

@raccioly
Copy link
Contributor

@raccioly raccioly commented Mar 13, 2026

New Extension: DocGuard

DocGuard is a Canonical-Driven Development (CDD) enforcement tool that generates, validates, scores, and traces project documentation.

What It Does

Command Description
guard 51-check validation with quality labels ([HIGH]/[MEDIUM]/[LOW])
diagnose AI-ready fix prompts + multi-perspective debate mode
score CDD maturity scoring (0-100) with multi-signal breakdown
trace ISO 29119 traceability matrix (doc ↔ source ↔ tests)
generate Reverse-engineer canonical docs from codebase
init Initialize CDD with compliance profiles (starter/standard/enterprise)

Key Features

  • Zero dependencies — Pure Node.js built-ins only
  • Config-aware — Respects .docguard.json for per-project customization
  • Orphan detection — Warns about docs that exist but are excluded from config
  • Research-backed — Features inspired by AITPG/TRACE (IEEE TSE/TMLCN 2026)

Submission Checklist

  • ✅ Valid extension.yml manifest (source)
  • ✅ Complete README (source)
  • ✅ LICENSE file included (MIT)
  • ✅ GitHub release created (v0.7.3)
  • ✅ Extension tested on real projects
  • ✅ All commands working as documented
  • ✅ Published on npm: docguard-cli

Links

feat: add DocGuard CDD enforcement extension to community catalog
f6fc01f 
DocGuard is a Canonical-Driven Development enforcement tool that generates,
validates, scores, and traces project documentation against 51 automated checks.

Provides 6 commands:
- guard: 51-check validation with quality labels
- diagnose: AI-ready fix prompts
- score: CDD maturity scoring (0-100)
- trace: ISO 29119 traceability matrix
- generate: Reverse-engineer docs from codebase
- init: Initialize CDD with compliance profiles

Features:
- Zero dependencies (pure Node.js)
- Config-aware traceability (respects .docguard.json)
- Orphan file detection
- Research-backed (AITPG/TRACE, IEEE TSE/TMLCN 2026)

npm: https://www.npmjs.com/package/docguard-cli
GitHub: https://github.com/raccioly/docguard
@raccioly raccioly requested a review from mnriem as a code owner March 13, 2026 19:03
Copilot AI review requested due to automatic review settings March 13, 2026 19:03
Copilot AI reviewed Mar 13, 2026
View reviewed changes
Copy link
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 DocGuard extension metadata to the community extension catalog so it can be discovered (and ideally installed) via Spec Kit’s extension tooling.

Changes:

  • Added a new docguard entry in extensions/catalog.community.json with version, URLs, requirements, and tags.

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

You can also share your feedback on Copilot code review. Take the survey.

@raccioly
fix: use release asset URL for download_url
0489324 
The source archive URL nests files under a subdirectory, so the
Spec Kit installer cannot find extension.yml at the archive root.
Switch to a release asset ZIP built from the extension directory.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 13, 2026 19:24
Copilot AI reviewed Mar 13, 2026
View reviewed changes
Copy link
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 DocGuard extension metadata to the community extension catalog so it can be discovered via Spec Kit’s extension catalog tooling and referenced by users/orgs when curating their own installable catalogs.

Changes:

  • Add a new docguard entry to extensions/catalog.community.json with version, URLs, requirements, and tags.

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

You can also share your feedback on Copilot code review. Take the survey.

@mnriem mnriem requested a review from Copilot March 13, 2026 21:41
Copilot AI reviewed Mar 13, 2026
View reviewed changes
Copy link
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 DocGuard community extension entry so it can be discovered via the community catalog and listed in the extensions README.

Changes:

  • Added a docguard entry to extensions/catalog.community.json with metadata (download URL, requirements, tags, timestamps).
  • Added DocGuard to the community extensions table in extensions/README.md.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
extensions/catalog.community.json Registers the DocGuard extension in the community catalog for discovery/installation metadata.
extensions/README.md Lists DocGuard in the community extensions table for human-readable discovery.

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

Copilot AI review requested due to automatic review settings March 13, 2026 21:45
@raccioly raccioly force-pushed the add-docguard-extension branch from b29b04b to e7f58cc Compare March 13, 2026 21:45
Copilot AI reviewed Mar 13, 2026
View reviewed changes
Copy link
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 DocGuard community extension entry so it can be discovered via the community catalog and listed in the extensions README.

Changes:

  • Added a new docguard entry to extensions/catalog.community.json with metadata (version, URLs, requirements, tags).
  • Added DocGuard to the community extensions table in extensions/README.md (kept in alphabetical order).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
extensions/catalog.community.json Registers the DocGuard extension metadata in the community catalog for discovery.
extensions/README.md Lists DocGuard in the community extensions table for documentation/discovery.

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

You can also share your feedback on Copilot code review. Take the survey.

@mnriem mnriem requested a review from Copilot March 13, 2026 22:03
Copilot AI reviewed Mar 13, 2026
View reviewed changes
Copy link
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 DocGuard extension to Spec Kit’s community extension catalog so it can be discovered (and referenced) alongside other community extensions.

Changes:

  • Added a new docguard entry to extensions/catalog.community.json (metadata, requirements, links).
  • Added DocGuard to the community extensions table in extensions/README.md.
  • Reformatted some existing catalog tags arrays into multi-line JSON formatting.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
extensions/catalog.community.json Registers DocGuard in the community catalog with version, download URL, requirements, and tags.
extensions/README.md Adds DocGuard to the public-facing list of community extensions.

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

@mnriem mnriem merged commit 4a32344 into github:main Mar 13, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@mnriem mnriem mnriem approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@raccioly @mnriem