diff --git a/.gitignore b/.gitignore
index d9b12311..bdb8bf25 100644
--- a/.gitignore
+++ b/.gitignore
@@ -27,6 +27,7 @@ infra/terraform.tfvars
 .terraform
 .terraform*
 .langgraph_api
+.mcp.json
 
 # Virtual environments
 .venv
diff --git a/CLAUDE.md b/CLAUDE.md
index 44557d80..cf8adbd8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -21,8 +21,8 @@ Claude pulls these in on demand — load only what the task touches.
 - Pipeline contract (CI/CD):     @docs/_base/PIPELINE_CONTRACT.md
 
 > Project rules are enforced via `.claude/rules/` (commit-format, branch-naming,
-> security-patterns, product-vision, test-requirements, ui-design, versioning,
-> output-formatting). Read those first — they are authoritative on detail.
+> security-patterns, product-vision, test-requirements, ui-design, shadcn-ui,
+> versioning, output-formatting). Read those first — they are authoritative on detail.
 
 ## Safety
 
diff --git a/docs/_base/RULES.md b/docs/_base/RULES.md
index 73baa422..ad9937b8 100644
--- a/docs/_base/RULES.md
+++ b/docs/_base/RULES.md
@@ -1,6 +1,6 @@
 # ForecastLabAI Rules
 > Generated by: w7_generating-claudemd skill
-> Source of truth: `.claude/rules/` directory (commit-format, branch-naming, security-patterns, product-vision, test-requirements, ui-design, versioning, output-formatting). This file consolidates the constraint matrix; the rule files are authoritative on detail.
+> Source of truth: `.claude/rules/` directory (commit-format, branch-naming, security-patterns, product-vision, test-requirements, ui-design, shadcn-ui, versioning, output-formatting). This file consolidates the constraint matrix; the rule files are authoritative on detail.
 > Last reviewed: 2026-05-11
 
 ## Change Authority Matrix
diff --git a/skills-lock.json b/skills-lock.json
new file mode 100644
index 00000000..fe6cd2df
--- /dev/null
+++ b/skills-lock.json
@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "skills": {
+    "shadcn": {
+      "source": "shadcn/ui",
+      "sourceType": "github",
+      "skillPath": "skills/shadcn/SKILL.md",
+      "computedHash": "80a6226e78f6d1fe464214ae0ef449d49d8ffaa3e7704f011e9b418c678ad4d1"
+    }
+  }
+}