Skip to content

πŸ’« Toolkit to help you get started with SDD or any other process!

Add Understanding extension to community catalog (#1778)

LADISLAV BIHARI3033834d64e3
diff --git a/extensions/README.md b/extensions/README.md
index 4e506347b..e8f1617e9 100644
--- a/extensions/README.md
+++ b/extensions/README.md
@@ -80,6 +80,7 @@ The following community-contributed extensions are available in [`catalog.commun
| Retrospective Extension | Post-implementation retrospective with spec adherence scoring, drift analysis, and human-gated spec updates | [spec-kit-retrospective](https://github.com/emi-dm/spec-kit-retrospective) |
| Review Extension | Post-implementation comprehensive code review with specialized agents for code quality, comments, tests, error handling, type design, and simplification | [spec-kit-review](https://github.com/ismaelJimenez/spec-kit-review) |
| Spec Sync | Detect and resolve drift between specs and implementation. AI-assisted resolution with human approval | [spec-kit-sync](https://github.com/bgervin/spec-kit-sync) |
+| Understanding | Automated requirements quality analysis β€” 31 deterministic metrics against IEEE/ISO standards with experimental energy-based ambiguity detection | [understanding](https://github.com/Testimonial/understanding) |
| V-Model Extension Pack | Enforces V-Model paired generation of development specs and test specs with full traceability | [spec-kit-v-model](https://github.com/leocamello/spec-kit-v-model) |
| Verify Extension | Post-implementation quality gate that validates implemented code against specification artifacts | [spec-kit-verify](https://github.com/ismaelJimenez/spec-kit-verify) |
diff --git a/extensions/catalog.community.json b/extensions/catalog.community.json
index ecd7cba85..759bd10d8 100644
--- a/extensions/catalog.community.json
+++ b/extensions/catalog.community.json
@@ -29,7 +29,13 @@
"commands": 1,
"hooks": 1
},
- "tags": ["azure", "devops", "project-management", "work-items", "issue-tracking"],
+ "tags": [
+ "azure",
+ "devops",
+ "project-management",
+ "work-items",
+ "issue-tracking"
+ ],
"verified": false,
"downloads": 0,
"stars": 0,
@@ -55,7 +61,13 @@
"commands": 1,
"hooks": 1
},
- "tags": ["quality", "tech-debt", "review", "cleanup", "scout-rule"],
+ "tags": [
+ "quality",
+ "tech-debt",
+ "review",
+ "cleanup",
+ "scout-rule"
+ ],
"verified": false,
"downloads": 0,
"stars": 0,
@@ -107,7 +119,12 @@
"commands": 3,
"hooks": 1
},
- "tags": ["issue-tracking", "jira", "atlassian", "project-management"],
+ "tags": [
+ "issue-tracking",
+ "jira",
+ "atlassian",
+ "project-management"
+ ],
"verified": false,
"downloads": 0,
"stars": 0,
@@ -169,7 +186,13 @@
"commands": 1,
"hooks": 1
},
- "tags": ["retrospective", "spec-drift", "quality", "analysis", "governance"],
+ "tags": [
+ "retrospective",
+ "spec-drift",
+ "quality",
+ "analysis",
+ "governance"
+ ],
"verified": false,
"downloads": 0,
"stars": 0,
@@ -221,13 +244,60 @@
"commands": 5,
"hooks": 1
},
- "tags": ["sync", "drift", "validation", "bidirectional", "backfill"],
+ "tags": [
+ "sync",
+ "drift",
+ "validation",
+ "bidirectional",
+ "backfill"
+ ],
"verified": false,
"downloads": 0,
"stars": 0,
"created_at": "2026-03-02T00:00:00Z",
"updated_at": "2026-03-02T00:00:00Z"
},
+ "understanding": {
+ "name": "Understanding",
+ "id": "understanding",
+ "description": "Automated requirements quality analysis β€” validates specs against IEEE/ISO standards using 31 deterministic metrics. Catches ambiguity, missing testability, and structural issues before they reach implementation. Includes experimental energy-based ambiguity detection using local LM token perplexity.",
+ "author": "Ladislav Bihari",
+ "version": "3.4.0",
+ "download_url": "https://github.com/Testimonial/understanding/archive/refs/tags/v3.4.0.zip",
+ "repository": "https://github.com/Testimonial/understanding",
+ "homepage": "https://github.com/Testimonial/understanding",
+ "documentation": "https://github.com/Testimonial/understanding/blob/main/extension/README.md",
+ "changelog": "https://github.com/Testimonial/understanding/blob/main/extension/CHANGELOG.md",
+ "license": "MIT",
+ "requires": {
+ "speckit_version": ">=0.1.0",
+ "tools": [
+ {
+ "name": "understanding",
+ "version": ">=3.4.0",
+ "required": true
+ }
+ ]
+ },
+ "provides": {
+ "commands": 3,
+ "hooks": 1
+ },
+ "tags": [
+ "quality",
+ "metrics",
+ "requirements",
+ "validation",
+ "readability",
+ "IEEE-830",
+ "ISO-29148"
+ ],
+ "verified": false,
+ "downloads": 0,
+ "stars": 0,
+ "created_at": "2026-03-07T00:00:00Z",
+ "updated_at": "2026-03-07T00:00:00Z"
+ },
"v-model": {
"name": "V-Model Extension Pack",
"id": "v-model",
@@ -247,7 +317,13 @@
"commands": 9,
"hooks": 1
},
- "tags": ["v-model", "traceability", "testing", "compliance", "safety-critical"],
+ "tags": [
+ "v-model",
+ "traceability",
+ "testing",
+ "compliance",
+ "safety-critical"
+ ],
"verified": false,
"downloads": 0,
"stars": 0,
@@ -273,7 +349,13 @@
"commands": 1,
"hooks": 1
},
- "tags": ["verification", "quality-gate", "implementation", "spec-adherence", "compliance"],
+ "tags": [
+ "verification",
+ "quality-gate",
+ "implementation",
+ "spec-adherence",
+ "compliance"
+ ],
"verified": false,
"downloads": 0,
"stars": 0,