feat: Add constitution violation check command and after_implement hook

Adds /speckit.optimize.check for on-demand compliance auditing of feature
artifacts against constitution principles. Fills the gap between spec-kit's
built-in gates at /speckit.plan and /speckit.analyze where manual edits can
silently break constitution rules.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: sakitA

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to the Optimize extension will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-04-04
+
+### Added
+
+- Constitution violation check command (`/speckit.optimize.check`) — on-demand compliance audit of feature artifacts and code against constitution principles
+- `after_implement` hook — auto-prompts constitution check after implementation completes
+- Check configuration settings: `check.include_code_by_default`, `check.min_severity`
+- RFC 2119 keyword-based severity classification (CRITICAL for MUST/SHALL, HIGH for SHOULD)
+- Support for `--feature`, `--include-code`, and `--severity` arguments
+
 ## [1.0.0] - 2026-04-03
 
 ### Added

README.md

@@ -66,6 +66,39 @@ Measures the token footprint of all governance files and extension commands. Tra
 /speckit.optimize.tokens --extensions-only
 ```
 
+### `/speckit.optimize.check` — Constitution Violation Check
+
+On-demand compliance audit: checks the current feature's spec, plan, tasks, and optionally implementation code against every principle in the constitution. Catches violations introduced by manual edits between the built-in `/speckit.plan` and `/speckit.analyze` gates.
+
+```bash
+# Check active feature against constitution
+/speckit.optimize.check
+
+# Check a specific feature
+/speckit.optimize.check --feature user-authentication
+
+# Also scan implementation source files
+/speckit.optimize.check --include-code
+
+# Only show critical violations
+/speckit.optimize.check --severity CRITICAL
+```
+
+| Argument | Description | Default |
+|----------|-------------|---------|
+| `--feature <name>` | Target a specific feature instead of auto-detecting | Active feature |
+| `--include-code` | Also scan implementation source files referenced in tasks | Disabled |
+| `--severity <level>` | Filter to CRITICAL, HIGH, or ALL | ALL |
+
+**How it works:**
+1. Parses the constitution into individual principles using RFC 2119 keywords (MUST, SHOULD, etc.)
+2. Loads the feature's spec.md, plan.md, and tasks.md
+3. Evaluates each principle for contradictions, omissions, structural violations, and semantic drift
+4. Reports violations with severity (CRITICAL for MUST, HIGH for SHOULD, MEDIUM for ambiguous)
+5. Provides evidence and location for every finding
+
+**Hook:** After `/speckit.implement` completes, you are prompted to run this check automatically. This catches violations at the earliest useful moment — after code is written but before you commit.
+
 ### `/speckit.optimize.learn` — Session Learning
 
 End-of-session analysis: detects AI mistake patterns, repetitive corrections, and governance gaps. Suggests constitution rules or memory entries to prevent recurrence.
@@ -99,6 +132,8 @@ cp .specify/extensions/optimize/config-template.yml \
 ```
 
 Key settings:
+- `check.include_code_by_default` — scan implementation files without `--include-code` flag
+- `check.min_severity` — minimum severity to report (CRITICAL, HIGH, MEDIUM, or ALL)
 - `categories.*` — toggle individual analysis categories on/off
 - `thresholds.max_constitution_tokens` — flag constitutions exceeding this token estimate
 - `thresholds.governance_budget_percent` — max % of context window for governance overhead
@@ -109,6 +144,7 @@ Key settings:
 
 - **`/speckit.constitution`** — authoring tool. Optimize hands off to it for applying approved changes with proper version bumping.
 - **`/speckit.analyze`** — consistency checker. Run after optimization to verify cross-artifact alignment.
+- **`/speckit.optimize.check`** → **`/speckit.optimize.run`** — if violations are found, run the full audit to optimize the constitution.
 - **`/speckit.optimize.tokens`** → **`/speckit.optimize.run`** — if token tracker reveals high governance overhead, run the full audit.
 - **`/speckit.optimize.learn`** → **`/speckit.constitution`** — approved rules from session learning are applied via the constitution skill.
 

catalog-entry.json

@@ -3,8 +3,8 @@
   "id": "optimize",
   "description": "Audits and optimizes AI governance for context efficiency",
   "author": "sakitA",
-  "version": "1.0.0",
-  "download_url": "https://github.com/sakitA/spec-kit-optimize/archive/refs/tags/v1.0.0.zip",
+  "version": "1.1.0",
+  "download_url": "https://github.com/sakitA/spec-kit-optimize/archive/refs/tags/v1.1.0.zip",
   "repository": "https://github.com/sakitA/spec-kit-optimize",
   "homepage": "https://github.com/sakitA/spec-kit-optimize",
   "documentation": "https://github.com/sakitA/spec-kit-optimize/blob/main/README.md",
@@ -14,19 +14,21 @@
     "speckit_version": ">=0.1.0"
   },
   "provides": {
-    "commands": 3,
-    "hooks": 0
+    "commands": 4,
+    "hooks": 1
   },
   "tags": [
     "constitution",
     "optimization",
     "token-budget",
     "governance",
-    "audit"
+    "audit",
+    "compliance",
+    "violation-check"
   ],
   "verified": false,
   "downloads": 0,
   "stars": 0,
   "created_at": "2026-04-03T00:00:00Z",
-  "updated_at": "2026-04-03T00:00:00Z"
+  "updated_at": "2026-04-04T00:00:00Z"
 }