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
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: audit-and-fix
3
3
  description: Accessibility auditing and remediation workflow combining detection, prioritization, and practical code fixes for WCAG 2.2 AA compliance issues.
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
  - fixing-accessibility
8
8
  - build-primitive
@@ -27,6 +27,12 @@ Before performing accessibility audits or fixes, you MUST inspect:
27
27
 
28
28
  Systematically audit HTML/JSX markup against WCAG 2.2 AA standards, prioritize accessibility violations, and apply verified code fixes.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Accessibility auditing and remediation workflow combining detection, prioritization, and practical code fixes for WCAG 2.2 AA compliance issues..
34
+ - **DO NOT activate when:** The task falls strictly outside audit-and-fix domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 4-Step Remediation Pipeline
@@ -68,28 +74,25 @@ Scan component code for:
68
74
 
69
75
  ---
70
76
 
71
- ## 🤖 LLM-Specific Traps
77
+ ## 🏛️ Tribunal Verification & Guardrails
72
78
 
73
- 1. **Adding Redundant ARIA**: Adding `role="button"` to native `<button>` tags (valid HTML5 buttons don't need redundant roles).
74
- 2. **Deleting Decorative SVGs from Screen Readers**: Forgetting `aria-hidden="true"` on decorative icons inside labeled buttons.
75
-
76
- ---
79
+ **Slash command: `/review` or `/tribunal-full`**
80
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
77
81
 
78
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
79
-
80
- **Active reviewers: `accessibility-reviewer` · `frontend-reviewer`**
82
+ ### Forbidden AI Tropes
83
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
84
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
85
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
81
86
 
82
87
  ### ✅ Pre-Flight Self-Audit
83
-
84
88
  ```
85
- Are all icon-only buttons provided with descriptive `aria-label` attributes?
86
- Are decorative SVG icons hidden from screen readers with `aria-hidden="true"`?
87
- Do custom interactive controls support Enter and Space key triggers?
89
+ Did I rely ONLY on real, verified tools and methods?
90
+ Is this solution appropriately scoped to the user's constraints?
91
+ Did I handle potential failure modes and edge cases?
92
+ ✅ Have I avoided generic boilerplate that doesn't add value?
88
93
  ```
89
94
 
90
95
  ### 🛑 Verification-Before-Completion (VBC) Protocol
91
-
92
96
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
93
-
94
97
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
95
98
  - ✅ **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: authentication-best-practices
3
3
  description: Authentication and Authorization mastery. Best practices for OAuth2, OpenID Connect, JWT (JSON Web Tokens), session management, password hashing, MFA (Multi-Factor Authentication), RBAC/ABAC, SSO, and secure credential storage. Use when auditing or implementing login flows, identity systems, or access control.
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
  - api-security-auditor
@@ -25,7 +25,11 @@ Before implementing authentication or session flows, you MUST inspect:
25
25
  2. Token Storage Separation (Section 83) → Keep short-lived access tokens in JS memory and long-lived refresh tokens in `HttpOnly`, `SameSite=Lax/Strict` cookies
26
26
  3. OAuth PKCE Flow Requirement (Section 109) → Enforce Authorization Code Flow with PKCE for all single-page and mobile apps; ban deprecated Implicit Flow
27
27
 
28
- # Authentication & Authorization — Identity Mastery
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Authentication and Authorization mastery. Best practices for OAuth2, OpenID Connect, JWT (JSON Web Tokens), session management, password hashing, MFA (Multi-Factor Authentication), RBAC/ABAC, SSO, and secure credential storage. Use when auditing or implementing login flows, identity systems, or access control..
32
+ - **DO NOT activate when:** The task falls strictly outside authentication-best-practices domain or belongs to a different dedicated specialist.
29
33
 
30
34
  ---
31
35
 
@@ -176,69 +180,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
176
180
 
177
181
  ---
178
182
 
179
- **Slash command: `/review` or `/tribunal-full`**
180
- **Active reviewers: `logic-reviewer` · `security-auditor`**
181
-
182
- ### ❌ Forbidden AI Tropes
183
-
184
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
185
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
186
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
187
-
188
- Review these questions before confirming output:
189
-
190
- ```
191
- ✅ Did I rely ONLY on real, verified tools and methods?
192
- ✅ Is this solution appropriately scoped to the user's constraints?
193
- ✅ Did I handle potential failure modes and edge cases?
194
- ✅ Have I avoided generic boilerplate that doesn't add value?
195
- ```
196
-
197
- ### 🛑 Verification-Before-Completion (VBC) Protocol
198
-
199
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
200
-
201
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
202
- - ✅ **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.
203
-
204
- ## Pre-Flight Checklist
205
-
206
- - [ ] Have I reviewed the user's specific constraints and requests?
207
- - [ ] Have I checked the environment for relevant existing implementations?
208
-
209
- ## VBC Protocol (Verification-Before-Completion)
210
-
211
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
212
-
213
- ---
214
-
215
- ## 🤖 LLM-Specific Traps
216
-
217
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
218
-
219
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
220
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
221
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
222
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
223
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
224
-
225
- ---
226
-
227
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
183
+ ## 🏛️ Tribunal Verification & Guardrails
228
184
 
229
185
  **Slash command: `/review` or `/tribunal-full`**
230
186
  **Active reviewers: `logic-reviewer` · `security-auditor`**
231
187
 
232
188
  ### ❌ Forbidden AI Tropes
233
-
234
189
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
235
190
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
236
191
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
237
192
 
238
193
  ### ✅ Pre-Flight Self-Audit
239
-
240
- Review these questions before confirming output:
241
-
242
194
  ```
243
195
  ✅ Did I rely ONLY on real, verified tools and methods?
244
196
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -247,8 +199,6 @@ Review these questions before confirming output:
247
199
  ```
248
200
 
249
201
  ### 🛑 Verification-Before-Completion (VBC) Protocol
250
-
251
202
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
252
-
253
203
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
254
204
  - ✅ **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: backend-security-expert
3
3
  description: Backend security auditing for modern server-side architectures. Focuses on Next.js Server Actions, Node.js/Edge APIs, JWT & Session architectures, ORM injection (Prisma/Drizzle), and RBAC implementation.
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
  - frontend-security-expert
9
9
  - api-security-auditor
@@ -21,18 +21,39 @@ scripts-binding:
21
21
 
22
22
  Before auditing or writing backend server code, you MUST inspect:
23
23
 
24
- 1. Server Action Endpoints (Section 26) → Treat Next.js Server Actions as public API routes: authenticate session and parse input with Zod at entry
25
- 2. JWT Algorithm Verification (Section 17)Enforce explicit algorithms (`alg: "HS256"`) when verifying JWT tokens to prevent "None" algorithm exploits
26
- 3. IDOR & RBAC Validation (Section 34) → Verify resource ownership (`WHERE userId = session.userId`) and user roles before executing mutations
24
+ 1. Server Action Public Surface → Treat Next.js Server Actions as public endpoints: authenticate session, rate-limit, and parse input with Zod/Valibot at entry
25
+ 2. Timing Attacks in Auth VerificationUse `crypto.timingSafeEqual()` for API key, hash, or token comparisons; ban bare `===` strings
26
+ 3. IDOR & Tenant Scoping → Verify resource ownership in the query predicate (`WHERE id = $1 AND tenant_id = $session_tenant_id`)
27
+ 4. SSRF Defense on Outbound Requests → Validate user-supplied webhook URLs against internal private IP ranges (127.0.0.1, 10.0.0.0/8, 169.254.169.254)
27
28
 
28
- # Backend Security Expert — Modern Server Architectures
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Auditing server-side security, designing authentication/authorization (JWT, OAuth, Sessions, RBAC), protecting database boundaries, and securing webhooks.
32
+ - **DO NOT activate when:** Writing pure client-side styling, UI animations, or client-side form rendering.
33
+
34
+ ## 2026 Backend Security & Cryptography Invariants
35
+
36
+ 1. **Timing-Safe Equality**:
37
+ ```ts
38
+ import { timingSafeEqual } from 'node:crypto';
39
+ function verifySecret(provided: string, expected: string): boolean {
40
+ const bufA = Buffer.from(provided);
41
+ const bufB = Buffer.from(expected);
42
+ if (bufA.length !== bufB.length) return false;
43
+ return timingSafeEqual(bufA, bufB);
44
+ }
45
+ ```
46
+ 2. **SSRF Guardrails on Webhooks**: Never allow user-submitted URLs to hit AWS/GCP metadata services (`169.254.169.254`) or loopback (`localhost`). Validate IP address after DNS resolution before connecting.
47
+ 3. **Mass Assignment Prevention**: Never pass `req.body` directly into database inserts. Explicitly pick allowed attributes via Zod schemas (`schema.parse(req.body)`).
48
+ 4. **JWT Verification Security**: Always specify `algorithms: ['HS256']` explicitly to prevent the notorious `alg: "none"` vulnerability.
29
49
 
30
50
  ## Hallucination Traps (Read First)
31
51
 
32
- - ❌ Recommending session tokens without algorithm enforcement → ✅ Always verify JWT algorithms (`alg: "HS256"`) to prevent "None" attacks.
33
- - ❌ Treating ORMs as automatically secure → ✅ Prisma and Drizzle can still be vulnerable if raw SQL/queries are dynamically interpolated.
34
- - ❌ Assuming Next.js Server Actions are private APIs → ✅ Server Actions are public endpoints and must be authenticated and rate-limited.
35
- - ❌ Leaving input validation to the controller logic → ✅ Always enforce strict schema boundaries (Zod/Pydantic) before business logic.
52
+ - ❌ Recommending session tokens without algorithm enforcement → ✅ Always verify JWT algorithms (`alg: "HS256"`)
53
+ - ❌ String equality `token === expectedToken` → ✅ Use `crypto.timingSafeEqual` to prevent timing attacks
54
+ - ❌ Treating ORMs as automatically injection-proof → ✅ Prisma and Drizzle are vulnerable if raw SQL is dynamically interpolated
55
+ - ❌ Assuming Next.js Server Actions are private internal functions → ✅ Server Actions are public HTTP endpoints
56
+ - ❌ Fetching user-supplied URLs without private IP filtering → ✅ Block RFC 1918 and link-local ranges to prevent SSRF
36
57
 
37
58
  ---
38
59
 
@@ -73,69 +94,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
73
94
 
74
95
  ---
75
96
 
76
- **Slash command: `/review` or `/tribunal-full`**
77
- **Active reviewers: `logic-reviewer` · `security-auditor`**
78
-
79
- ### ❌ Forbidden AI Tropes
80
-
81
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
82
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
83
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
84
-
85
- Review these questions before confirming output:
86
-
87
- ```
88
- ✅ Did I rely ONLY on real, verified tools and methods?
89
- ✅ Is this solution appropriately scoped to the user's constraints?
90
- ✅ Did I handle potential failure modes and edge cases?
91
- ✅ Have I avoided generic boilerplate that doesn't add value?
92
- ```
93
-
94
- ### 🛑 Verification-Before-Completion (VBC) Protocol
95
-
96
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
97
-
98
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
99
- - ✅ **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.
100
-
101
- ## Pre-Flight Checklist
102
-
103
- - [ ] Have I reviewed the user's specific constraints and requests?
104
- - [ ] Have I checked the environment for relevant existing implementations?
105
-
106
- ## VBC Protocol (Verification-Before-Completion)
107
-
108
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
109
-
110
- ---
111
-
112
- ## 🤖 LLM-Specific Traps
113
-
114
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
115
-
116
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
117
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
118
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
119
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
120
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
121
-
122
- ---
123
-
124
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
97
+ ## 🏛️ Tribunal Verification & Guardrails
125
98
 
126
99
  **Slash command: `/review` or `/tribunal-full`**
127
100
  **Active reviewers: `logic-reviewer` · `security-auditor`**
128
101
 
129
102
  ### ❌ Forbidden AI Tropes
130
-
131
103
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
132
104
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
133
105
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
134
106
 
135
107
  ### ✅ Pre-Flight Self-Audit
136
-
137
- Review these questions before confirming output:
138
-
139
108
  ```
140
109
  ✅ Did I rely ONLY on real, verified tools and methods?
141
110
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -144,8 +113,6 @@ Review these questions before confirming output:
144
113
  ```
145
114
 
146
115
  ### 🛑 Verification-Before-Completion (VBC) Protocol
147
-
148
116
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
149
-
150
117
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
151
118
  - ✅ **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: baseline-ui
3
3
  description: Quickly deslop UI code by fixing spacing, hierarchy, typography, contrast, and small layout issues. Use when the interface needs a fast cleanup or polish pass.
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
  - better-ui
8
8
  - frontend-design
@@ -27,6 +27,12 @@ Before cleaning up UI styles, you MUST inspect:
27
27
 
28
28
  Enforces an opinionated UI baseline to clean up sloppy code and prevent AI-generated interface slop without changing product architecture or feature scope.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Quickly deslop UI code by fixing spacing, hierarchy, typography, contrast, and small layout issues. Use when the interface needs a fast cleanup or polish pass..
34
+ - **DO NOT activate when:** The task falls strictly outside baseline-ui domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 1. Stack & System Constraints
@@ -62,23 +68,25 @@ Enforces an opinionated UI baseline to clean up sloppy code and prevent AI-gener
62
68
 
63
69
  ---
64
70
 
65
- ## 🤖 LLM-Specific Traps
71
+ ## 🏛️ Tribunal Verification & Guardrails
66
72
 
67
- 1. **Re-architecting when asked to deslop**: Modifying component state, context, or props when only CSS/visual cleanup was requested.
68
- 2. **Rebuilding native accessibility by hand**: Writing custom keyboard listener loops instead of using primitives (`Base UI`, `Radix`).
73
+ **Slash command: `/review` or `/tribunal-full`**
74
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
69
75
 
70
- ---
71
-
72
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
76
+ ### ❌ Forbidden AI Tropes
77
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
78
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
79
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
73
80
 
74
81
  ### ✅ Pre-Flight Self-Audit
75
-
76
82
  ```
77
- ✅ Did I retain existing product logic and HTML structure?
78
- Are all spacing values aligned to standard multiples (4/8/12/16/24/32)?
79
- Is text contrast WCAG AA compliant and are icon buttons labeled with aria-label?
83
+ ✅ Did I rely ONLY on real, verified tools and methods?
84
+ Is this solution appropriately scoped to the user's constraints?
85
+ Did I handle potential failure modes and edge cases?
86
+ ✅ Have I avoided generic boilerplate that doesn't add value?
80
87
  ```
81
88
 
82
89
  ### 🛑 Verification-Before-Completion (VBC) Protocol
83
-
84
- Inspect UI layout across desktop and mobile viewports in browser preview to verify visual polish.
90
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
91
+ - **Forbidden:** Declaring a task complete because the output "looks correct."
92
+ - ✅ **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: bash-linux
3
3
  description: Bash/Linux terminal mastery. Shell scripting, piping, stream redirection, process substitution, strict mode (set -euo pipefail), AWK, ripgrep parsing, and robust error handling. Use when writing CI scripts, debugging POSIX environments, or manipulating text pipelines.
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
  - server-management
9
9
  - devops-engineer
@@ -25,6 +25,12 @@ Before writing Bash scripts or terminal automation pipelines, you MUST inspect:
25
25
  2. Variable Quoting Safeguards (Section 122) → Double-quote all path and string variables (`"$FILE"`, `"${FILES[@]}"`) to prevent whitespace expansion bugs
26
26
  3. Modern CLI Efficiency Rules (Section 102) → Prefer `rg` over `grep`, `fd` over `find`, `jq` over regex JSON parsing for performance and safety
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Bash/Linux terminal mastery. Shell scripting, piping, stream redirection, process substitution, strict mode (set -euo pipefail), AWK, ripgrep parsing, and robust error handling. Use when writing CI scripts, debugging POSIX environments, or manipulating text pipelines..
32
+ - **DO NOT activate when:** The task falls strictly outside bash-linux domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Scripts without `set -euo pipefail` -> ✅ Always enable strict mode to catch silent failures
@@ -34,8 +40,6 @@ Before writing Bash scripts or terminal automation pipelines, you MUST inspect:
34
40
 
35
41
  ---
36
42
 
37
- # Bash & Linux — Shell Scripting Mastery
38
-
39
43
  ---
40
44
 
41
45
  ## 1. Bash Strict Mode (Mandatory)
@@ -158,69 +162,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
158
162
 
159
163
  ---
160
164
 
161
- **Slash command: `/review` or `/tribunal-full`**
162
- **Active reviewers: `logic-reviewer` · `security-auditor`**
163
-
164
- ### ❌ Forbidden AI Tropes
165
-
166
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
167
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
168
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
169
-
170
- Review these questions before confirming output:
171
-
172
- ```
173
- ✅ Did I rely ONLY on real, verified tools and methods?
174
- ✅ Is this solution appropriately scoped to the user's constraints?
175
- ✅ Did I handle potential failure modes and edge cases?
176
- ✅ Have I avoided generic boilerplate that doesn't add value?
177
- ```
178
-
179
- ### 🛑 Verification-Before-Completion (VBC) Protocol
180
-
181
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
182
-
183
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
184
- - ✅ **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.
185
-
186
- ## Pre-Flight Checklist
187
-
188
- - [ ] Have I reviewed the user's specific constraints and requests?
189
- - [ ] Have I checked the environment for relevant existing implementations?
190
-
191
- ## VBC Protocol (Verification-Before-Completion)
192
-
193
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
194
-
195
- ---
196
-
197
- ## 🤖 LLM-Specific Traps
198
-
199
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
200
-
201
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
202
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
203
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
204
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
205
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
206
-
207
- ---
208
-
209
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
165
+ ## 🏛️ Tribunal Verification & Guardrails
210
166
 
211
167
  **Slash command: `/review` or `/tribunal-full`**
212
168
  **Active reviewers: `logic-reviewer` · `security-auditor`**
213
169
 
214
170
  ### ❌ Forbidden AI Tropes
215
-
216
171
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
217
172
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
218
173
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
219
174
 
220
175
  ### ✅ Pre-Flight Self-Audit
221
-
222
- Review these questions before confirming output:
223
-
224
176
  ```
225
177
  ✅ Did I rely ONLY on real, verified tools and methods?
226
178
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -229,8 +181,6 @@ Review these questions before confirming output:
229
181
  ```
230
182
 
231
183
  ### 🛑 Verification-Before-Completion (VBC) Protocol
232
-
233
184
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
234
-
235
185
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
236
186
  - ✅ **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: behavioral-modes
3
3
  description: AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type.
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
  - fabel-protocol
9
9
  - agentic-patterns
@@ -25,6 +25,12 @@ Before selecting an operational mode, you MUST inspect:
25
25
  2. Mode Leakage Mitigation rules (Section 160) → Prevent writing unapproved code during DISCOVER or REVIEW modes
26
26
  3. Output format contracts → Ensure findings use labeled severity tags (CRITICAL / WARNING / SUGGESTION)
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type..
32
+ - **DO NOT activate when:** The task falls strictly outside behavioral-modes domain or belongs to a different dedicated specialist.
33
+
28
34
  ---
29
35
 
30
36
  ## Overview
@@ -216,69 +222,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
216
222
 
217
223
  ---
218
224
 
219
- **Slash command: `/review` or `/tribunal-full`**
220
- **Active reviewers: `logic-reviewer` · `security-auditor`**
221
-
222
- ### ❌ Forbidden AI Tropes
223
-
224
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
225
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
226
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
227
-
228
- Review these questions before confirming output:
229
-
230
- ```
231
- ✅ Did I rely ONLY on real, verified tools and methods?
232
- ✅ Is this solution appropriately scoped to the user's constraints?
233
- ✅ Did I handle potential failure modes and edge cases?
234
- ✅ Have I avoided generic boilerplate that doesn't add value?
235
- ```
236
-
237
- ### 🛑 Verification-Before-Completion (VBC) Protocol
238
-
239
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
240
-
241
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
242
- - ✅ **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.
243
-
244
- ## Pre-Flight Checklist
245
-
246
- - [ ] Have I reviewed the user's specific constraints and requests?
247
- - [ ] Have I checked the environment for relevant existing implementations?
248
-
249
- ## VBC Protocol (Verification-Before-Completion)
250
-
251
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
252
-
253
- ---
254
-
255
- ## 🤖 LLM-Specific Traps
256
-
257
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
258
-
259
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
260
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
261
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
262
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
263
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
264
-
265
- ---
266
-
267
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
225
+ ## 🏛️ Tribunal Verification & Guardrails
268
226
 
269
227
  **Slash command: `/review` or `/tribunal-full`**
270
228
  **Active reviewers: `logic-reviewer` · `security-auditor`**
271
229
 
272
230
  ### ❌ Forbidden AI Tropes
273
-
274
231
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
275
232
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
276
233
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
277
234
 
278
235
  ### ✅ Pre-Flight Self-Audit
279
-
280
- Review these questions before confirming output:
281
-
282
236
  ```
283
237
  ✅ Did I rely ONLY on real, verified tools and methods?
284
238
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -287,8 +241,6 @@ Review these questions before confirming output:
287
241
  ```
288
242
 
289
243
  ### 🛑 Verification-Before-Completion (VBC) Protocol
290
-
291
244
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
292
-
293
245
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
294
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.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: better-colors
3
3
  description: OKLCH color space for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, and theme with Tailwind v4. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, hue drift, chroma, dark mode colors.
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
  - better-ui
8
8
  - baseline-ui
@@ -27,6 +27,12 @@ Before defining color palettes or CSS theme variables, you MUST inspect:
27
27
 
28
28
  Design engineering guidelines for building perceptually uniform, WCAG 2.2 AA compliant, P3-gamut color systems using the modern **OKLCH** color space.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring OKLCH color space for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, and theme with Tailwind v4. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, hue drift, chroma, dark mode colors..
34
+ - **DO NOT activate when:** The task falls strictly outside better-colors domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 1. Why OKLCH Over HSL / RGB
@@ -123,23 +129,25 @@ To achieve 4.5:1 text contrast against a surface:
123
129
 
124
130
  ---
125
131
 
126
- ## 🤖 LLM-Specific Traps
132
+ ## 🏛️ Tribunal Verification & Guardrails
127
133
 
128
- 1. **Using HSL for Dark Mode Inversion**: Inverting `lightness` in HSL causes dramatic hue shifts and contrast failures.
129
- 2. **Exceeding Display P3 Gamut**: Setting Chroma `C > 0.32` without fallback causes clipping or dull rendering on non-P3 displays.
134
+ **Slash command: `/review` or `/tribunal-full`**
135
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
130
136
 
131
- ---
132
-
133
- ## 🏛️ Tribunal Integration (Anti-Hallucination)
137
+ ### ❌ Forbidden AI Tropes
138
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
139
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
140
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
134
141
 
135
142
  ### ✅ Pre-Flight Self-Audit
136
-
137
143
  ```
138
- Are all color custom properties defined using OKLCH?
139
- Does text meet the minimum 4.5:1 WCAG AA contrast ratio?
140
- Are dark mode surfaces subtly tinted rather than pure #000000 black?
144
+ Did I rely ONLY on real, verified tools and methods?
145
+ Is this solution appropriately scoped to the user's constraints?
146
+ Did I handle potential failure modes and edge cases?
147
+ ✅ Have I avoided generic boilerplate that doesn't add value?
141
148
  ```
142
149
 
143
150
  ### 🛑 Verification-Before-Completion (VBC) Protocol
144
-
145
- Inspect colors across light and dark modes in browser preview to verify contrast and visual harmony.
151
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
152
+ - **Forbidden:** Declaring a task complete because the output "looks correct."
153
+ - ✅ **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.