tribunal-kit 4.0.0 → 4.2.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 (108) hide show
  1. package/.agent/GEMINI.md +4 -2
  2. package/.agent/agents/api-architect.md +66 -0
  3. package/.agent/agents/db-latency-auditor.md +216 -0
  4. package/.agent/agents/precedence-reviewer.md +41 -4
  5. package/.agent/agents/resilience-reviewer.md +88 -0
  6. package/.agent/agents/schema-reviewer.md +67 -0
  7. package/.agent/agents/throughput-optimizer.md +299 -0
  8. package/.agent/agents/vitals-reviewer.md +223 -0
  9. package/.agent/history/case-law/cases/case-0001.json +33 -0
  10. package/.agent/history/case-law/index.json +35 -0
  11. package/.agent/rules/GEMINI.md +20 -3
  12. package/.agent/scripts/case_law_manager.py +237 -7
  13. package/.agent/skills/agent-organizer/SKILL.md +42 -0
  14. package/.agent/skills/agentic-patterns/SKILL.md +42 -0
  15. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +42 -0
  16. package/.agent/skills/api-patterns/SKILL.md +42 -0
  17. package/.agent/skills/api-security-auditor/SKILL.md +42 -0
  18. package/.agent/skills/app-builder/SKILL.md +42 -0
  19. package/.agent/skills/app-builder/templates/SKILL.md +70 -0
  20. package/.agent/skills/appflow-wireframe/SKILL.md +42 -0
  21. package/.agent/skills/architecture/SKILL.md +42 -0
  22. package/.agent/skills/authentication-best-practices/SKILL.md +42 -0
  23. package/.agent/skills/bash-linux/SKILL.md +42 -0
  24. package/.agent/skills/behavioral-modes/SKILL.md +42 -0
  25. package/.agent/skills/brainstorming/SKILL.md +42 -0
  26. package/.agent/skills/building-native-ui/SKILL.md +42 -0
  27. package/.agent/skills/clean-code/SKILL.md +42 -0
  28. package/.agent/skills/code-review-checklist/SKILL.md +42 -0
  29. package/.agent/skills/config-validator/SKILL.md +42 -0
  30. package/.agent/skills/csharp-developer/SKILL.md +42 -0
  31. package/.agent/skills/data-validation-schemas/SKILL.md +320 -0
  32. package/.agent/skills/database-design/SKILL.md +42 -0
  33. package/.agent/skills/deployment-procedures/SKILL.md +42 -0
  34. package/.agent/skills/devops-engineer/SKILL.md +42 -0
  35. package/.agent/skills/devops-incident-responder/SKILL.md +42 -0
  36. package/.agent/skills/documentation-templates/SKILL.md +42 -0
  37. package/.agent/skills/edge-computing/SKILL.md +42 -0
  38. package/.agent/skills/error-resilience/SKILL.md +420 -0
  39. package/.agent/skills/extract-design-system/SKILL.md +42 -0
  40. package/.agent/skills/framer-motion-expert/SKILL.md +42 -0
  41. package/.agent/skills/frontend-design/SKILL.md +42 -0
  42. package/.agent/skills/game-design-expert/SKILL.md +42 -0
  43. package/.agent/skills/game-engineering-expert/SKILL.md +42 -0
  44. package/.agent/skills/geo-fundamentals/SKILL.md +42 -0
  45. package/.agent/skills/github-operations/SKILL.md +42 -0
  46. package/.agent/skills/gsap-core/SKILL.md +302 -0
  47. package/.agent/skills/gsap-frameworks/SKILL.md +201 -0
  48. package/.agent/skills/gsap-performance/SKILL.md +127 -0
  49. package/.agent/skills/gsap-plugins/SKILL.md +474 -0
  50. package/.agent/skills/gsap-react/SKILL.md +183 -0
  51. package/.agent/skills/gsap-scrolltrigger/SKILL.md +344 -0
  52. package/.agent/skills/gsap-timeline/SKILL.md +155 -0
  53. package/.agent/skills/gsap-utils/SKILL.md +332 -0
  54. package/.agent/skills/i18n-localization/SKILL.md +42 -0
  55. package/.agent/skills/intelligent-routing/SKILL.md +72 -1
  56. package/.agent/skills/lint-and-validate/SKILL.md +42 -0
  57. package/.agent/skills/llm-engineering/SKILL.md +42 -0
  58. package/.agent/skills/local-first/SKILL.md +42 -0
  59. package/.agent/skills/mcp-builder/SKILL.md +42 -0
  60. package/.agent/skills/mobile-design/SKILL.md +42 -0
  61. package/.agent/skills/monorepo-management/SKILL.md +326 -0
  62. package/.agent/skills/motion-engineering/SKILL.md +42 -0
  63. package/.agent/skills/nextjs-react-expert/SKILL.md +42 -0
  64. package/.agent/skills/nodejs-best-practices/SKILL.md +42 -0
  65. package/.agent/skills/observability/SKILL.md +42 -0
  66. package/.agent/skills/parallel-agents/SKILL.md +42 -0
  67. package/.agent/skills/performance-profiling/SKILL.md +42 -0
  68. package/.agent/skills/plan-writing/SKILL.md +42 -0
  69. package/.agent/skills/platform-engineer/SKILL.md +42 -0
  70. package/.agent/skills/playwright-best-practices/SKILL.md +42 -0
  71. package/.agent/skills/powershell-windows/SKILL.md +42 -0
  72. package/.agent/skills/project-idioms/SKILL.md +42 -0
  73. package/.agent/skills/python-patterns/SKILL.md +42 -0
  74. package/.agent/skills/python-pro/SKILL.md +42 -0
  75. package/.agent/skills/react-specialist/SKILL.md +42 -0
  76. package/.agent/skills/readme-builder/SKILL.md +42 -0
  77. package/.agent/skills/realtime-patterns/SKILL.md +42 -0
  78. package/.agent/skills/red-team-tactics/SKILL.md +42 -0
  79. package/.agent/skills/rust-pro/SKILL.md +42 -0
  80. package/.agent/skills/seo-fundamentals/SKILL.md +42 -0
  81. package/.agent/skills/server-management/SKILL.md +42 -0
  82. package/.agent/skills/shadcn-ui-expert/SKILL.md +42 -0
  83. package/.agent/skills/skill-creator/SKILL.md +42 -0
  84. package/.agent/skills/sql-pro/SKILL.md +42 -0
  85. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +42 -0
  86. package/.agent/skills/swiftui-expert/SKILL.md +42 -0
  87. package/.agent/skills/systematic-debugging/SKILL.md +42 -0
  88. package/.agent/skills/tailwind-patterns/SKILL.md +42 -0
  89. package/.agent/skills/tdd-workflow/SKILL.md +42 -0
  90. package/.agent/skills/test-result-analyzer/SKILL.md +42 -0
  91. package/.agent/skills/testing-patterns/SKILL.md +42 -0
  92. package/.agent/skills/trend-researcher/SKILL.md +42 -0
  93. package/.agent/skills/typescript-advanced/SKILL.md +327 -0
  94. package/.agent/skills/ui-ux-pro-max/SKILL.md +42 -0
  95. package/.agent/skills/ui-ux-researcher/SKILL.md +42 -0
  96. package/.agent/skills/vue-expert/SKILL.md +42 -0
  97. package/.agent/skills/vulnerability-scanner/SKILL.md +42 -0
  98. package/.agent/skills/web-accessibility-auditor/SKILL.md +42 -0
  99. package/.agent/skills/web-design-guidelines/SKILL.md +42 -0
  100. package/.agent/skills/webapp-testing/SKILL.md +42 -0
  101. package/.agent/skills/whimsy-injector/SKILL.md +42 -0
  102. package/.agent/skills/workflow-optimizer/SKILL.md +42 -0
  103. package/.agent/workflows/tribunal-backend.md +13 -2
  104. package/.agent/workflows/tribunal-full.md +15 -8
  105. package/.agent/workflows/tribunal-speed.md +183 -0
  106. package/bin/tribunal-kit.js +17 -10
  107. package/package.json +5 -2
  108. package/.agent/skills/gsap-expert/SKILL.md +0 -194
@@ -621,3 +621,45 @@ let word_counts: HashMap<&str, usize> = words.iter()
621
621
  ```
622
622
 
623
623
 
624
+
625
+
626
+ ---
627
+
628
+ ## 🤖 LLM-Specific Traps
629
+
630
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
631
+
632
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
633
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
634
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
635
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
636
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
637
+
638
+ ---
639
+
640
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
641
+
642
+ **Slash command: `/review` or `/tribunal-full`**
643
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
644
+
645
+ ### ❌ Forbidden AI Tropes
646
+
647
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
648
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
649
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
650
+
651
+ ### ✅ Pre-Flight Self-Audit
652
+
653
+ Review these questions before confirming output:
654
+ ```
655
+ ✅ Did I rely ONLY on real, verified tools and methods?
656
+ ✅ Is this solution appropriately scoped to the user's constraints?
657
+ ✅ Did I handle potential failure modes and edge cases?
658
+ ✅ Have I avoided generic boilerplate that doesn't add value?
659
+ ```
660
+
661
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
662
+
663
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
664
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
665
+ - ✅ **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.
@@ -127,3 +127,45 @@ If a page shouldn't be indexed (e.g., dynamic search result matrices, user profi
127
127
  - **`sitemap.xml`**: A programmatic manifest mapped to root guiding crawlers mathematically through all valid indexable paths.
128
128
 
129
129
  ---
130
+
131
+
132
+ ---
133
+
134
+ ## 🤖 LLM-Specific Traps
135
+
136
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
137
+
138
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
139
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
140
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
141
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
142
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
143
+
144
+ ---
145
+
146
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
147
+
148
+ **Slash command: `/review` or `/tribunal-full`**
149
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
150
+
151
+ ### ❌ Forbidden AI Tropes
152
+
153
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
154
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
155
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
156
+
157
+ ### ✅ Pre-Flight Self-Audit
158
+
159
+ Review these questions before confirming output:
160
+ ```
161
+ ✅ Did I rely ONLY on real, verified tools and methods?
162
+ ✅ Is this solution appropriately scoped to the user's constraints?
163
+ ✅ Did I handle potential failure modes and edge cases?
164
+ ✅ Have I avoided generic boilerplate that doesn't add value?
165
+ ```
166
+
167
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
168
+
169
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
170
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
171
+ - ✅ **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.
@@ -162,3 +162,45 @@ A server will inevitably crash when `/var/log` consumes 100% of the disk.
162
162
  ```
163
163
 
164
164
  ---
165
+
166
+
167
+ ---
168
+
169
+ ## 🤖 LLM-Specific Traps
170
+
171
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
172
+
173
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
174
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
175
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
176
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
177
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
178
+
179
+ ---
180
+
181
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
182
+
183
+ **Slash command: `/review` or `/tribunal-full`**
184
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
185
+
186
+ ### ❌ Forbidden AI Tropes
187
+
188
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
189
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
190
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
191
+
192
+ ### ✅ Pre-Flight Self-Audit
193
+
194
+ Review these questions before confirming output:
195
+ ```
196
+ ✅ Did I rely ONLY on real, verified tools and methods?
197
+ ✅ Is this solution appropriately scoped to the user's constraints?
198
+ ✅ Did I handle potential failure modes and edge cases?
199
+ ✅ Have I avoided generic boilerplate that doesn't add value?
200
+ ```
201
+
202
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
203
+
204
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
205
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
206
+ - ✅ **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.
@@ -179,3 +179,45 @@ export default async function Page() {
179
179
  ```
180
180
 
181
181
  ---
182
+
183
+
184
+ ---
185
+
186
+ ## 🤖 LLM-Specific Traps
187
+
188
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
189
+
190
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
191
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
192
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
193
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
194
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
195
+
196
+ ---
197
+
198
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
199
+
200
+ **Slash command: `/review` or `/tribunal-full`**
201
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
202
+
203
+ ### ❌ Forbidden AI Tropes
204
+
205
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
206
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
207
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
208
+
209
+ ### ✅ Pre-Flight Self-Audit
210
+
211
+ Review these questions before confirming output:
212
+ ```
213
+ ✅ Did I rely ONLY on real, verified tools and methods?
214
+ ✅ Is this solution appropriately scoped to the user's constraints?
215
+ ✅ Did I handle potential failure modes and edge cases?
216
+ ✅ Have I avoided generic boilerplate that doesn't add value?
217
+ ```
218
+
219
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
220
+
221
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
222
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
223
+ - ✅ **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.
@@ -34,3 +34,45 @@ Make the skill files actionable. Abstract advice ("be efficient", "write good co
34
34
  When you render the file, ensure it is written to `.agent/skills/<skill-name>/SKILL.md`.
35
35
 
36
36
  ---
37
+
38
+
39
+ ---
40
+
41
+ ## 🤖 LLM-Specific Traps
42
+
43
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
44
+
45
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
46
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
47
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
48
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
49
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
50
+
51
+ ---
52
+
53
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
54
+
55
+ **Slash command: `/review` or `/tribunal-full`**
56
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
57
+
58
+ ### ❌ Forbidden AI Tropes
59
+
60
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
61
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
62
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
63
+
64
+ ### ✅ Pre-Flight Self-Audit
65
+
66
+ Review these questions before confirming output:
67
+ ```
68
+ ✅ Did I rely ONLY on real, verified tools and methods?
69
+ ✅ Is this solution appropriately scoped to the user's constraints?
70
+ ✅ Did I handle potential failure modes and edge cases?
71
+ ✅ Have I avoided generic boilerplate that doesn't add value?
72
+ ```
73
+
74
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
75
+
76
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
77
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
78
+ - ✅ **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.
@@ -577,3 +577,45 @@ Evidence: [EXPLAIN ANALYZE output / migration success / test pass]
577
577
  Do not mark status as VERIFIED until concrete terminal evidence is provided.
578
578
 
579
579
  ---
580
+
581
+
582
+ ---
583
+
584
+ ## 🤖 LLM-Specific Traps
585
+
586
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
587
+
588
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
589
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
590
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
591
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
592
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
593
+
594
+ ---
595
+
596
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
597
+
598
+ **Slash command: `/review` or `/tribunal-full`**
599
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
600
+
601
+ ### ❌ Forbidden AI Tropes
602
+
603
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
604
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
605
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
606
+
607
+ ### ✅ Pre-Flight Self-Audit
608
+
609
+ Review these questions before confirming output:
610
+ ```
611
+ ✅ Did I rely ONLY on real, verified tools and methods?
612
+ ✅ Is this solution appropriately scoped to the user's constraints?
613
+ ✅ Did I handle potential failure modes and edge cases?
614
+ ✅ Have I avoided generic boilerplate that doesn't add value?
615
+ ```
616
+
617
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
618
+
619
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
620
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
621
+ - ✅ **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.
@@ -45,3 +45,45 @@ You are a Supabase Data Architect. You understand how to leverage PostgreSQL fea
45
45
  - Clearly delineate which tables need `replica identity full` or replication enabled for real-time subscriptions.
46
46
 
47
47
  ---
48
+
49
+
50
+ ---
51
+
52
+ ## 🤖 LLM-Specific Traps
53
+
54
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
55
+
56
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
57
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
58
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
59
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
60
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
61
+
62
+ ---
63
+
64
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
65
+
66
+ **Slash command: `/review` or `/tribunal-full`**
67
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
68
+
69
+ ### ❌ Forbidden AI Tropes
70
+
71
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
72
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
73
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
74
+
75
+ ### ✅ Pre-Flight Self-Audit
76
+
77
+ Review these questions before confirming output:
78
+ ```
79
+ ✅ Did I rely ONLY on real, verified tools and methods?
80
+ ✅ Is this solution appropriately scoped to the user's constraints?
81
+ ✅ Did I handle potential failure modes and edge cases?
82
+ ✅ Have I avoided generic boilerplate that doesn't add value?
83
+ ```
84
+
85
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
86
+
87
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
88
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
89
+ - ✅ **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.
@@ -149,3 +149,45 @@ While MVVM is historically popular, SwiftUI natively represents View-as-a-functi
149
149
  ```
150
150
 
151
151
  ---
152
+
153
+
154
+ ---
155
+
156
+ ## 🤖 LLM-Specific Traps
157
+
158
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
159
+
160
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
161
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
162
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
163
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
164
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
165
+
166
+ ---
167
+
168
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
169
+
170
+ **Slash command: `/review` or `/tribunal-full`**
171
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
172
+
173
+ ### ❌ Forbidden AI Tropes
174
+
175
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
176
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
177
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
178
+
179
+ ### ✅ Pre-Flight Self-Audit
180
+
181
+ Review these questions before confirming output:
182
+ ```
183
+ ✅ Did I rely ONLY on real, verified tools and methods?
184
+ ✅ Is this solution appropriately scoped to the user's constraints?
185
+ ✅ Did I handle potential failure modes and edge cases?
186
+ ✅ Have I avoided generic boilerplate that doesn't add value?
187
+ ```
188
+
189
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
190
+
191
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
192
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
193
+ - ✅ **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.
@@ -90,3 +90,45 @@ Do not skim. Stack traces tell the exact sequence of destruction.
90
90
  3. **The Parameter Conclusion:** Therefore, line 45 invoked `.map` on a variable that was `undefined`. Why did the parent layer pass `undefined` instead of `[]`?
91
91
 
92
92
  ---
93
+
94
+
95
+ ---
96
+
97
+ ## 🤖 LLM-Specific Traps
98
+
99
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
100
+
101
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
102
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
103
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
104
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
105
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
106
+
107
+ ---
108
+
109
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
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
+ ### ✅ Pre-Flight Self-Audit
121
+
122
+ Review these questions before confirming output:
123
+ ```
124
+ ✅ Did I rely ONLY on real, verified tools and methods?
125
+ ✅ Is this solution appropriately scoped to the user's constraints?
126
+ ✅ Did I handle potential failure modes and edge cases?
127
+ ✅ Have I avoided generic boilerplate that doesn't add value?
128
+ ```
129
+
130
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
131
+
132
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
133
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
134
+ - ✅ **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.
@@ -514,3 +514,45 @@ applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
514
514
  ```
515
515
 
516
516
  ---
517
+
518
+
519
+ ---
520
+
521
+ ## 🤖 LLM-Specific Traps
522
+
523
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
524
+
525
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
526
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
527
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
528
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
529
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
530
+
531
+ ---
532
+
533
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
534
+
535
+ **Slash command: `/review` or `/tribunal-full`**
536
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
537
+
538
+ ### ❌ Forbidden AI Tropes
539
+
540
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
541
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
542
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
543
+
544
+ ### ✅ Pre-Flight Self-Audit
545
+
546
+ Review these questions before confirming output:
547
+ ```
548
+ ✅ Did I rely ONLY on real, verified tools and methods?
549
+ ✅ Is this solution appropriately scoped to the user's constraints?
550
+ ✅ Did I handle potential failure modes and edge cases?
551
+ ✅ Have I avoided generic boilerplate that doesn't add value?
552
+ ```
553
+
554
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
555
+
556
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
557
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
558
+ - ✅ **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.
@@ -109,3 +109,45 @@ test('Deposit makes the funds available via getBalance', () => {
109
109
  ```
110
110
 
111
111
  ---
112
+
113
+
114
+ ---
115
+
116
+ ## 🤖 LLM-Specific Traps
117
+
118
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
119
+
120
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
121
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
122
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
123
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
124
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
125
+
126
+ ---
127
+
128
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
129
+
130
+ **Slash command: `/review` or `/tribunal-full`**
131
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
132
+
133
+ ### ❌ Forbidden AI Tropes
134
+
135
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
136
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
137
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
138
+
139
+ ### ✅ Pre-Flight Self-Audit
140
+
141
+ Review these questions before confirming output:
142
+ ```
143
+ ✅ Did I rely ONLY on real, verified tools and methods?
144
+ ✅ Is this solution appropriately scoped to the user's constraints?
145
+ ✅ Did I handle potential failure modes and edge cases?
146
+ ✅ Have I avoided generic boilerplate that doesn't add value?
147
+ ```
148
+
149
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
150
+
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.
@@ -257,3 +257,45 @@ If only snapshot tests fail → likely intentional UI change:
257
257
  - **Don't assume test runner** — auto-detect from output format, don't assume Jest.
258
258
 
259
259
  ---
260
+
261
+
262
+ ---
263
+
264
+ ## 🤖 LLM-Specific Traps
265
+
266
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
267
+
268
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
269
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
270
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
271
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
272
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
273
+
274
+ ---
275
+
276
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
277
+
278
+ **Slash command: `/review` or `/tribunal-full`**
279
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
280
+
281
+ ### ❌ Forbidden AI Tropes
282
+
283
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
284
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
285
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
286
+
287
+ ### ✅ Pre-Flight Self-Audit
288
+
289
+ Review these questions before confirming output:
290
+ ```
291
+ ✅ Did I rely ONLY on real, verified tools and methods?
292
+ ✅ Is this solution appropriately scoped to the user's constraints?
293
+ ✅ Did I handle potential failure modes and edge cases?
294
+ ✅ Have I avoided generic boilerplate that doesn't add value?
295
+ ```
296
+
297
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
298
+
299
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
300
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
301
+ - ✅ **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.
@@ -510,3 +510,45 @@ Coverage rules:
510
510
  ```
511
511
 
512
512
  ---
513
+
514
+
515
+ ---
516
+
517
+ ## 🤖 LLM-Specific Traps
518
+
519
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
520
+
521
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
522
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
523
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
524
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
525
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
526
+
527
+ ---
528
+
529
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
530
+
531
+ **Slash command: `/review` or `/tribunal-full`**
532
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
533
+
534
+ ### ❌ Forbidden AI Tropes
535
+
536
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
537
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
538
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
539
+
540
+ ### ✅ Pre-Flight Self-Audit
541
+
542
+ Review these questions before confirming output:
543
+ ```
544
+ ✅ Did I rely ONLY on real, verified tools and methods?
545
+ ✅ Is this solution appropriately scoped to the user's constraints?
546
+ ✅ Did I handle potential failure modes and edge cases?
547
+ ✅ Have I avoided generic boilerplate that doesn't add value?
548
+ ```
549
+
550
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
551
+
552
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
553
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
554
+ - ✅ **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,3 +185,45 @@ Pre-Flight: ✅ All checks passed
185
185
  ```
186
186
 
187
187
  ---
188
+
189
+
190
+ ---
191
+
192
+ ## 🤖 LLM-Specific Traps
193
+
194
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
195
+
196
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
197
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
198
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
199
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
200
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
201
+
202
+ ---
203
+
204
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
205
+
206
+ **Slash command: `/review` or `/tribunal-full`**
207
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
208
+
209
+ ### ❌ Forbidden AI Tropes
210
+
211
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
212
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
213
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
214
+
215
+ ### ✅ Pre-Flight Self-Audit
216
+
217
+ Review these questions before confirming output:
218
+ ```
219
+ ✅ Did I rely ONLY on real, verified tools and methods?
220
+ ✅ Is this solution appropriately scoped to the user's constraints?
221
+ ✅ Did I handle potential failure modes and edge cases?
222
+ ✅ Have I avoided generic boilerplate that doesn't add value?
223
+ ```
224
+
225
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
226
+
227
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
228
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
229
+ - ✅ **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.