tribunal-kit 4.3.0 → 4.4.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 (120) hide show
  1. package/.agent/history/architecture-explorer.html +352 -0
  2. package/.agent/history/architecture-graph.yaml +109 -0
  3. package/.agent/history/graph-cache.json +215 -0
  4. package/.agent/history/snapshots/migrate_refs.js.json +11 -0
  5. package/.agent/history/snapshots/scripts__changelog.js.json +12 -0
  6. package/.agent/history/snapshots/scripts__sync-version.js.json +11 -0
  7. package/.agent/history/snapshots/scripts__validate-payload.js.json +11 -0
  8. package/.agent/history/snapshots/test__integration__bridges.test.js.json +13 -0
  9. package/.agent/history/snapshots/test__integration__init.test.js.json +13 -0
  10. package/.agent/history/snapshots/test__integration__routing.test.js.json +11 -0
  11. package/.agent/history/snapshots/test__integration__swarm_dispatcher.test.js.json +13 -0
  12. package/.agent/history/snapshots/test__integration__wave2.test.js.json +13 -0
  13. package/.agent/history/snapshots/test__unit__args.test.js.json +10 -0
  14. package/.agent/history/snapshots/test__unit__case_law_manager.test.js.json +10 -0
  15. package/.agent/history/snapshots/test__unit__copyDir.test.js.json +13 -0
  16. package/.agent/history/snapshots/test__unit__graph_tools.test.js.json +11 -0
  17. package/.agent/history/snapshots/test__unit__selfInstall.test.js.json +13 -0
  18. package/.agent/history/snapshots/test__unit__semver.test.js.json +10 -0
  19. package/.agent/history/snapshots/test__unit__swarm_dispatcher.test.js.json +11 -0
  20. package/.agent/scripts/case_law_manager.js +684 -684
  21. package/.agent/scripts/dependency_analyzer.js +1 -1
  22. package/.agent/scripts/graph_builder.js +311 -0
  23. package/.agent/scripts/graph_visualizer.js +384 -0
  24. package/.agent/scripts/graph_zoom.js +154 -0
  25. package/.agent/scripts/mutation_runner.js +280 -0
  26. package/.agent/skills/agent-organizer/SKILL.md +9 -1
  27. package/.agent/skills/agentic-patterns/SKILL.md +9 -1
  28. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +9 -1
  29. package/.agent/skills/api-patterns/SKILL.md +206 -198
  30. package/.agent/skills/api-security-auditor/SKILL.md +9 -1
  31. package/.agent/skills/app-builder/SKILL.md +9 -1
  32. package/.agent/skills/app-builder/templates/SKILL.md +77 -69
  33. package/.agent/skills/appflow-wireframe/SKILL.md +9 -1
  34. package/.agent/skills/architecture/SKILL.md +9 -1
  35. package/.agent/skills/authentication-best-practices/SKILL.md +9 -1
  36. package/.agent/skills/bash-linux/SKILL.md +9 -1
  37. package/.agent/skills/behavioral-modes/SKILL.md +9 -1
  38. package/.agent/skills/brainstorming/SKILL.md +9 -1
  39. package/.agent/skills/building-native-ui/SKILL.md +9 -1
  40. package/.agent/skills/clean-code/SKILL.md +9 -1
  41. package/.agent/skills/code-review-checklist/SKILL.md +9 -1
  42. package/.agent/skills/config-validator/SKILL.md +9 -1
  43. package/.agent/skills/csharp-developer/SKILL.md +9 -1
  44. package/.agent/skills/data-validation-schemas/SKILL.md +287 -279
  45. package/.agent/skills/database-design/SKILL.md +199 -191
  46. package/.agent/skills/deployment-procedures/SKILL.md +9 -1
  47. package/.agent/skills/devops-engineer/SKILL.md +9 -1
  48. package/.agent/skills/devops-incident-responder/SKILL.md +9 -1
  49. package/.agent/skills/documentation-templates/SKILL.md +9 -1
  50. package/.agent/skills/edge-computing/SKILL.md +9 -1
  51. package/.agent/skills/error-resilience/SKILL.md +387 -379
  52. package/.agent/skills/extract-design-system/SKILL.md +9 -1
  53. package/.agent/skills/framer-motion-expert/SKILL.md +203 -195
  54. package/.agent/skills/frontend-design/SKILL.md +160 -152
  55. package/.agent/skills/game-design-expert/SKILL.md +9 -1
  56. package/.agent/skills/game-engineering-expert/SKILL.md +9 -1
  57. package/.agent/skills/geo-fundamentals/SKILL.md +9 -1
  58. package/.agent/skills/github-operations/SKILL.md +9 -1
  59. package/.agent/skills/gsap-core/SKILL.md +54 -46
  60. package/.agent/skills/gsap-frameworks/SKILL.md +54 -46
  61. package/.agent/skills/gsap-performance/SKILL.md +54 -46
  62. package/.agent/skills/gsap-plugins/SKILL.md +54 -46
  63. package/.agent/skills/gsap-react/SKILL.md +54 -46
  64. package/.agent/skills/gsap-scrolltrigger/SKILL.md +54 -46
  65. package/.agent/skills/gsap-timeline/SKILL.md +54 -46
  66. package/.agent/skills/gsap-utils/SKILL.md +54 -46
  67. package/.agent/skills/i18n-localization/SKILL.md +9 -1
  68. package/.agent/skills/intelligent-routing/SKILL.md +38 -30
  69. package/.agent/skills/knowledge-graph/SKILL.md +52 -0
  70. package/.agent/skills/lint-and-validate/SKILL.md +9 -1
  71. package/.agent/skills/llm-engineering/SKILL.md +9 -1
  72. package/.agent/skills/local-first/SKILL.md +9 -1
  73. package/.agent/skills/mcp-builder/SKILL.md +9 -1
  74. package/.agent/skills/mobile-design/SKILL.md +222 -214
  75. package/.agent/skills/monorepo-management/SKILL.md +293 -285
  76. package/.agent/skills/motion-engineering/SKILL.md +193 -185
  77. package/.agent/skills/nextjs-react-expert/SKILL.md +193 -185
  78. package/.agent/skills/nodejs-best-practices/SKILL.md +9 -1
  79. package/.agent/skills/observability/SKILL.md +9 -1
  80. package/.agent/skills/parallel-agents/SKILL.md +9 -1
  81. package/.agent/skills/performance-profiling/SKILL.md +9 -1
  82. package/.agent/skills/plan-writing/SKILL.md +9 -1
  83. package/.agent/skills/platform-engineer/SKILL.md +9 -1
  84. package/.agent/skills/playwright-best-practices/SKILL.md +9 -1
  85. package/.agent/skills/powershell-windows/SKILL.md +9 -1
  86. package/.agent/skills/project-idioms/SKILL.md +9 -1
  87. package/.agent/skills/python-patterns/SKILL.md +9 -1
  88. package/.agent/skills/python-pro/SKILL.md +282 -274
  89. package/.agent/skills/react-specialist/SKILL.md +236 -228
  90. package/.agent/skills/readme-builder/SKILL.md +9 -1
  91. package/.agent/skills/realtime-patterns/SKILL.md +9 -1
  92. package/.agent/skills/red-team-tactics/SKILL.md +9 -1
  93. package/.agent/skills/rust-pro/SKILL.md +9 -1
  94. package/.agent/skills/seo-fundamentals/SKILL.md +9 -1
  95. package/.agent/skills/server-management/SKILL.md +9 -1
  96. package/.agent/skills/shadcn-ui-expert/SKILL.md +9 -1
  97. package/.agent/skills/skill-creator/SKILL.md +9 -1
  98. package/.agent/skills/sql-pro/SKILL.md +9 -1
  99. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +9 -1
  100. package/.agent/skills/swiftui-expert/SKILL.md +9 -1
  101. package/.agent/skills/systematic-debugging/SKILL.md +9 -1
  102. package/.agent/skills/tailwind-patterns/SKILL.md +9 -1
  103. package/.agent/skills/tdd-workflow/SKILL.md +9 -1
  104. package/.agent/skills/test-result-analyzer/SKILL.md +9 -1
  105. package/.agent/skills/testing-patterns/SKILL.md +28 -3
  106. package/.agent/skills/trend-researcher/SKILL.md +9 -1
  107. package/.agent/skills/typescript-advanced/SKILL.md +294 -286
  108. package/.agent/skills/ui-ux-pro-max/SKILL.md +561 -116
  109. package/.agent/skills/ui-ux-researcher/SKILL.md +9 -1
  110. package/.agent/skills/vue-expert/SKILL.md +234 -226
  111. package/.agent/skills/vulnerability-scanner/SKILL.md +9 -1
  112. package/.agent/skills/web-accessibility-auditor/SKILL.md +9 -1
  113. package/.agent/skills/web-design-guidelines/SKILL.md +9 -1
  114. package/.agent/skills/webapp-testing/SKILL.md +9 -1
  115. package/.agent/skills/whimsy-injector/SKILL.md +9 -1
  116. package/.agent/skills/workflow-optimizer/SKILL.md +9 -1
  117. package/README.md +242 -242
  118. package/bin/tribunal-kit.js +157 -21
  119. package/package.json +81 -80
  120. package/scripts/validate-payload.js +73 -0
@@ -77,49 +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
- **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
- ```
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,49 +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
- **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
- ```
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,49 +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
- **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
- ```
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,49 +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
- **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
- ```
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.
@@ -105,49 +105,57 @@ master.to(".c", { opacity: 0 }, "+=0.2");
105
105
  - ❌ Forget to pass **defaults** (e.g. `defaults: { duration: 0.5, ease: "power2.out" }`) when many child tweens share the same duration or ease.
106
106
  - ❌ Forget that **duration** on the timeline constructor is not the same as tween duration; timeline “duration” is determined by its children.
107
107
  - ❌ Nest animations that contain a ScrollTrigger; ScrollTriggers should only be on top-level Tweens/Timelines.
108
-
109
- ---
110
-
111
- **Slash command: `/review` or `/tribunal-full`**
112
- **Active reviewers: `logic-reviewer` · `security-auditor`**
113
-
114
- ### ❌ Forbidden AI Tropes
115
-
116
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
117
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
118
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
119
-
120
- ---
121
-
122
- ## 🚨 LLM Trap Table
123
-
124
- |Pattern|What AI Does Wrong|What Is Actually Correct|
125
- |:---|:---|:---|
126
- |gsap-timeline|Position parameter as 2nd arg|Position parameter is the 3rd arg: tl.to(el, {x: 100}, "<")|
127
- |gsap-timeline|tl.add(gsap.to(...))|tl.to(...) (just chain the tween directly)|
128
- |gsap-timeline|Hardcoded delays (delay: 1)|Use position parameter (<, >, +=1) for relative timing|
129
-
130
- ---
131
-
132
- ## ✅ Pre-Flight Self-Audit
133
-
134
- Before producing any output, verify:
135
- ```
136
- ✅ Did I read the actual files before making claims about them?
137
- ✅ Did I verify all method names against official GSAP documentation?
138
- ✅ Did I add // VERIFY: on any uncertain API calls?
139
- ✅ Are all imports from packages that actually exist in package.json?
140
- ✅ Did I test my logic with edge cases (null, empty, 0, max)?
141
- ✅ Did I avoid generating code for more than one module at a time?
142
- ✅ Am I working from evidence, not assumption?
143
- ```
144
-
145
- ---
146
-
147
- ## 🔁 VBC Protocol (Verify → Build → Confirm)
148
-
149
- ```
150
- VERIFY: Read the actual codebase before writing anything
151
- BUILD: Generate the smallest meaningful unit of code
152
- CONFIRM: Verify the output is correct before presenting
153
- ```
108
+
109
+ ---
110
+
111
+ **Slash command: `/review` or `/tribunal-full`**
112
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
113
+
114
+ ### ❌ Forbidden AI Tropes
115
+
116
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
117
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
118
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
119
+
120
+ ---
121
+
122
+ ## 🚨 LLM Trap Table
123
+
124
+ |Pattern|What AI Does Wrong|What Is Actually Correct|
125
+ |:---|:---|:---|
126
+ |gsap-timeline|Position parameter as 2nd arg|Position parameter is the 3rd arg: tl.to(el, {x: 100}, "<")|
127
+ |gsap-timeline|tl.add(gsap.to(...))|tl.to(...) (just chain the tween directly)|
128
+ |gsap-timeline|Hardcoded delays (delay: 1)|Use position parameter (<, >, +=1) for relative timing|
129
+
130
+ ---
131
+
132
+ ## ✅ Pre-Flight Self-Audit
133
+
134
+ Before producing any output, verify:
135
+ ```
136
+ ✅ Did I read the actual files before making claims about them?
137
+ ✅ Did I verify all method names against official GSAP documentation?
138
+ ✅ Did I add // VERIFY: on any uncertain API calls?
139
+ ✅ Are all imports from packages that actually exist in package.json?
140
+ ✅ Did I test my logic with edge cases (null, empty, 0, max)?
141
+ ✅ Did I avoid generating code for more than one module at a time?
142
+ ✅ Am I working from evidence, not assumption?
143
+ ```
144
+
145
+ ---
146
+
147
+ ## 🔁 VBC Protocol (Verify → Build → Confirm)
148
+
149
+ ```
150
+ VERIFY: Read the actual codebase before writing anything
151
+ BUILD: Generate the smallest meaningful unit of code
152
+ CONFIRM: Verify the output is correct before presenting
153
+ ```
154
+
155
+
156
+ ## Pre-Flight Checklist
157
+ - [ ] Have I reviewed the user's specific constraints and requests?
158
+ - [ ] Have I checked the environment for relevant existing implementations?
159
+
160
+ ## VBC Protocol (Verification-Before-Completion)
161
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
@@ -282,49 +282,57 @@ wrapY(150); // 50
282
282
  ### Learn More
283
283
 
284
284
  https://gsap.com/docs/v3/HelperFunctions
285
-
286
- ---
287
-
288
- **Slash command: `/review` or `/tribunal-full`**
289
- **Active reviewers: `logic-reviewer` · `security-auditor`**
290
-
291
- ### ❌ Forbidden AI Tropes
292
-
293
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
294
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
295
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
296
-
297
- ---
298
-
299
- ## 🚨 LLM Trap Table
300
-
301
- |Pattern|What AI Does Wrong|What Is Actually Correct|
302
- |:---|:---|:---|
303
- |gsap-utils|Using mapRange on units like "100px"|mapRange works only on pure numbers. Use getUnit/unitize|
304
- |gsap-utils|Re-creating random per frame|Pass true as 4th param: random(-10, 10, 1, true) for a reusable fn|
305
- |gsap-utils|Scoping global .box|Use gsap.utils.selector(container) inside components|
306
-
307
- ---
308
-
309
- ## ✅ Pre-Flight Self-Audit
310
-
311
- Before producing any output, verify:
312
- ```
313
- ✅ Did I read the actual files before making claims about them?
314
- ✅ Did I verify all method names against official GSAP documentation?
315
- ✅ Did I add // VERIFY: on any uncertain API calls?
316
- ✅ Are all imports from packages that actually exist in package.json?
317
- ✅ Did I test my logic with edge cases (null, empty, 0, max)?
318
- ✅ Did I avoid generating code for more than one module at a time?
319
- ✅ Am I working from evidence, not assumption?
320
- ```
321
-
322
- ---
323
-
324
- ## 🔁 VBC Protocol (Verify → Build → Confirm)
325
-
326
- ```
327
- VERIFY: Read the actual codebase before writing anything
328
- BUILD: Generate the smallest meaningful unit of code
329
- CONFIRM: Verify the output is correct before presenting
330
- ```
285
+
286
+ ---
287
+
288
+ **Slash command: `/review` or `/tribunal-full`**
289
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
290
+
291
+ ### ❌ Forbidden AI Tropes
292
+
293
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
294
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
295
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
296
+
297
+ ---
298
+
299
+ ## 🚨 LLM Trap Table
300
+
301
+ |Pattern|What AI Does Wrong|What Is Actually Correct|
302
+ |:---|:---|:---|
303
+ |gsap-utils|Using mapRange on units like "100px"|mapRange works only on pure numbers. Use getUnit/unitize|
304
+ |gsap-utils|Re-creating random per frame|Pass true as 4th param: random(-10, 10, 1, true) for a reusable fn|
305
+ |gsap-utils|Scoping global .box|Use gsap.utils.selector(container) inside components|
306
+
307
+ ---
308
+
309
+ ## ✅ Pre-Flight Self-Audit
310
+
311
+ Before producing any output, verify:
312
+ ```
313
+ ✅ Did I read the actual files before making claims about them?
314
+ ✅ Did I verify all method names against official GSAP documentation?
315
+ ✅ Did I add // VERIFY: on any uncertain API calls?
316
+ ✅ Are all imports from packages that actually exist in package.json?
317
+ ✅ Did I test my logic with edge cases (null, empty, 0, max)?
318
+ ✅ Did I avoid generating code for more than one module at a time?
319
+ ✅ Am I working from evidence, not assumption?
320
+ ```
321
+
322
+ ---
323
+
324
+ ## 🔁 VBC Protocol (Verify → Build → Confirm)
325
+
326
+ ```
327
+ VERIFY: Read the actual codebase before writing anything
328
+ BUILD: Generate the smallest meaningful unit of code
329
+ CONFIRM: Verify the output is correct before presenting
330
+ ```
331
+
332
+
333
+ ## Pre-Flight Checklist
334
+ - [ ] Have I reviewed the user's specific constraints and requests?
335
+ - [ ] Have I checked the environment for relevant existing implementations?
336
+
337
+ ## VBC Protocol (Verification-Before-Completion)
338
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
@@ -152,4 +152,12 @@ Review these questions before confirming output:
152
152
 
153
153
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
154
154
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
155
- - ✅ **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.
155
+ - ✅ **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.
156
+
157
+
158
+ ## Pre-Flight Checklist
159
+ - [ ] Have I reviewed the user's specific constraints and requests?
160
+ - [ ] Have I checked the environment for relevant existing implementations?
161
+
162
+ ## VBC Protocol (Verification-Before-Completion)
163
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.