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
@@ -93,3 +93,45 @@ Before writing React, chart exactly what the user can do on the screen and what
93
93
  |Click outside Modal|`useClickAway`|`setIsOpen(false)`|Prevent close if form is dirty|
94
94
 
95
95
  ---
96
+
97
+
98
+ ---
99
+
100
+ ## 🤖 LLM-Specific Traps
101
+
102
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
103
+
104
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
105
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
106
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
107
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
108
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
109
+
110
+ ---
111
+
112
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
113
+
114
+ **Slash command: `/review` or `/tribunal-full`**
115
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
116
+
117
+ ### ❌ Forbidden AI Tropes
118
+
119
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
120
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
121
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
122
+
123
+ ### ✅ Pre-Flight Self-Audit
124
+
125
+ Review these questions before confirming output:
126
+ ```
127
+ ✅ Did I rely ONLY on real, verified tools and methods?
128
+ ✅ Is this solution appropriately scoped to the user's constraints?
129
+ ✅ Did I handle potential failure modes and edge cases?
130
+ ✅ Have I avoided generic boilerplate that doesn't add value?
131
+ ```
132
+
133
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
134
+
135
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
136
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
137
+ - ✅ **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.
@@ -167,3 +167,45 @@ Team: Solo 2–10 10+
167
167
  Architecture: Simple Mono Modular Mono Distributed
168
168
  Framework: Next.js API NestJS Microservices
169
169
  ```
170
+
171
+
172
+ ---
173
+
174
+ ## 🤖 LLM-Specific Traps
175
+
176
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
177
+
178
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
179
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
180
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
181
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
182
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
183
+
184
+ ---
185
+
186
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
187
+
188
+ **Slash command: `/review` or `/tribunal-full`**
189
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
190
+
191
+ ### ❌ Forbidden AI Tropes
192
+
193
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
194
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
195
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
196
+
197
+ ### ✅ Pre-Flight Self-Audit
198
+
199
+ Review these questions before confirming output:
200
+ ```
201
+ ✅ Did I rely ONLY on real, verified tools and methods?
202
+ ✅ Is this solution appropriately scoped to the user's constraints?
203
+ ✅ Did I handle potential failure modes and edge cases?
204
+ ✅ Have I avoided generic boilerplate that doesn't add value?
205
+ ```
206
+
207
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
208
+
209
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
210
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
211
+ - ✅ **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.
@@ -137,3 +137,45 @@ function canEditPost(user: User, post: Post): boolean {
137
137
  ```
138
138
 
139
139
  ---
140
+
141
+
142
+ ---
143
+
144
+ ## 🤖 LLM-Specific Traps
145
+
146
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
147
+
148
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
149
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
150
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
151
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
152
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
153
+
154
+ ---
155
+
156
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
157
+
158
+ **Slash command: `/review` or `/tribunal-full`**
159
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
160
+
161
+ ### ❌ Forbidden AI Tropes
162
+
163
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
164
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
165
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
166
+
167
+ ### ✅ Pre-Flight Self-Audit
168
+
169
+ Review these questions before confirming output:
170
+ ```
171
+ ✅ Did I rely ONLY on real, verified tools and methods?
172
+ ✅ Is this solution appropriately scoped to the user's constraints?
173
+ ✅ Did I handle potential failure modes and edge cases?
174
+ ✅ Have I avoided generic boilerplate that doesn't add value?
175
+ ```
176
+
177
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
178
+
179
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
180
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
181
+ - ✅ **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 @@ done
127
127
  ```
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.
@@ -171,3 +171,45 @@ Pre-Flight: ✅ All checks passed
171
171
  ```
172
172
 
173
173
  ---
174
+
175
+
176
+ ---
177
+
178
+ ## 🤖 LLM-Specific Traps
179
+
180
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
181
+
182
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
183
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
184
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
185
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
186
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
187
+
188
+ ---
189
+
190
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
191
+
192
+ **Slash command: `/review` or `/tribunal-full`**
193
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
194
+
195
+ ### ❌ Forbidden AI Tropes
196
+
197
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
198
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
199
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
200
+
201
+ ### ✅ Pre-Flight Self-Audit
202
+
203
+ Review these questions before confirming output:
204
+ ```
205
+ ✅ Did I rely ONLY on real, verified tools and methods?
206
+ ✅ Is this solution appropriately scoped to the user's constraints?
207
+ ✅ Did I handle potential failure modes and edge cases?
208
+ ✅ Have I avoided generic boilerplate that doesn't add value?
209
+ ```
210
+
211
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
212
+
213
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
214
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
215
+ - ✅ **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.
@@ -434,3 +434,45 @@ STEP 4: Format Output
434
434
  4. **Provide defaults** → If user doesn't answer, we proceed anyway
435
435
  5. **Domain-aware** → Ecommerce questions ≠ Auth questions ≠ Real-time questions
436
436
  6. **Iterative** → More questions as patterns emerge during implementation
437
+
438
+
439
+ ---
440
+
441
+ ## 🤖 LLM-Specific Traps
442
+
443
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
444
+
445
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
446
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
447
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
448
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
449
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
450
+
451
+ ---
452
+
453
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
454
+
455
+ **Slash command: `/review` or `/tribunal-full`**
456
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
457
+
458
+ ### ❌ Forbidden AI Tropes
459
+
460
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
461
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
462
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
463
+
464
+ ### ✅ Pre-Flight Self-Audit
465
+
466
+ Review these questions before confirming output:
467
+ ```
468
+ ✅ Did I rely ONLY on real, verified tools and methods?
469
+ ✅ Is this solution appropriately scoped to the user's constraints?
470
+ ✅ Did I handle potential failure modes and edge cases?
471
+ ✅ Have I avoided generic boilerplate that doesn't add value?
472
+ ```
473
+
474
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
475
+
476
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
477
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
478
+ - ✅ **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.
@@ -150,3 +150,45 @@ export function FastList({ data }) {
150
150
  ```
151
151
 
152
152
  ---
153
+
154
+
155
+ ---
156
+
157
+ ## 🤖 LLM-Specific Traps
158
+
159
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
160
+
161
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
162
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
163
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
164
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
165
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
166
+
167
+ ---
168
+
169
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
170
+
171
+ **Slash command: `/review` or `/tribunal-full`**
172
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
173
+
174
+ ### ❌ Forbidden AI Tropes
175
+
176
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
177
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
178
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
179
+
180
+ ### ✅ Pre-Flight Self-Audit
181
+
182
+ Review these questions before confirming output:
183
+ ```
184
+ ✅ Did I rely ONLY on real, verified tools and methods?
185
+ ✅ Is this solution appropriately scoped to the user's constraints?
186
+ ✅ Did I handle potential failure modes and edge cases?
187
+ ✅ Have I avoided generic boilerplate that doesn't add value?
188
+ ```
189
+
190
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
191
+
192
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
193
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
194
+ - ✅ **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.
@@ -329,3 +329,45 @@ function processUser(user: User) {
329
329
  ```
330
330
 
331
331
  ---
332
+
333
+
334
+ ---
335
+
336
+ ## 🤖 LLM-Specific Traps
337
+
338
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
339
+
340
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
341
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
342
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
343
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
344
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
345
+
346
+ ---
347
+
348
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
349
+
350
+ **Slash command: `/review` or `/tribunal-full`**
351
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
352
+
353
+ ### ❌ Forbidden AI Tropes
354
+
355
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
356
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
357
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
358
+
359
+ ### ✅ Pre-Flight Self-Audit
360
+
361
+ Review these questions before confirming output:
362
+ ```
363
+ ✅ Did I rely ONLY on real, verified tools and methods?
364
+ ✅ Is this solution appropriately scoped to the user's constraints?
365
+ ✅ Did I handle potential failure modes and edge cases?
366
+ ✅ Have I avoided generic boilerplate that doesn't add value?
367
+ ```
368
+
369
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
370
+
371
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
372
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
373
+ - ✅ **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.
@@ -142,3 +142,45 @@ Evidence: [link to terminal output, test result, or file diff]
142
142
  ```
143
143
 
144
144
  ---
145
+
146
+
147
+ ---
148
+
149
+ ## 🤖 LLM-Specific Traps
150
+
151
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
152
+
153
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
154
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
155
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
156
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
157
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
158
+
159
+ ---
160
+
161
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
162
+
163
+ **Slash command: `/review` or `/tribunal-full`**
164
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
165
+
166
+ ### ❌ Forbidden AI Tropes
167
+
168
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
169
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
170
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
171
+
172
+ ### ✅ Pre-Flight Self-Audit
173
+
174
+ Review these questions before confirming output:
175
+ ```
176
+ ✅ Did I rely ONLY on real, verified tools and methods?
177
+ ✅ Is this solution appropriately scoped to the user's constraints?
178
+ ✅ Did I handle potential failure modes and edge cases?
179
+ ✅ Have I avoided generic boilerplate that doesn't add value?
180
+ ```
181
+
182
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
183
+
184
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
185
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
186
+ - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -113,3 +113,45 @@ When automating updates to a JSON configuration (e.g., adding a new skill to `co
113
113
  4. **Write** atomically (write to `config.json.tmp`, then standard OS file rename to `config.json` to prevent corruption if power dies mid-write).
114
114
 
115
115
  ---
116
+
117
+
118
+ ---
119
+
120
+ ## 🤖 LLM-Specific Traps
121
+
122
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
123
+
124
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
125
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
126
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
127
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
128
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
129
+
130
+ ---
131
+
132
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
133
+
134
+ **Slash command: `/review` or `/tribunal-full`**
135
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
136
+
137
+ ### ❌ Forbidden AI Tropes
138
+
139
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
140
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
141
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
142
+
143
+ ### ✅ Pre-Flight Self-Audit
144
+
145
+ Review these questions before confirming output:
146
+ ```
147
+ ✅ Did I rely ONLY on real, verified tools and methods?
148
+ ✅ Is this solution appropriately scoped to the user's constraints?
149
+ ✅ Did I handle potential failure modes and edge cases?
150
+ ✅ Have I avoided generic boilerplate that doesn't add value?
151
+ ```
152
+
153
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
154
+
155
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
156
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
157
+ - ✅ **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.
@@ -466,3 +466,45 @@ public class UsersApiTests(WebApplicationFactory<Program> factory)
466
466
  ```
467
467
 
468
468
  ---
469
+
470
+
471
+ ---
472
+
473
+ ## 🤖 LLM-Specific Traps
474
+
475
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
476
+
477
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
478
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
479
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
480
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
481
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
482
+
483
+ ---
484
+
485
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
486
+
487
+ **Slash command: `/review` or `/tribunal-full`**
488
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
489
+
490
+ ### ❌ Forbidden AI Tropes
491
+
492
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
493
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
494
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
495
+
496
+ ### ✅ Pre-Flight Self-Audit
497
+
498
+ Review these questions before confirming output:
499
+ ```
500
+ ✅ Did I rely ONLY on real, verified tools and methods?
501
+ ✅ Is this solution appropriately scoped to the user's constraints?
502
+ ✅ Did I handle potential failure modes and edge cases?
503
+ ✅ Have I avoided generic boilerplate that doesn't add value?
504
+ ```
505
+
506
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
507
+
508
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
509
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
510
+ - ✅ **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.