tribunal-kit 8.0.0 → 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (258) hide show
  1. package/.agent/ARCHITECTURE.md +2 -2
  2. package/.agent/config/plugin.json +4 -4
  3. package/.agent/config/system-prompt.md +54 -1
  4. package/.agent/routing_index.json +2 -2
  5. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -16
  6. package/.agent/skills/60fps-animation/SKILL.md +47 -21
  7. package/.agent/skills/accessible-animation/SKILL.md +19 -16
  8. package/.agent/skills/adapt/SKILL.md +19 -16
  9. package/.agent/skills/advanced-rag-pipelines/SKILL.md +41 -40
  10. package/.agent/skills/agent-organizer/SKILL.md +9 -59
  11. package/.agent/skills/agentic-patterns/SKILL.md +9 -57
  12. package/.agent/skills/agentic-workflows-2026/SKILL.md +45 -8
  13. package/.agent/skills/ai-app-hardening/SKILL.md +31 -5
  14. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +28 -66
  15. package/.agent/skills/animation-on-scroll/SKILL.md +19 -16
  16. package/.agent/skills/animation-systems/SKILL.md +19 -15
  17. package/.agent/skills/antfu-conventions/SKILL.md +19 -18
  18. package/.agent/skills/api-patterns/SKILL.md +8 -58
  19. package/.agent/skills/api-security-auditor/SKILL.md +8 -58
  20. package/.agent/skills/app-builder/SKILL.md +9 -59
  21. package/.agent/skills/appflow-wireframe/SKILL.md +13 -57
  22. package/.agent/skills/apple-design/SKILL.md +22 -14
  23. package/.agent/skills/architecture/SKILL.md +9 -59
  24. package/.agent/skills/audit-and-fix/SKILL.md +19 -16
  25. package/.agent/skills/authentication-best-practices/SKILL.md +8 -58
  26. package/.agent/skills/backend-security-expert/SKILL.md +32 -65
  27. package/.agent/skills/baseline-ui/SKILL.md +22 -14
  28. package/.agent/skills/bash-linux/SKILL.md +9 -59
  29. package/.agent/skills/behavioral-modes/SKILL.md +9 -57
  30. package/.agent/skills/better-colors/SKILL.md +22 -14
  31. package/.agent/skills/better-typography/SKILL.md +26 -14
  32. package/.agent/skills/better-ui/SKILL.md +54 -19
  33. package/.agent/skills/bolder/SKILL.md +19 -16
  34. package/.agent/skills/brainstorming/SKILL.md +9 -57
  35. package/.agent/skills/browser-native-ai/SKILL.md +9 -28
  36. package/.agent/skills/build-primitive/SKILL.md +19 -16
  37. package/.agent/skills/building-native-ui/SKILL.md +9 -59
  38. package/.agent/skills/cicd-pro/SKILL.md +21 -28
  39. package/.agent/skills/clarify/SKILL.md +19 -16
  40. package/.agent/skills/clean-code/SKILL.md +18 -61
  41. package/.agent/skills/cloud-architect/SKILL.md +21 -28
  42. package/.agent/skills/cobejs/SKILL.md +19 -15
  43. package/.agent/skills/code-review-checklist/SKILL.md +8 -58
  44. package/.agent/skills/codebase-design/SKILL.md +33 -22
  45. package/.agent/skills/colorize/SKILL.md +19 -16
  46. package/.agent/skills/compact-landing/SKILL.md +19 -16
  47. package/.agent/skills/company-logos/SKILL.md +19 -16
  48. package/.agent/skills/config-validator/SKILL.md +9 -59
  49. package/.agent/skills/containerization-pro/SKILL.md +21 -28
  50. package/.agent/skills/context-engineering-pro/SKILL.md +31 -5
  51. package/.agent/skills/create-design-md/SKILL.md +22 -14
  52. package/.agent/skills/critique/SKILL.md +20 -11
  53. package/.agent/skills/csharp-developer/SKILL.md +8 -58
  54. package/.agent/skills/data-validation-schemas/SKILL.md +9 -59
  55. package/.agent/skills/database-design/SKILL.md +27 -67
  56. package/.agent/skills/delight/SKILL.md +19 -16
  57. package/.agent/skills/deployment-procedures/SKILL.md +9 -59
  58. package/.agent/skills/design-lab/SKILL.md +19 -16
  59. package/.agent/skills/devops-engineer/SKILL.md +8 -58
  60. package/.agent/skills/devops-incident-responder/SKILL.md +9 -59
  61. package/.agent/skills/diagnosing-bugs/SKILL.md +20 -21
  62. package/.agent/skills/distill/SKILL.md +19 -16
  63. package/.agent/skills/documentation-templates/SKILL.md +9 -59
  64. package/.agent/skills/domain-modeling/SKILL.md +19 -18
  65. package/.agent/skills/duckdb-analytical-sql/SKILL.md +31 -5
  66. package/.agent/skills/edge-ai-mobile/SKILL.md +31 -5
  67. package/.agent/skills/edge-computing/SKILL.md +9 -59
  68. package/.agent/skills/emil-design-eng/SKILL.md +21 -24
  69. package/.agent/skills/error-resilience/SKILL.md +31 -66
  70. package/.agent/skills/expo-router-v4/SKILL.md +31 -5
  71. package/.agent/skills/extract-design-system/SKILL.md +9 -59
  72. package/.agent/skills/fabel-protocol/SKILL.md +26 -8
  73. package/.agent/skills/fixing-accessibility/SKILL.md +22 -14
  74. package/.agent/skills/fixing-metadata/SKILL.md +19 -16
  75. package/.agent/skills/fixing-motion-performance/SKILL.md +22 -14
  76. package/.agent/skills/framer-motion-expert/SKILL.md +9 -57
  77. package/.agent/skills/frontend-design/SKILL.md +27 -7
  78. package/.agent/skills/frontend-security-expert/SKILL.md +8 -58
  79. package/.agent/skills/game-design-expert/SKILL.md +9 -59
  80. package/.agent/skills/game-engineering-expert/SKILL.md +9 -59
  81. package/.agent/skills/generative-ui-expert/SKILL.md +9 -28
  82. package/.agent/skills/geo-fundamentals/SKILL.md +9 -59
  83. package/.agent/skills/git-pro/SKILL.md +19 -30
  84. package/.agent/skills/github-operations/SKILL.md +8 -58
  85. package/.agent/skills/gpt-taste/SKILL.md +19 -16
  86. package/.agent/skills/gsap-core/SKILL.md +8 -78
  87. package/.agent/skills/gsap-frameworks/SKILL.md +8 -78
  88. package/.agent/skills/gsap-performance/SKILL.md +9 -77
  89. package/.agent/skills/gsap-plugins/SKILL.md +9 -77
  90. package/.agent/skills/gsap-react/SKILL.md +9 -21
  91. package/.agent/skills/gsap-scrolltrigger/SKILL.md +8 -78
  92. package/.agent/skills/gsap-timeline/SKILL.md +9 -77
  93. package/.agent/skills/gsap-utils/SKILL.md +9 -77
  94. package/.agent/skills/harden/SKILL.md +19 -16
  95. package/.agent/skills/harness-protocol/SKILL.md +9 -21
  96. package/.agent/skills/i18n-localization/SKILL.md +9 -59
  97. package/.agent/skills/impeccable/SKILL.md +19 -18
  98. package/.agent/skills/improve-codebase-architecture/SKILL.md +19 -17
  99. package/.agent/skills/improve-ui/SKILL.md +22 -14
  100. package/.agent/skills/intelligent-routing/SKILL.md +9 -23
  101. package/.agent/skills/knowledge-graph/SKILL.md +9 -21
  102. package/.agent/skills/landing-page/SKILL.md +19 -16
  103. package/.agent/skills/lint-and-validate/SKILL.md +9 -59
  104. package/.agent/skills/llm-engineering/SKILL.md +8 -58
  105. package/.agent/skills/local-first/SKILL.md +9 -59
  106. package/.agent/skills/local-first-architecture/SKILL.md +37 -20
  107. package/.agent/skills/lottie-animation/SKILL.md +19 -15
  108. package/.agent/skills/marquee-loop/SKILL.md +19 -16
  109. package/.agent/skills/masked-reveal/SKILL.md +19 -15
  110. package/.agent/skills/mcp-builder/SKILL.md +9 -59
  111. package/.agent/skills/micro-interaction/SKILL.md +19 -16
  112. package/.agent/skills/mobile-design/SKILL.md +8 -58
  113. package/.agent/skills/monorepo-management/SKILL.md +9 -59
  114. package/.agent/skills/morphing-icons/SKILL.md +19 -15
  115. package/.agent/skills/motion-engineering/SKILL.md +22 -15
  116. package/.agent/skills/nextjs-react-expert/SKILL.md +35 -67
  117. package/.agent/skills/nodejs-best-practices/SKILL.md +34 -61
  118. package/.agent/skills/observability/SKILL.md +8 -58
  119. package/.agent/skills/opentelemetry-observability/SKILL.md +31 -5
  120. package/.agent/skills/page-transition-animation/SKILL.md +19 -16
  121. package/.agent/skills/parallel-agents/SKILL.md +9 -59
  122. package/.agent/skills/performance-profiling/SKILL.md +8 -58
  123. package/.agent/skills/plan-writing/SKILL.md +36 -69
  124. package/.agent/skills/platform-engineer/SKILL.md +9 -59
  125. package/.agent/skills/platform-engineering-opentofu/SKILL.md +31 -5
  126. package/.agent/skills/playwright-ai-e2e/SKILL.md +31 -5
  127. package/.agent/skills/playwright-best-practices/SKILL.md +9 -59
  128. package/.agent/skills/polish/SKILL.md +19 -16
  129. package/.agent/skills/powershell-windows/SKILL.md +8 -58
  130. package/.agent/skills/pricing-page/SKILL.md +19 -16
  131. package/.agent/skills/product-aware-heuristics/SKILL.md +27 -8
  132. package/.agent/skills/progressive-blur/SKILL.md +19 -16
  133. package/.agent/skills/project-idioms/SKILL.md +9 -59
  134. package/.agent/skills/property-based-testing/SKILL.md +31 -5
  135. package/.agent/skills/python-patterns/SKILL.md +9 -59
  136. package/.agent/skills/python-pro/SKILL.md +35 -67
  137. package/.agent/skills/quieter/SKILL.md +19 -16
  138. package/.agent/skills/react-doctor/SKILL.md +19 -16
  139. package/.agent/skills/react-specialist/SKILL.md +26 -65
  140. package/.agent/skills/readme-builder/SKILL.md +9 -59
  141. package/.agent/skills/realtime-patterns/SKILL.md +8 -58
  142. package/.agent/skills/red-team-tactics/SKILL.md +9 -59
  143. package/.agent/skills/redesign-skill/SKILL.md +19 -16
  144. package/.agent/skills/review-animations/SKILL.md +21 -25
  145. package/.agent/skills/rust-pro/SKILL.md +30 -61
  146. package/.agent/skills/seo-fundamentals/SKILL.md +9 -59
  147. package/.agent/skills/server-management/SKILL.md +9 -59
  148. package/.agent/skills/shadcn-ui-expert/SKILL.md +9 -59
  149. package/.agent/skills/shape/SKILL.md +19 -16
  150. package/.agent/skills/skill-creator/SKILL.md +36 -86
  151. package/.agent/skills/soft-skill/SKILL.md +19 -16
  152. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -16
  153. package/.agent/skills/sql-pro/SKILL.md +47 -62
  154. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +9 -59
  155. package/.agent/skills/svg-animation/SKILL.md +19 -15
  156. package/.agent/skills/swiftui-expert/SKILL.md +9 -59
  157. package/.agent/skills/swiss-design/SKILL.md +19 -16
  158. package/.agent/skills/system-design-pro/SKILL.md +21 -26
  159. package/.agent/skills/systematic-debugging/SKILL.md +19 -60
  160. package/.agent/skills/systematic-debugging/condition-based-waiting.md +115 -0
  161. package/.agent/skills/systematic-debugging/defense-in-depth.md +122 -0
  162. package/.agent/skills/systematic-debugging/root-cause-tracing.md +169 -0
  163. package/.agent/skills/tailwind-patterns/SKILL.md +8 -58
  164. package/.agent/skills/taste-skill/SKILL.md +19 -16
  165. package/.agent/skills/tdd-workflow/SKILL.md +65 -25
  166. package/.agent/skills/test-result-analyzer/SKILL.md +9 -59
  167. package/.agent/skills/testing-patterns/SKILL.md +8 -58
  168. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +19 -18
  169. package/.agent/skills/thinking-protocol/SKILL.md +33 -2
  170. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -15
  171. package/.agent/skills/transitions-dev/SKILL.md +19 -15
  172. package/.agent/skills/trend-researcher/SKILL.md +9 -59
  173. package/.agent/skills/typescript-advanced/SKILL.md +21 -64
  174. package/.agent/skills/typeset/SKILL.md +19 -16
  175. package/.agent/skills/ui-reasoning-engine/SKILL.md +27 -8
  176. package/.agent/skills/ui-skill-packs/SKILL.md +26 -16
  177. package/.agent/skills/ui-skills-root/SKILL.md +22 -14
  178. package/.agent/skills/ui-ux-pro-max/SKILL.md +38 -12
  179. package/.agent/skills/ui-ux-researcher/SKILL.md +9 -59
  180. package/.agent/skills/vector-search-pgvector/SKILL.md +31 -5
  181. package/.agent/skills/verification-before-completion/SKILL.md +125 -0
  182. package/.agent/skills/vue-expert/SKILL.md +9 -57
  183. package/.agent/skills/vulnerability-scanner/SKILL.md +8 -58
  184. package/.agent/skills/web-accessibility-auditor/SKILL.md +9 -59
  185. package/.agent/skills/web-design-guidelines/SKILL.md +27 -7
  186. package/.agent/skills/web-quality-audit/SKILL.md +19 -16
  187. package/.agent/skills/webapp-testing/SKILL.md +9 -59
  188. package/.agent/skills/webgpu-performance/SKILL.md +9 -28
  189. package/.agent/skills/whimsy-injector/SKILL.md +9 -57
  190. package/.agent/skills/workflow-optimizer/SKILL.md +9 -57
  191. package/.agent/skills/zero-trust-passkeys/SKILL.md +31 -5
  192. package/.agent/templates/DESIGN.md +680 -160
  193. package/.agent/templates/sdd/implementer-prompt.md +53 -0
  194. package/.agent/templates/sdd/re-review-prompt.md +28 -0
  195. package/.agent/templates/sdd/task-reviewer-prompt.md +59 -0
  196. package/.agent/workflows/acf.md +4 -0
  197. package/.agent/workflows/api-tester.md +5 -0
  198. package/.agent/workflows/audit.md +5 -0
  199. package/.agent/workflows/brainstorm.md +17 -1
  200. package/.agent/workflows/changelog.md +5 -0
  201. package/.agent/workflows/contract.md +19 -0
  202. package/.agent/workflows/create.md +6 -1
  203. package/.agent/workflows/debug.md +5 -0
  204. package/.agent/workflows/deploy.md +6 -1
  205. package/.agent/workflows/enhance.md +6 -1
  206. package/.agent/workflows/fix-ci.md +5 -0
  207. package/.agent/workflows/fix.md +5 -0
  208. package/.agent/workflows/generate.md +5 -0
  209. package/.agent/workflows/marathon.md +6 -1
  210. package/.agent/workflows/migrate.md +5 -0
  211. package/.agent/workflows/minimal.md +4 -0
  212. package/.agent/workflows/orchestrate.md +6 -1
  213. package/.agent/workflows/performance-benchmarker.md +6 -1
  214. package/.agent/workflows/pipeline.md +5 -0
  215. package/.agent/workflows/plan.md +6 -1
  216. package/.agent/workflows/preview.md +6 -1
  217. package/.agent/workflows/refactor.md +6 -0
  218. package/.agent/workflows/review-ai.md +5 -0
  219. package/.agent/workflows/review.md +5 -0
  220. package/.agent/workflows/sdd.md +122 -0
  221. package/.agent/workflows/session.md +5 -0
  222. package/.agent/workflows/status.md +4 -0
  223. package/.agent/workflows/super-prompt.md +4 -0
  224. package/.agent/workflows/swarm.md +6 -1
  225. package/.agent/workflows/test.md +6 -1
  226. package/.agent/workflows/tribunal-backend.md +5 -0
  227. package/.agent/workflows/tribunal-cicd.md +5 -0
  228. package/.agent/workflows/tribunal-database.md +5 -0
  229. package/.agent/workflows/tribunal-full.md +8 -0
  230. package/.agent/workflows/tribunal-mobile.md +5 -0
  231. package/.agent/workflows/tribunal-performance.md +5 -0
  232. package/.agent/workflows/tribunal-speed.md +5 -0
  233. package/.agent/workflows/tribunal-ui.md +7 -0
  234. package/.agents/plugins/marketplace.json +20 -0
  235. package/.claude-plugin/marketplace.json +17 -0
  236. package/.claude-plugin/plugin.json +26 -0
  237. package/.codex-plugin/plugin.json +45 -0
  238. package/.cursor-plugin/plugin.json +26 -0
  239. package/.devin-plugin/plugin.json +14 -0
  240. package/.hermes-plugin/__init__.py +102 -0
  241. package/.hermes-plugin/plugin.yaml +6 -0
  242. package/.kimi-plugin/plugin.json +38 -0
  243. package/.opencode/INSTALL.md +41 -0
  244. package/.opencode/plugins/tribunal.js +101 -0
  245. package/.pi/extensions/tribunal.ts +133 -0
  246. package/CONTRIBUTING.md +1 -1
  247. package/README.md +246 -221
  248. package/bin/wrapper.js +1 -0
  249. package/dist/cli.js +355 -355
  250. package/dist/esm/index.mjs +142 -142
  251. package/dist/index.d.ts +349 -343
  252. package/gemini-extension.json +6 -0
  253. package/hooks/hooks-cursor.json +16 -0
  254. package/hooks/hooks.json +16 -0
  255. package/hooks/session-start.js +77 -0
  256. package/package.json +165 -146
  257. package/scripts/audit_skill_sdo.js +87 -0
  258. package/scripts/modernize_skills.js +254 -0
@@ -2,8 +2,8 @@
2
2
  name: ui-ux-researcher
3
3
  description: Expert auditor for accessibility, cognitive load, and premium design heuristics.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - web-design-guidelines
9
9
  - frontend-design
@@ -25,10 +25,14 @@ Before conducting UX audits or evaluating cognitive load heuristics, you MUST in
25
25
  2. Nielsen 10 Heuristics Alignment (Section 162) → Map all P1 findings explicitly to Nielsen heuristics (H1–H10)
26
26
  3. Quantitative UX Scoring Formula (Section 96) → Calculate UX score strictly via formula: `Score = (P0 × 0.5) + (P1 × 0.3) + (P2 × 0.2)`
27
27
 
28
- # UI/UX Researcher Skill
29
-
30
28
  You are an expert UX auditor specializing in accessibility compliance, cognitive load optimization, and premium design heuristics. You audit existing UI against 2026 best practices and provide scored, actionable reports.
31
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Expert auditor for accessibility, cognitive load, and premium design heuristics..
34
+ - **DO NOT activate when:** The task falls strictly outside ui-ux-researcher domain or belongs to a different dedicated specialist.
35
+
32
36
  ## When to Activate
33
37
 
34
38
  - When asked to "review my UI", "check accessibility", "audit design", or "review UX".
@@ -220,69 +224,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
220
224
 
221
225
  ---
222
226
 
223
- **Slash command: `/review` or `/tribunal-full`**
224
- **Active reviewers: `logic-reviewer` · `security-auditor`**
225
-
226
- ### ❌ Forbidden AI Tropes
227
-
228
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
229
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
230
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
231
-
232
- Review these questions before confirming output:
233
-
234
- ```
235
- ✅ Did I rely ONLY on real, verified tools and methods?
236
- ✅ Is this solution appropriately scoped to the user's constraints?
237
- ✅ Did I handle potential failure modes and edge cases?
238
- ✅ Have I avoided generic boilerplate that doesn't add value?
239
- ```
240
-
241
- ### 🛑 Verification-Before-Completion (VBC) Protocol
242
-
243
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
244
-
245
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
246
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
247
-
248
- ## Pre-Flight Checklist
249
-
250
- - [ ] Have I reviewed the user's specific constraints and requests?
251
- - [ ] Have I checked the environment for relevant existing implementations?
252
-
253
- ## VBC Protocol (Verification-Before-Completion)
254
-
255
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
256
-
257
- ---
258
-
259
- ## 🤖 LLM-Specific Traps
260
-
261
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
262
-
263
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
264
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
265
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
266
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
267
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
268
-
269
- ---
270
-
271
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
227
+ ## 🏛️ Tribunal Verification & Guardrails
272
228
 
273
229
  **Slash command: `/review` or `/tribunal-full`**
274
230
  **Active reviewers: `logic-reviewer` · `security-auditor`**
275
231
 
276
232
  ### ❌ Forbidden AI Tropes
277
-
278
233
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
279
234
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
280
235
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
281
236
 
282
237
  ### ✅ Pre-Flight Self-Audit
283
-
284
- Review these questions before confirming output:
285
-
286
238
  ```
287
239
  ✅ Did I rely ONLY on real, verified tools and methods?
288
240
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -291,8 +243,6 @@ Review these questions before confirming output:
291
243
  ```
292
244
 
293
245
  ### 🛑 Verification-Before-Completion (VBC) Protocol
294
-
295
246
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
296
-
297
247
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
298
248
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: vector-search-pgvector
3
3
  description: Production vector database search using pgvector 0.8.0+, halfvec, sparsevec, Pinecone, Weaviate, hybrid sparse-dense retrieval, and iterative HNSW scanning.
4
4
  tools: Read, Grep, Glob, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-08-05
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  script: .agent/scripts/schema_validator.js
8
8
  scripts-binding:
9
9
  - .agent/scripts/schema_validator.js
@@ -23,6 +23,12 @@ Before creating vector tables or indexes:
23
23
  2. Iterative Index Scans (pgvector 0.8.0+) → Enable iterative scanning to prevent HNSW overfiltering when combining `WHERE` clauses with vector similarity
24
24
  3. Hybrid Search Strategy → Combine BM25 full-text search with dense vector similarity via Reciprocal Rank Fusion (RRF)
25
25
 
26
+
27
+ ## Activation Boundaries
28
+
29
+ - **Activate when:** Operating in tasks requiring Production vector database search using pgvector 0.8.0+, halfvec, sparsevec, Pinecone, Weaviate, hybrid sparse-dense retrieval, and iterative HNSW scanning..
30
+ - **DO NOT activate when:** The task falls strictly outside vector-search-pgvector domain or belongs to a different dedicated specialist.
31
+
26
32
  ## High-Performance pgvector 0.8.0+ Schema (`halfvec` + HNSW)
27
33
 
28
34
  ```sql
@@ -72,7 +78,27 @@ ORDER BY rrf_score DESC
72
78
  LIMIT 10;
73
79
  ```
74
80
 
75
- ## 🛑 Verification-Before-Completion (VBC) Protocol
81
+ ---
82
+
83
+ ## 🏛️ Tribunal Verification & Guardrails
84
+
85
+ **Slash command: `/review` or `/tribunal-full`**
86
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
87
+
88
+ ### ❌ Forbidden AI Tropes
89
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
90
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
91
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
92
+
93
+ ### ✅ Pre-Flight Self-Audit
94
+ ```
95
+ ✅ Did I rely ONLY on real, verified tools and methods?
96
+ ✅ Is this solution appropriately scoped to the user's constraints?
97
+ ✅ Did I handle potential failure modes and edge cases?
98
+ ✅ Have I avoided generic boilerplate that doesn't add value?
99
+ ```
76
100
 
77
- - Verify vector index construction queries pass `EXPLAIN ANALYZE` with `halfvec`.
78
- - Confirm pgvector extension version is >= 0.8.0 for iterative scanning support.
101
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
102
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
103
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
104
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -0,0 +1,125 @@
1
+ ---
2
+ name: verification-before-completion
3
+ description: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 4.0.0
6
+ last-updated: 2026-09-08
7
+ skills:
8
+ - clean-code
9
+ - tdd-workflow
10
+ scripts-binding:
11
+ - .agent/scripts/verify_all.js
12
+ - .agent/scripts/checklist.js
13
+ ---
14
+
15
+ # Verification Before Completion
16
+
17
+ ## Overview
18
+
19
+ **Core principle:** Evidence before claims, always.
20
+
21
+ **Violating the letter of this rule is violating the spirit of this rule.**
22
+
23
+ ## The Iron Law
24
+
25
+ ```
26
+ NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
27
+ ```
28
+
29
+ If you haven't run the verification command in this message, you cannot claim it passes.
30
+
31
+ ## The Gate Function
32
+
33
+ ```
34
+ BEFORE claiming any status or expressing satisfaction:
35
+
36
+ 1. IDENTIFY: What command proves this claim?
37
+ 2. RUN: Execute the FULL command (fresh, complete)
38
+ 3. READ: Full output, check exit code, count failures
39
+ 4. VERIFY: Does output confirm the claim?
40
+ - If NO: State actual status with evidence
41
+ - If YES: State claim WITH evidence
42
+ 5. ONLY THEN: Make the claim
43
+
44
+ Skip any step = lying, not verifying
45
+ ```
46
+
47
+ ## Common Failures
48
+
49
+ | Claim | Requires | Not Sufficient |
50
+ |-------|----------|----------------|
51
+ | Tests pass | Test command output: 0 failures | Previous run, "should pass" |
52
+ | Linter clean | Linter output: 0 errors | Partial check, extrapolation |
53
+ | Build succeeds | Build command: exit 0 | Linter passing, logs look good |
54
+ | Bug fixed | Test original symptom: passes | Code changed, assumed fixed |
55
+ | Regression test works | Red-green cycle verified | Test passes once |
56
+ | Agent completed | VCS diff shows changes | Agent reports "success" |
57
+ | Requirements met | Line-by-line checklist | Tests passing |
58
+
59
+ ## Red Flags - STOP
60
+
61
+ - Using "should", "probably", "seems to"
62
+ - Expressing satisfaction before verification ("Great!", "Perfect!", "Done!", etc.)
63
+ - About to commit/push/PR without verification
64
+ - Trusting agent success reports
65
+ - Relying on partial verification
66
+ - Thinking "just this once"
67
+ - Tired and wanting work over
68
+ - **ANY wording implying success without having run verification**
69
+
70
+ ## Rationalization Prevention
71
+
72
+ | Excuse | Reality |
73
+ |--------|---------|
74
+ | "Should work now" | RUN the verification |
75
+ | "I'm confident" | Confidence ≠ evidence |
76
+ | "Just this once" | No exceptions |
77
+ | "Linter passed" | Linter ≠ compiler |
78
+ | "Agent said success" | Verify independently |
79
+ | "Partial check is enough" | Partial proves nothing |
80
+
81
+ ## Key Patterns
82
+
83
+ **Tests:**
84
+ ```
85
+ ✅ [Run test command] [See: 34/34 pass] "All tests pass"
86
+ ❌ "Should pass now" / "Looks correct"
87
+ ```
88
+
89
+ **Build:**
90
+ ```
91
+ ✅ [Run build] [See: exit 0] "Build passes"
92
+ ❌ "Linter passed" (linter doesn't check compilation)
93
+ ```
94
+
95
+ **Requirements:**
96
+ ```
97
+ ✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
98
+ ❌ "Tests pass, phase complete"
99
+ ```
100
+
101
+ ---
102
+
103
+ ## 🏛️ Tribunal Verification & Guardrails
104
+
105
+ **Slash command: `/review` or `/tribunal-full`**
106
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
107
+
108
+ ### ❌ Forbidden AI Tropes
109
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
110
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
111
+ 3. **Premature Satisfaction:** Declaring victory before seeing fresh terminal output.
112
+
113
+ ### ✅ Pre-Flight Checklist
114
+ ```
115
+ ✅ Did I execute the actual command rather than assuming success?
116
+ ✅ Did I read the exit code and verify 0 failures?
117
+ ✅ Did I inspect the full diff to confirm only intended changes were made?
118
+ ✅ Have I avoided all rationalizations ("should work", "looks good")?
119
+ ```
120
+
121
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
122
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
123
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
124
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
125
+
@@ -2,8 +2,8 @@
2
2
  name: vue-expert
3
3
  description: Vue 3.5+ Composition API. Script setup, reactive refs, computed, watchers, composables, Pinia, Vue Router 4, Nuxt 4. Use when building Vue/Nuxt applications.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - baseline-ui
9
9
  - better-ui
@@ -25,6 +25,12 @@ Before writing Vue 3.5+ or Nuxt 4 components, you MUST inspect:
25
25
  2. Pinia & Reactivity Rules (Section 133) → Use `storeToRefs(store)` when destructuring Pinia state to preserve reactivity
26
26
  3. Model & Watcher Syntax (Section 42) → Use `defineModel<T>()` (Vue 3.4+) and `watch(() => state.prop, ...)` for primitive watchers
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Vue 3.5+ Composition API. Script setup, reactive refs, computed, watchers, composables, Pinia, Vue Router 4, Nuxt 4. Use when building Vue/Nuxt applications..
32
+ - **DO NOT activate when:** The task falls strictly outside vue-expert domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Options API (`data()`, `methods:`, `computed:`) → ✅ `<script setup lang="ts">`
@@ -274,69 +280,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
274
280
 
275
281
  ---
276
282
 
277
- **Slash command: `/review` or `/tribunal-full`**
278
- **Active reviewers: `logic-reviewer` · `security-auditor`**
279
-
280
- ### ❌ Forbidden AI Tropes
281
-
282
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
283
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
284
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
285
-
286
- Review these questions before confirming output:
287
-
288
- ```
289
- ✅ Did I rely ONLY on real, verified tools and methods?
290
- ✅ Is this solution appropriately scoped to the user's constraints?
291
- ✅ Did I handle potential failure modes and edge cases?
292
- ✅ Have I avoided generic boilerplate that doesn't add value?
293
- ```
294
-
295
- ### 🛑 Verification-Before-Completion (VBC) Protocol
296
-
297
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
298
-
299
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
300
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
301
-
302
- ## Pre-Flight Checklist
303
-
304
- - [ ] Have I reviewed the user's specific constraints and requests?
305
- - [ ] Have I checked the environment for relevant existing implementations?
306
-
307
- ## VBC Protocol (Verification-Before-Completion)
308
-
309
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
310
-
311
- ---
312
-
313
- ## 🤖 LLM-Specific Traps
314
-
315
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
316
-
317
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
318
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
319
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
320
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
321
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
322
-
323
- ---
324
-
325
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
283
+ ## 🏛️ Tribunal Verification & Guardrails
326
284
 
327
285
  **Slash command: `/review` or `/tribunal-full`**
328
286
  **Active reviewers: `logic-reviewer` · `security-auditor`**
329
287
 
330
288
  ### ❌ Forbidden AI Tropes
331
-
332
289
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
333
290
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
334
291
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
335
292
 
336
293
  ### ✅ Pre-Flight Self-Audit
337
-
338
- Review these questions before confirming output:
339
-
340
294
  ```
341
295
  ✅ Did I rely ONLY on real, verified tools and methods?
342
296
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -345,8 +299,6 @@ Review these questions before confirming output:
345
299
  ```
346
300
 
347
301
  ### 🛑 Verification-Before-Completion (VBC) Protocol
348
-
349
302
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
350
-
351
303
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
352
304
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: vulnerability-scanner
3
3
  description: Security vulnerability analysis mastery. OWASP Top 10 (2025), injection attacks (SQL, XSS, SSRF, command), authentication/authorization flaws, dependency vulnerabilities, secret scanning, CORS misconfiguration, supply chain attacks, and security headers. Use when auditing security, reviewing code for vulnerabilities, or hardening applications.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - backend-security-expert
9
9
  - frontend-security-expert
@@ -25,7 +25,11 @@ Before scanning codebases for security vulnerabilities, you MUST inspect:
25
25
  2. Explicit JWT Algorithms (Section 121) → Verify `jwt.verify(token, secret, { algorithms: ["HS256"] })` specifies explicit algorithms to prevent "None" attacks
26
26
  3. SSRF Domain Allowlist (Section 87) → Validate external request URLs against a strict domain allowlist and block private IP ranges (169.254.169.254, 127.0.0.1)
27
27
 
28
- # Vulnerability Scanner — Security Analysis Mastery
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Security vulnerability analysis mastery. OWASP Top 10 (2025), injection attacks (SQL, XSS, SSRF, command), authentication/authorization flaws, dependency vulnerabilities, secret scanning, CORS misconfiguration, supply chain attacks, and security headers. Use when auditing security, reviewing code for vulnerabilities, or hardening applications..
32
+ - **DO NOT activate when:** The task falls strictly outside vulnerability-scanner domain or belongs to a different dedicated specialist.
29
33
 
30
34
  ---
31
35
 
@@ -395,69 +399,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
395
399
 
396
400
  ---
397
401
 
398
- **Slash command: `/review` or `/tribunal-full`**
399
- **Active reviewers: `logic-reviewer` · `security-auditor`**
400
-
401
- ### ❌ Forbidden AI Tropes
402
-
403
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
404
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
405
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
406
-
407
- Review these questions before confirming output:
408
-
409
- ```
410
- ✅ Did I rely ONLY on real, verified tools and methods?
411
- ✅ Is this solution appropriately scoped to the user's constraints?
412
- ✅ Did I handle potential failure modes and edge cases?
413
- ✅ Have I avoided generic boilerplate that doesn't add value?
414
- ```
415
-
416
- ### 🛑 Verification-Before-Completion (VBC) Protocol
417
-
418
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
419
-
420
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
421
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
422
-
423
- ## Pre-Flight Checklist
424
-
425
- - [ ] Have I reviewed the user's specific constraints and requests?
426
- - [ ] Have I checked the environment for relevant existing implementations?
427
-
428
- ## VBC Protocol (Verification-Before-Completion)
429
-
430
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
431
-
432
- ---
433
-
434
- ## 🤖 LLM-Specific Traps
435
-
436
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
437
-
438
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
439
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
440
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
441
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
442
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
443
-
444
- ---
445
-
446
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
402
+ ## 🏛️ Tribunal Verification & Guardrails
447
403
 
448
404
  **Slash command: `/review` or `/tribunal-full`**
449
405
  **Active reviewers: `logic-reviewer` · `security-auditor`**
450
406
 
451
407
  ### ❌ Forbidden AI Tropes
452
-
453
408
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
454
409
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
455
410
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
456
411
 
457
412
  ### ✅ Pre-Flight Self-Audit
458
-
459
- Review these questions before confirming output:
460
-
461
413
  ```
462
414
  ✅ Did I rely ONLY on real, verified tools and methods?
463
415
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -466,8 +418,6 @@ Review these questions before confirming output:
466
418
  ```
467
419
 
468
420
  ### 🛑 Verification-Before-Completion (VBC) Protocol
469
-
470
421
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
471
-
472
422
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
473
423
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: web-accessibility-auditor
3
3
  description: Web Accessibility (a11y) mastery. WCAG 2.2 AA standards, semantic HTML, ARIA attributes, keyboard navigation, focus management, screen reader compatibility, color contrast, and dynamic content announcements. Use when building UI components or auditing frontend code for accessibility compliance.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - fixing-accessibility
9
9
  - audit-and-fix
@@ -25,6 +25,12 @@ Before auditing accessibility or building UI components, you MUST inspect:
25
25
  2. Keyboard Focus Visibility (Section 61) → Preserve `:focus-visible` outlines; ban global outline removal (`*:focus { outline: none; }`)
26
26
  3. Explicit Form Label Linking (Section 129) → Explicitly link inputs to `<label>` via `id`/`for` attributes; ban using `placeholder` as a label replacement
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Web Accessibility (a11y) mastery. WCAG 2.2 AA standards, semantic HTML, ARIA attributes, keyboard navigation, focus management, screen reader compatibility, color contrast, and dynamic content announcements. Use when building UI components or auditing frontend code for accessibility compliance..
32
+ - **DO NOT activate when:** The task falls strictly outside web-accessibility-auditor domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Adding `role='button'` to a `<div>` instead of using `<button>` -> ✅ Native HTML elements have built-in keyboard and screen reader support
@@ -34,8 +40,6 @@ Before auditing accessibility or building UI components, you MUST inspect:
34
40
 
35
41
  ---
36
42
 
37
- # Web Accessibility (a11y) — Inclusive UI Mastery
38
-
39
43
  ---
40
44
 
41
45
  ## 1. Semantic HTML over `<div>` Soup
@@ -198,69 +202,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
198
202
 
199
203
  ---
200
204
 
201
- **Slash command: `/review` or `/tribunal-full`**
202
- **Active reviewers: `logic-reviewer` · `security-auditor`**
203
-
204
- ### ❌ Forbidden AI Tropes
205
-
206
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
207
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
208
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
209
-
210
- Review these questions before confirming output:
211
-
212
- ```
213
- ✅ Did I rely ONLY on real, verified tools and methods?
214
- ✅ Is this solution appropriately scoped to the user's constraints?
215
- ✅ Did I handle potential failure modes and edge cases?
216
- ✅ Have I avoided generic boilerplate that doesn't add value?
217
- ```
218
-
219
- ### 🛑 Verification-Before-Completion (VBC) Protocol
220
-
221
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
222
-
223
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
224
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
225
-
226
- ## Pre-Flight Checklist
227
-
228
- - [ ] Have I reviewed the user's specific constraints and requests?
229
- - [ ] Have I checked the environment for relevant existing implementations?
230
-
231
- ## VBC Protocol (Verification-Before-Completion)
232
-
233
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
234
-
235
- ---
236
-
237
- ## 🤖 LLM-Specific Traps
238
-
239
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
240
-
241
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
242
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
243
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
244
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
245
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
246
-
247
- ---
248
-
249
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
205
+ ## 🏛️ Tribunal Verification & Guardrails
250
206
 
251
207
  **Slash command: `/review` or `/tribunal-full`**
252
208
  **Active reviewers: `logic-reviewer` · `security-auditor`**
253
209
 
254
210
  ### ❌ Forbidden AI Tropes
255
-
256
211
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
257
212
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
258
213
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
259
214
 
260
215
  ### ✅ Pre-Flight Self-Audit
261
-
262
- Review these questions before confirming output:
263
-
264
216
  ```
265
217
  ✅ Did I rely ONLY on real, verified tools and methods?
266
218
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -269,8 +221,6 @@ Review these questions before confirming output:
269
221
  ```
270
222
 
271
223
  ### 🛑 Verification-Before-Completion (VBC) Protocol
272
-
273
224
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
274
-
275
225
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
276
226
  - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: web-design-guidelines
3
3
  description: Enforces next-generation web interface guidelines, covering APCA contrast thresholds, Core Web Vitals, and sustainable battery-efficient UI rendering.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - baseline-ui
8
8
  - better-colors
@@ -27,6 +27,12 @@ Before enforcing web design guidelines or reviewing UI code, you MUST inspect:
27
27
 
28
28
  This skill defines performance, accessibility, and rendering efficiency guidelines.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Enforces next-generation web interface guidelines, covering APCA contrast thresholds, Core Web Vitals, and sustainable battery-efficient UI rendering..
34
+ - **DO NOT activate when:** The task falls strictly outside web-design-guidelines domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 1. APCA Contrast Guidelines (WCAG 3.0 Base)
@@ -56,11 +62,25 @@ APCA calculates lightness contrast mathematically based on font size and backgro
56
62
 
57
63
  ---
58
64
 
59
- ## Pre-Flight Checklist
65
+ ## 🏛️ Tribunal Verification & Guardrails
66
+
67
+ **Slash command: `/review` or `/tribunal-full`**
68
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
60
69
 
61
- - [ ] Have I reviewed the user's specific constraints and requests?
62
- - [ ] Have I checked the environment for relevant existing implementations?
70
+ ### Forbidden AI Tropes
71
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
72
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
73
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
63
74
 
64
- ## VBC Protocol (Verification-Before-Completion)
75
+ ### Pre-Flight Self-Audit
76
+ ```
77
+ ✅ Did I rely ONLY on real, verified tools and methods?
78
+ ✅ Is this solution appropriately scoped to the user's constraints?
79
+ ✅ Did I handle potential failure modes and edge cases?
80
+ ✅ Have I avoided generic boilerplate that doesn't add value?
81
+ ```
65
82
 
66
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
83
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
84
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
85
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
86
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.