tribunal-kit 4.2.0 โ†’ 4.3.1

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 (186) hide show
  1. package/.agent/ARCHITECTURE.md +21 -14
  2. package/.agent/agents/swarm-worker-contracts.md +5 -5
  3. package/.agent/agents/ui-ux-auditor.md +292 -0
  4. package/.agent/rules/GEMINI.md +8 -8
  5. package/.agent/scripts/__pycache__/_colors.cpython-311.pyc +0 -0
  6. package/.agent/scripts/__pycache__/_utils.cpython-311.pyc +0 -0
  7. package/.agent/scripts/__pycache__/case_law_manager.cpython-311.pyc +0 -0
  8. package/.agent/scripts/_colors.js +18 -0
  9. package/.agent/scripts/_utils.js +42 -0
  10. package/.agent/scripts/auto_preview.js +197 -0
  11. package/.agent/scripts/bundle_analyzer.js +290 -0
  12. package/.agent/scripts/case_law_manager.js +684 -0
  13. package/.agent/scripts/checklist.js +266 -0
  14. package/.agent/scripts/colors.js +17 -0
  15. package/.agent/scripts/compress_skills.js +141 -0
  16. package/.agent/scripts/consolidate_skills.js +149 -0
  17. package/.agent/scripts/context_broker.js +609 -0
  18. package/.agent/scripts/deep_compress.js +150 -0
  19. package/.agent/scripts/dependency_analyzer.js +272 -0
  20. package/.agent/scripts/graph_builder.js +199 -0
  21. package/.agent/scripts/graph_zoom.js +154 -0
  22. package/.agent/scripts/inner_loop_validator.js +465 -0
  23. package/.agent/scripts/lint_runner.js +187 -0
  24. package/.agent/scripts/minify_context.js +100 -0
  25. package/.agent/scripts/patch_skills_meta.js +156 -0
  26. package/.agent/scripts/patch_skills_output.js +244 -0
  27. package/.agent/scripts/schema_validator.js +297 -0
  28. package/.agent/scripts/security_scan.js +303 -0
  29. package/.agent/scripts/session_manager.js +276 -0
  30. package/.agent/scripts/skill_evolution.js +644 -0
  31. package/.agent/scripts/skill_integrator.js +313 -0
  32. package/.agent/scripts/strengthen_skills.js +193 -0
  33. package/.agent/scripts/strip_tribunal.js +47 -0
  34. package/.agent/scripts/swarm_dispatcher.js +360 -0
  35. package/.agent/scripts/test_runner.js +193 -0
  36. package/.agent/scripts/utils.js +32 -0
  37. package/.agent/scripts/verify_all.js +256 -0
  38. package/.agent/skills/agent-organizer/SKILL.md +12 -4
  39. package/.agent/skills/agentic-patterns/SKILL.md +12 -4
  40. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +12 -4
  41. package/.agent/skills/api-patterns/SKILL.md +209 -201
  42. package/.agent/skills/api-security-auditor/SKILL.md +12 -4
  43. package/.agent/skills/app-builder/SKILL.md +12 -4
  44. package/.agent/skills/app-builder/templates/SKILL.md +76 -68
  45. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +1 -1
  46. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +1 -1
  47. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +1 -1
  48. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +1 -1
  49. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +1 -1
  50. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +1 -1
  51. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +1 -1
  52. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +1 -1
  53. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +1 -1
  54. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +1 -1
  55. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +1 -1
  56. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +1 -1
  57. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +1 -1
  58. package/.agent/skills/appflow-wireframe/SKILL.md +12 -4
  59. package/.agent/skills/architecture/SKILL.md +12 -4
  60. package/.agent/skills/authentication-best-practices/SKILL.md +12 -4
  61. package/.agent/skills/bash-linux/SKILL.md +12 -4
  62. package/.agent/skills/behavioral-modes/SKILL.md +12 -4
  63. package/.agent/skills/brainstorming/SKILL.md +12 -4
  64. package/.agent/skills/building-native-ui/SKILL.md +12 -4
  65. package/.agent/skills/clean-code/SKILL.md +12 -4
  66. package/.agent/skills/code-review-checklist/SKILL.md +12 -4
  67. package/.agent/skills/config-validator/SKILL.md +12 -4
  68. package/.agent/skills/csharp-developer/SKILL.md +12 -4
  69. package/.agent/skills/data-validation-schemas/SKILL.md +290 -282
  70. package/.agent/skills/database-design/SKILL.md +202 -194
  71. package/.agent/skills/deployment-procedures/SKILL.md +12 -4
  72. package/.agent/skills/devops-engineer/SKILL.md +12 -4
  73. package/.agent/skills/devops-incident-responder/SKILL.md +12 -4
  74. package/.agent/skills/doc.md +1 -1
  75. package/.agent/skills/documentation-templates/SKILL.md +12 -4
  76. package/.agent/skills/edge-computing/SKILL.md +12 -4
  77. package/.agent/skills/error-resilience/SKILL.md +390 -382
  78. package/.agent/skills/extract-design-system/SKILL.md +12 -4
  79. package/.agent/skills/framer-motion-expert/SKILL.md +206 -199
  80. package/.agent/skills/frontend-design/SKILL.md +163 -155
  81. package/.agent/skills/game-design-expert/SKILL.md +12 -4
  82. package/.agent/skills/game-engineering-expert/SKILL.md +12 -4
  83. package/.agent/skills/geo-fundamentals/SKILL.md +12 -4
  84. package/.agent/skills/github-operations/SKILL.md +12 -4
  85. package/.agent/skills/gsap-core/SKILL.md +54 -48
  86. package/.agent/skills/gsap-frameworks/SKILL.md +54 -48
  87. package/.agent/skills/gsap-performance/SKILL.md +54 -48
  88. package/.agent/skills/gsap-plugins/SKILL.md +54 -48
  89. package/.agent/skills/gsap-react/SKILL.md +54 -48
  90. package/.agent/skills/gsap-scrolltrigger/SKILL.md +54 -48
  91. package/.agent/skills/gsap-timeline/SKILL.md +54 -48
  92. package/.agent/skills/gsap-utils/SKILL.md +54 -48
  93. package/.agent/skills/i18n-localization/SKILL.md +12 -4
  94. package/.agent/skills/intelligent-routing/SKILL.md +41 -33
  95. package/.agent/skills/knowledge-graph/SKILL.md +36 -0
  96. package/.agent/skills/lint-and-validate/SKILL.md +12 -4
  97. package/.agent/skills/llm-engineering/SKILL.md +12 -4
  98. package/.agent/skills/local-first/SKILL.md +12 -4
  99. package/.agent/skills/mcp-builder/SKILL.md +12 -4
  100. package/.agent/skills/mobile-design/SKILL.md +225 -217
  101. package/.agent/skills/monorepo-management/SKILL.md +296 -288
  102. package/.agent/skills/motion-engineering/SKILL.md +195 -187
  103. package/.agent/skills/nextjs-react-expert/SKILL.md +196 -188
  104. package/.agent/skills/nodejs-best-practices/SKILL.md +12 -4
  105. package/.agent/skills/observability/SKILL.md +12 -4
  106. package/.agent/skills/parallel-agents/SKILL.md +12 -4
  107. package/.agent/skills/performance-profiling/SKILL.md +12 -4
  108. package/.agent/skills/plan-writing/SKILL.md +12 -4
  109. package/.agent/skills/platform-engineer/SKILL.md +12 -4
  110. package/.agent/skills/playwright-best-practices/SKILL.md +12 -4
  111. package/.agent/skills/powershell-windows/SKILL.md +12 -4
  112. package/.agent/skills/project-idioms/SKILL.md +12 -4
  113. package/.agent/skills/python-patterns/SKILL.md +12 -4
  114. package/.agent/skills/python-pro/SKILL.md +285 -277
  115. package/.agent/skills/react-specialist/SKILL.md +239 -231
  116. package/.agent/skills/readme-builder/SKILL.md +12 -4
  117. package/.agent/skills/realtime-patterns/SKILL.md +12 -4
  118. package/.agent/skills/red-team-tactics/SKILL.md +12 -4
  119. package/.agent/skills/rust-pro/SKILL.md +12 -4
  120. package/.agent/skills/seo-fundamentals/SKILL.md +12 -4
  121. package/.agent/skills/server-management/SKILL.md +12 -4
  122. package/.agent/skills/shadcn-ui-expert/SKILL.md +12 -4
  123. package/.agent/skills/skill-creator/SKILL.md +12 -4
  124. package/.agent/skills/sql-pro/SKILL.md +12 -4
  125. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +12 -4
  126. package/.agent/skills/swiftui-expert/SKILL.md +12 -4
  127. package/.agent/skills/systematic-debugging/SKILL.md +12 -4
  128. package/.agent/skills/tailwind-patterns/SKILL.md +12 -4
  129. package/.agent/skills/tdd-workflow/SKILL.md +12 -4
  130. package/.agent/skills/test-result-analyzer/SKILL.md +12 -4
  131. package/.agent/skills/testing-patterns/SKILL.md +12 -4
  132. package/.agent/skills/trend-researcher/SKILL.md +12 -4
  133. package/.agent/skills/typescript-advanced/SKILL.md +297 -289
  134. package/.agent/skills/ui-ux-pro-max/SKILL.md +12 -4
  135. package/.agent/skills/ui-ux-researcher/SKILL.md +12 -4
  136. package/.agent/skills/vue-expert/SKILL.md +237 -229
  137. package/.agent/skills/vulnerability-scanner/SKILL.md +12 -4
  138. package/.agent/skills/web-accessibility-auditor/SKILL.md +12 -4
  139. package/.agent/skills/web-design-guidelines/SKILL.md +12 -4
  140. package/.agent/skills/webapp-testing/SKILL.md +12 -4
  141. package/.agent/skills/whimsy-injector/SKILL.md +12 -4
  142. package/.agent/skills/workflow-optimizer/SKILL.md +12 -4
  143. package/.agent/workflows/audit.md +6 -6
  144. package/.agent/workflows/deploy.md +1 -1
  145. package/.agent/workflows/generate.md +23 -6
  146. package/.agent/workflows/session.md +5 -5
  147. package/.agent/workflows/swarm.md +2 -2
  148. package/README.md +242 -186
  149. package/bin/tribunal-kit.js +297 -57
  150. package/package.json +81 -77
  151. package/scripts/changelog.js +167 -0
  152. package/scripts/sync-version.js +81 -0
  153. package/scripts/validate-payload.js +73 -0
  154. package/.agent/scripts/__pycache__/auto_preview.cpython-311.pyc +0 -0
  155. package/.agent/scripts/__pycache__/bundle_analyzer.cpython-311.pyc +0 -0
  156. package/.agent/scripts/__pycache__/checklist.cpython-311.pyc +0 -0
  157. package/.agent/scripts/__pycache__/dependency_analyzer.cpython-311.pyc +0 -0
  158. package/.agent/scripts/__pycache__/security_scan.cpython-311.pyc +0 -0
  159. package/.agent/scripts/__pycache__/session_manager.cpython-311.pyc +0 -0
  160. package/.agent/scripts/__pycache__/skill_integrator.cpython-311.pyc +0 -0
  161. package/.agent/scripts/__pycache__/swarm_dispatcher.cpython-311.pyc +0 -0
  162. package/.agent/scripts/__pycache__/test_runner.cpython-311.pyc +0 -0
  163. package/.agent/scripts/__pycache__/verify_all.cpython-311.pyc +0 -0
  164. package/.agent/scripts/auto_preview.py +0 -180
  165. package/.agent/scripts/bundle_analyzer.py +0 -259
  166. package/.agent/scripts/case_law_manager.py +0 -755
  167. package/.agent/scripts/checklist.py +0 -209
  168. package/.agent/scripts/compress_skills.py +0 -167
  169. package/.agent/scripts/consolidate_skills.py +0 -173
  170. package/.agent/scripts/deep_compress.py +0 -202
  171. package/.agent/scripts/dependency_analyzer.py +0 -247
  172. package/.agent/scripts/lint_runner.py +0 -188
  173. package/.agent/scripts/minify_context.py +0 -80
  174. package/.agent/scripts/patch_skills_meta.py +0 -177
  175. package/.agent/scripts/patch_skills_output.py +0 -285
  176. package/.agent/scripts/schema_validator.py +0 -279
  177. package/.agent/scripts/security_scan.py +0 -224
  178. package/.agent/scripts/session_manager.py +0 -261
  179. package/.agent/scripts/skill_evolution.py +0 -563
  180. package/.agent/scripts/skill_integrator.py +0 -234
  181. package/.agent/scripts/strengthen_skills.py +0 -220
  182. package/.agent/scripts/strip_tribunal.py +0 -41
  183. package/.agent/scripts/swarm_dispatcher.py +0 -350
  184. package/.agent/scripts/test_runner.py +0 -192
  185. package/.agent/scripts/test_swarm_dispatcher.py +0 -163
  186. package/.agent/scripts/verify_all.py +0 -195
@@ -151,51 +151,57 @@ Do not create GSAP animations in the componentโ€™s setup or in a synchronous top
151
151
  ### Learn More
152
152
 
153
153
  - **gsap-react** skill for React-specific patterns (useGSAP, contextSafe).
154
-
155
- ---
156
-
157
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
158
-
159
- **Slash command: `/review` or `/tribunal-full`**
160
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
161
-
162
- ### โŒ Forbidden AI Tropes
163
-
164
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
165
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
166
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
167
-
168
- ---
169
-
170
- ## ๐Ÿšจ LLM Trap Table
171
-
172
- |Pattern|What AI Does Wrong|What Is Actually Correct|
173
- |:---|:---|:---|
174
- |gsap-frameworks|gsap.to() before onMounted/onMount|DOM must exist before GSAP grabs it. Wait for lifecycle hook|
175
- |gsap-frameworks|Global selection string (".item")|Use scoped context: gsap.context(() => {}, containerRef)|
176
- |gsap-frameworks|Forgetting to cleanup on unmount|ctx.revert() inside onUnmounted (Vue) or returned cleanup fn (Svelte)|
177
-
178
- ---
179
-
180
- ## โœ… Pre-Flight Self-Audit
181
-
182
- Before producing any output, verify:
183
- ```
184
- โœ… Did I read the actual files before making claims about them?
185
- โœ… Did I verify all method names against official GSAP documentation?
186
- โœ… Did I add // VERIFY: on any uncertain API calls?
187
- โœ… Are all imports from packages that actually exist in package.json?
188
- โœ… Did I test my logic with edge cases (null, empty, 0, max)?
189
- โœ… Did I avoid generating code for more than one module at a time?
190
- โœ… Am I working from evidence, not assumption?
191
- ```
192
-
193
- ---
194
-
195
- ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
196
-
197
- ```
198
- VERIFY: Read the actual codebase before writing anything
199
- BUILD: Generate the smallest meaningful unit of code
200
- CONFIRM: Verify the output is correct before presenting
201
- ```
154
+
155
+ ---
156
+
157
+ **Slash command: `/review` or `/tribunal-full`**
158
+ **Active reviewers: `logic-reviewer` ยท `security-auditor`**
159
+
160
+ ### โŒ Forbidden AI Tropes
161
+
162
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
163
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
164
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
165
+
166
+ ---
167
+
168
+ ## ๐Ÿšจ LLM Trap Table
169
+
170
+ |Pattern|What AI Does Wrong|What Is Actually Correct|
171
+ |:---|:---|:---|
172
+ |gsap-frameworks|gsap.to() before onMounted/onMount|DOM must exist before GSAP grabs it. Wait for lifecycle hook|
173
+ |gsap-frameworks|Global selection string (".item")|Use scoped context: gsap.context(() => {}, containerRef)|
174
+ |gsap-frameworks|Forgetting to cleanup on unmount|ctx.revert() inside onUnmounted (Vue) or returned cleanup fn (Svelte)|
175
+
176
+ ---
177
+
178
+ ## โœ… Pre-Flight Self-Audit
179
+
180
+ Before producing any output, verify:
181
+ ```
182
+ โœ… Did I read the actual files before making claims about them?
183
+ โœ… Did I verify all method names against official GSAP documentation?
184
+ โœ… Did I add // VERIFY: on any uncertain API calls?
185
+ โœ… Are all imports from packages that actually exist in package.json?
186
+ โœ… Did I test my logic with edge cases (null, empty, 0, max)?
187
+ โœ… Did I avoid generating code for more than one module at a time?
188
+ โœ… Am I working from evidence, not assumption?
189
+ ```
190
+
191
+ ---
192
+
193
+ ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
194
+
195
+ ```
196
+ VERIFY: Read the actual codebase before writing anything
197
+ BUILD: Generate the smallest meaningful unit of code
198
+ CONFIRM: Verify the output is correct before presenting
199
+ ```
200
+
201
+
202
+ ## Pre-Flight Checklist
203
+ - [ ] Have I reviewed the user's specific constraints and requests?
204
+ - [ ] Have I checked the environment for relevant existing implementations?
205
+
206
+ ## VBC Protocol (Verification-Before-Completion)
207
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
@@ -77,51 +77,57 @@ document.querySelector("#container").addEventListener("mousemove", (e) => {
77
77
  - โŒ Set **will-change** or **force3D** on every element โ€œjust in caseโ€; use for elements that are actually animating.
78
78
  - โŒ Create hundreds of overlapping tweens or ScrollTriggers without testing on low-end devices.
79
79
  - โŒ Ignore cleanup; stray tweens and ScrollTriggers keep running and can hurt performance and correctness.
80
-
81
- ---
82
-
83
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
84
-
85
- **Slash command: `/review` or `/tribunal-full`**
86
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
87
-
88
- ### โŒ Forbidden AI Tropes
89
-
90
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
91
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
92
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
93
-
94
- ---
95
-
96
- ## ๐Ÿšจ LLM Trap Table
97
-
98
- |Pattern|What AI Does Wrong|What Is Actually Correct|
99
- |:---|:---|:---|
100
- |gsap-performance|Layout caching issues|Call ScrollTrigger.refresh() on height/layout changes|
101
- |gsap-performance|Multiple separate tweens with delay|Use a single tween with stagger: 0.1|
102
- |gsap-performance|will-change on everything|Use sparingly, or let GSAP handle it via willChange: "transform" option|
103
-
104
- ---
105
-
106
- ## โœ… Pre-Flight Self-Audit
107
-
108
- Before producing any output, verify:
109
- ```
110
- โœ… Did I read the actual files before making claims about them?
111
- โœ… Did I verify all method names against official GSAP documentation?
112
- โœ… Did I add // VERIFY: on any uncertain API calls?
113
- โœ… Are all imports from packages that actually exist in package.json?
114
- โœ… Did I test my logic with edge cases (null, empty, 0, max)?
115
- โœ… Did I avoid generating code for more than one module at a time?
116
- โœ… Am I working from evidence, not assumption?
117
- ```
118
-
119
- ---
120
-
121
- ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
122
-
123
- ```
124
- VERIFY: Read the actual codebase before writing anything
125
- BUILD: Generate the smallest meaningful unit of code
126
- CONFIRM: Verify the output is correct before presenting
127
- ```
80
+
81
+ ---
82
+
83
+ **Slash command: `/review` or `/tribunal-full`**
84
+ **Active reviewers: `logic-reviewer` ยท `security-auditor`**
85
+
86
+ ### โŒ Forbidden AI Tropes
87
+
88
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
89
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
90
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
91
+
92
+ ---
93
+
94
+ ## ๐Ÿšจ LLM Trap Table
95
+
96
+ |Pattern|What AI Does Wrong|What Is Actually Correct|
97
+ |:---|:---|:---|
98
+ |gsap-performance|Layout caching issues|Call ScrollTrigger.refresh() on height/layout changes|
99
+ |gsap-performance|Multiple separate tweens with delay|Use a single tween with stagger: 0.1|
100
+ |gsap-performance|will-change on everything|Use sparingly, or let GSAP handle it via willChange: "transform" option|
101
+
102
+ ---
103
+
104
+ ## โœ… Pre-Flight Self-Audit
105
+
106
+ Before producing any output, verify:
107
+ ```
108
+ โœ… Did I read the actual files before making claims about them?
109
+ โœ… Did I verify all method names against official GSAP documentation?
110
+ โœ… Did I add // VERIFY: on any uncertain API calls?
111
+ โœ… Are all imports from packages that actually exist in package.json?
112
+ โœ… Did I test my logic with edge cases (null, empty, 0, max)?
113
+ โœ… Did I avoid generating code for more than one module at a time?
114
+ โœ… Am I working from evidence, not assumption?
115
+ ```
116
+
117
+ ---
118
+
119
+ ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
120
+
121
+ ```
122
+ VERIFY: Read the actual codebase before writing anything
123
+ BUILD: Generate the smallest meaningful unit of code
124
+ CONFIRM: Verify the output is correct before presenting
125
+ ```
126
+
127
+
128
+ ## Pre-Flight Checklist
129
+ - [ ] Have I reviewed the user's specific constraints and requests?
130
+ - [ ] Have I checked the environment for relevant existing implementations?
131
+
132
+ ## VBC Protocol (Verification-Before-Completion)
133
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
@@ -424,51 +424,57 @@ gsap.to(sprite, { pixi: { x: 200, y: 100, scale: 1.5 }, duration: 1 });
424
424
  ### Learn More
425
425
 
426
426
  https://gsap.com/docs/v3/Plugins/
427
-
428
- ---
429
-
430
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
431
-
432
- **Slash command: `/review` or `/tribunal-full`**
433
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
434
-
435
- ### โŒ Forbidden AI Tropes
436
-
437
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
438
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
439
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
440
-
441
- ---
442
-
443
- ## ๐Ÿšจ LLM Trap Table
444
-
445
- |Pattern|What AI Does Wrong|What Is Actually Correct|
446
- |:---|:---|:---|
447
- |gsap-plugins|Using premium plugins without club membership|MorphSVG, SplitText, ScrollSmoother require Club GSAP|
448
- |gsap-plugins|Forgetting gsap.registerPlugin(Plugin)|Register EVERY plugin before its first use|
449
- |gsap-plugins|SplitText hurting SEO|Always call .revert() after animating SplitText to restore DOM structure|
450
-
451
- ---
452
-
453
- ## โœ… Pre-Flight Self-Audit
454
-
455
- Before producing any output, verify:
456
- ```
457
- โœ… Did I read the actual files before making claims about them?
458
- โœ… Did I verify all method names against official GSAP documentation?
459
- โœ… Did I add // VERIFY: on any uncertain API calls?
460
- โœ… Are all imports from packages that actually exist in package.json?
461
- โœ… Did I test my logic with edge cases (null, empty, 0, max)?
462
- โœ… Did I avoid generating code for more than one module at a time?
463
- โœ… Am I working from evidence, not assumption?
464
- ```
465
-
466
- ---
467
-
468
- ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
469
-
470
- ```
471
- VERIFY: Read the actual codebase before writing anything
472
- BUILD: Generate the smallest meaningful unit of code
473
- CONFIRM: Verify the output is correct before presenting
474
- ```
427
+
428
+ ---
429
+
430
+ **Slash command: `/review` or `/tribunal-full`**
431
+ **Active reviewers: `logic-reviewer` ยท `security-auditor`**
432
+
433
+ ### โŒ Forbidden AI Tropes
434
+
435
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
436
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
437
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
438
+
439
+ ---
440
+
441
+ ## ๐Ÿšจ LLM Trap Table
442
+
443
+ |Pattern|What AI Does Wrong|What Is Actually Correct|
444
+ |:---|:---|:---|
445
+ |gsap-plugins|Using premium plugins without club membership|MorphSVG, SplitText, ScrollSmoother require Club GSAP|
446
+ |gsap-plugins|Forgetting gsap.registerPlugin(Plugin)|Register EVERY plugin before its first use|
447
+ |gsap-plugins|SplitText hurting SEO|Always call .revert() after animating SplitText to restore DOM structure|
448
+
449
+ ---
450
+
451
+ ## โœ… Pre-Flight Self-Audit
452
+
453
+ Before producing any output, verify:
454
+ ```
455
+ โœ… Did I read the actual files before making claims about them?
456
+ โœ… Did I verify all method names against official GSAP documentation?
457
+ โœ… Did I add // VERIFY: on any uncertain API calls?
458
+ โœ… Are all imports from packages that actually exist in package.json?
459
+ โœ… Did I test my logic with edge cases (null, empty, 0, max)?
460
+ โœ… Did I avoid generating code for more than one module at a time?
461
+ โœ… Am I working from evidence, not assumption?
462
+ ```
463
+
464
+ ---
465
+
466
+ ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
467
+
468
+ ```
469
+ VERIFY: Read the actual codebase before writing anything
470
+ BUILD: Generate the smallest meaningful unit of code
471
+ CONFIRM: Verify the output is correct before presenting
472
+ ```
473
+
474
+
475
+ ## Pre-Flight Checklist
476
+ - [ ] Have I reviewed the user's specific constraints and requests?
477
+ - [ ] Have I checked the environment for relevant existing implementations?
478
+
479
+ ## VBC Protocol (Verification-Before-Completion)
480
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
@@ -133,51 +133,57 @@ GSAP runs in the browser. Do not call gsap or ScrollTrigger during SSR.
133
133
 
134
134
  ### Learn More
135
135
 
136
- https://gsap.com/resources/React
137
- ---
138
-
139
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
140
-
141
- **Slash command: `/review` or `/tribunal-full`**
142
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
143
-
144
- ### โŒ Forbidden AI Tropes
145
-
146
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
147
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
148
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
149
-
150
- ---
151
-
152
- ## ๐Ÿšจ LLM Trap Table
153
-
154
- |Pattern|What AI Does Wrong|What Is Actually Correct|
155
- |:---|:---|:---|
156
- |gsap-react|useEffect or useLayoutEffect for GSAP|Use useGSAP() Hook from @gsap/react|
157
- |gsap-react|Forgetting dependencies in useGSAP|Explicitly set { dependencies: [reqs] } if you need reactivity|
158
- |gsap-react|gsap.context() inside useGSAP|Unnecessary, useGSAP creates a Context implicitly|
159
-
160
- ---
161
-
162
- ## โœ… Pre-Flight Self-Audit
163
-
164
- Before producing any output, verify:
165
- ```
166
- โœ… Did I read the actual files before making claims about them?
167
- โœ… Did I verify all method names against official GSAP documentation?
168
- โœ… Did I add // VERIFY: on any uncertain API calls?
169
- โœ… Are all imports from packages that actually exist in package.json?
170
- โœ… Did I test my logic with edge cases (null, empty, 0, max)?
171
- โœ… Did I avoid generating code for more than one module at a time?
172
- โœ… Am I working from evidence, not assumption?
173
- ```
174
-
175
- ---
176
-
177
- ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
178
-
179
- ```
180
- VERIFY: Read the actual codebase before writing anything
181
- BUILD: Generate the smallest meaningful unit of code
182
- CONFIRM: Verify the output is correct before presenting
183
- ```
136
+ https://gsap.com/resources/React
137
+ ---
138
+
139
+ **Slash command: `/review` or `/tribunal-full`**
140
+ **Active reviewers: `logic-reviewer` ยท `security-auditor`**
141
+
142
+ ### โŒ Forbidden AI Tropes
143
+
144
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
145
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
146
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
147
+
148
+ ---
149
+
150
+ ## ๐Ÿšจ LLM Trap Table
151
+
152
+ |Pattern|What AI Does Wrong|What Is Actually Correct|
153
+ |:---|:---|:---|
154
+ |gsap-react|useEffect or useLayoutEffect for GSAP|Use useGSAP() Hook from @gsap/react|
155
+ |gsap-react|Forgetting dependencies in useGSAP|Explicitly set { dependencies: [reqs] } if you need reactivity|
156
+ |gsap-react|gsap.context() inside useGSAP|Unnecessary, useGSAP creates a Context implicitly|
157
+
158
+ ---
159
+
160
+ ## โœ… Pre-Flight Self-Audit
161
+
162
+ Before producing any output, verify:
163
+ ```
164
+ โœ… Did I read the actual files before making claims about them?
165
+ โœ… Did I verify all method names against official GSAP documentation?
166
+ โœ… Did I add // VERIFY: on any uncertain API calls?
167
+ โœ… Are all imports from packages that actually exist in package.json?
168
+ โœ… Did I test my logic with edge cases (null, empty, 0, max)?
169
+ โœ… Did I avoid generating code for more than one module at a time?
170
+ โœ… Am I working from evidence, not assumption?
171
+ ```
172
+
173
+ ---
174
+
175
+ ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
176
+
177
+ ```
178
+ VERIFY: Read the actual codebase before writing anything
179
+ BUILD: Generate the smallest meaningful unit of code
180
+ CONFIRM: Verify the output is correct before presenting
181
+ ```
182
+
183
+
184
+ ## Pre-Flight Checklist
185
+ - [ ] Have I reviewed the user's specific constraints and requests?
186
+ - [ ] Have I checked the environment for relevant existing implementations?
187
+
188
+ ## VBC Protocol (Verification-Before-Completion)
189
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
@@ -294,51 +294,57 @@ In React, use the `useGSAP()` hook (@gsap/react NPM package) to ensure proper cl
294
294
 
295
295
  https://gsap.com/docs/v3/Plugins/ScrollTrigger/
296
296
 
297
-
298
- ---
299
-
300
- ## ๐Ÿ›๏ธ Tribunal Integration (Anti-Hallucination)
301
-
302
- **Slash command: `/review` or `/tribunal-full`**
303
- **Active reviewers: `logic-reviewer` ยท `security-auditor`**
304
-
305
- ### โŒ Forbidden AI Tropes
306
-
307
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
308
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
309
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
310
-
311
- ---
312
-
313
- ## ๐Ÿšจ LLM Trap Table
314
-
315
- |Pattern|What AI Does Wrong|What Is Actually Correct|
316
- |:---|:---|:---|
317
- |gsap-scrolltrigger|Forgot gsap.registerPlugin(ScrollTrigger)|MUST register before component mounts / animations run|
318
- |gsap-scrolltrigger|markers: true in production|Debug only โ€” never ship. Use markers: false|
319
- |gsap-scrolltrigger|1 ScrollTrigger per list item|Use ScrollTrigger.batch() for lists to optimize performance|
320
-
321
- ---
322
-
323
- ## โœ… Pre-Flight Self-Audit
324
-
325
- Before producing any output, verify:
326
- ```
327
- โœ… Did I read the actual files before making claims about them?
328
- โœ… Did I verify all method names against official GSAP documentation?
329
- โœ… Did I add // VERIFY: on any uncertain API calls?
330
- โœ… Are all imports from packages that actually exist in package.json?
331
- โœ… Did I test my logic with edge cases (null, empty, 0, max)?
332
- โœ… Did I avoid generating code for more than one module at a time?
333
- โœ… Am I working from evidence, not assumption?
334
- ```
335
-
336
- ---
337
-
338
- ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
339
-
340
- ```
341
- VERIFY: Read the actual codebase before writing anything
342
- BUILD: Generate the smallest meaningful unit of code
343
- CONFIRM: Verify the output is correct before presenting
344
- ```
297
+
298
+ ---
299
+
300
+ **Slash command: `/review` or `/tribunal-full`**
301
+ **Active reviewers: `logic-reviewer` ยท `security-auditor`**
302
+
303
+ ### โŒ Forbidden AI Tropes
304
+
305
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
306
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
307
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
308
+
309
+ ---
310
+
311
+ ## ๐Ÿšจ LLM Trap Table
312
+
313
+ |Pattern|What AI Does Wrong|What Is Actually Correct|
314
+ |:---|:---|:---|
315
+ |gsap-scrolltrigger|Forgot gsap.registerPlugin(ScrollTrigger)|MUST register before component mounts / animations run|
316
+ |gsap-scrolltrigger|markers: true in production|Debug only โ€” never ship. Use markers: false|
317
+ |gsap-scrolltrigger|1 ScrollTrigger per list item|Use ScrollTrigger.batch() for lists to optimize performance|
318
+
319
+ ---
320
+
321
+ ## โœ… Pre-Flight Self-Audit
322
+
323
+ Before producing any output, verify:
324
+ ```
325
+ โœ… Did I read the actual files before making claims about them?
326
+ โœ… Did I verify all method names against official GSAP documentation?
327
+ โœ… Did I add // VERIFY: on any uncertain API calls?
328
+ โœ… Are all imports from packages that actually exist in package.json?
329
+ โœ… Did I test my logic with edge cases (null, empty, 0, max)?
330
+ โœ… Did I avoid generating code for more than one module at a time?
331
+ โœ… Am I working from evidence, not assumption?
332
+ ```
333
+
334
+ ---
335
+
336
+ ## ๐Ÿ” VBC Protocol (Verify โ†’ Build โ†’ Confirm)
337
+
338
+ ```
339
+ VERIFY: Read the actual codebase before writing anything
340
+ BUILD: Generate the smallest meaningful unit of code
341
+ CONFIRM: Verify the output is correct before presenting
342
+ ```
343
+
344
+
345
+ ## Pre-Flight Checklist
346
+ - [ ] Have I reviewed the user's specific constraints and requests?
347
+ - [ ] Have I checked the environment for relevant existing implementations?
348
+
349
+ ## VBC Protocol (Verification-Before-Completion)
350
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.