tribunal-kit 8.0.0 β†’ 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (258) hide show
  1. package/.agent/ARCHITECTURE.md +2 -2
  2. package/.agent/config/plugin.json +4 -4
  3. package/.agent/config/system-prompt.md +54 -1
  4. package/.agent/routing_index.json +2 -2
  5. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -16
  6. package/.agent/skills/60fps-animation/SKILL.md +47 -21
  7. package/.agent/skills/accessible-animation/SKILL.md +19 -16
  8. package/.agent/skills/adapt/SKILL.md +19 -16
  9. package/.agent/skills/advanced-rag-pipelines/SKILL.md +41 -40
  10. package/.agent/skills/agent-organizer/SKILL.md +9 -59
  11. package/.agent/skills/agentic-patterns/SKILL.md +9 -57
  12. package/.agent/skills/agentic-workflows-2026/SKILL.md +45 -8
  13. package/.agent/skills/ai-app-hardening/SKILL.md +31 -5
  14. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +28 -66
  15. package/.agent/skills/animation-on-scroll/SKILL.md +19 -16
  16. package/.agent/skills/animation-systems/SKILL.md +19 -15
  17. package/.agent/skills/antfu-conventions/SKILL.md +19 -18
  18. package/.agent/skills/api-patterns/SKILL.md +8 -58
  19. package/.agent/skills/api-security-auditor/SKILL.md +8 -58
  20. package/.agent/skills/app-builder/SKILL.md +9 -59
  21. package/.agent/skills/appflow-wireframe/SKILL.md +13 -57
  22. package/.agent/skills/apple-design/SKILL.md +22 -14
  23. package/.agent/skills/architecture/SKILL.md +9 -59
  24. package/.agent/skills/audit-and-fix/SKILL.md +19 -16
  25. package/.agent/skills/authentication-best-practices/SKILL.md +8 -58
  26. package/.agent/skills/backend-security-expert/SKILL.md +32 -65
  27. package/.agent/skills/baseline-ui/SKILL.md +22 -14
  28. package/.agent/skills/bash-linux/SKILL.md +9 -59
  29. package/.agent/skills/behavioral-modes/SKILL.md +9 -57
  30. package/.agent/skills/better-colors/SKILL.md +22 -14
  31. package/.agent/skills/better-typography/SKILL.md +26 -14
  32. package/.agent/skills/better-ui/SKILL.md +54 -19
  33. package/.agent/skills/bolder/SKILL.md +19 -16
  34. package/.agent/skills/brainstorming/SKILL.md +9 -57
  35. package/.agent/skills/browser-native-ai/SKILL.md +9 -28
  36. package/.agent/skills/build-primitive/SKILL.md +19 -16
  37. package/.agent/skills/building-native-ui/SKILL.md +9 -59
  38. package/.agent/skills/cicd-pro/SKILL.md +21 -28
  39. package/.agent/skills/clarify/SKILL.md +19 -16
  40. package/.agent/skills/clean-code/SKILL.md +18 -61
  41. package/.agent/skills/cloud-architect/SKILL.md +21 -28
  42. package/.agent/skills/cobejs/SKILL.md +19 -15
  43. package/.agent/skills/code-review-checklist/SKILL.md +8 -58
  44. package/.agent/skills/codebase-design/SKILL.md +33 -22
  45. package/.agent/skills/colorize/SKILL.md +19 -16
  46. package/.agent/skills/compact-landing/SKILL.md +19 -16
  47. package/.agent/skills/company-logos/SKILL.md +19 -16
  48. package/.agent/skills/config-validator/SKILL.md +9 -59
  49. package/.agent/skills/containerization-pro/SKILL.md +21 -28
  50. package/.agent/skills/context-engineering-pro/SKILL.md +31 -5
  51. package/.agent/skills/create-design-md/SKILL.md +22 -14
  52. package/.agent/skills/critique/SKILL.md +20 -11
  53. package/.agent/skills/csharp-developer/SKILL.md +8 -58
  54. package/.agent/skills/data-validation-schemas/SKILL.md +9 -59
  55. package/.agent/skills/database-design/SKILL.md +27 -67
  56. package/.agent/skills/delight/SKILL.md +19 -16
  57. package/.agent/skills/deployment-procedures/SKILL.md +9 -59
  58. package/.agent/skills/design-lab/SKILL.md +19 -16
  59. package/.agent/skills/devops-engineer/SKILL.md +8 -58
  60. package/.agent/skills/devops-incident-responder/SKILL.md +9 -59
  61. package/.agent/skills/diagnosing-bugs/SKILL.md +20 -21
  62. package/.agent/skills/distill/SKILL.md +19 -16
  63. package/.agent/skills/documentation-templates/SKILL.md +9 -59
  64. package/.agent/skills/domain-modeling/SKILL.md +19 -18
  65. package/.agent/skills/duckdb-analytical-sql/SKILL.md +31 -5
  66. package/.agent/skills/edge-ai-mobile/SKILL.md +31 -5
  67. package/.agent/skills/edge-computing/SKILL.md +9 -59
  68. package/.agent/skills/emil-design-eng/SKILL.md +21 -24
  69. package/.agent/skills/error-resilience/SKILL.md +31 -66
  70. package/.agent/skills/expo-router-v4/SKILL.md +31 -5
  71. package/.agent/skills/extract-design-system/SKILL.md +9 -59
  72. package/.agent/skills/fabel-protocol/SKILL.md +26 -8
  73. package/.agent/skills/fixing-accessibility/SKILL.md +22 -14
  74. package/.agent/skills/fixing-metadata/SKILL.md +19 -16
  75. package/.agent/skills/fixing-motion-performance/SKILL.md +22 -14
  76. package/.agent/skills/framer-motion-expert/SKILL.md +9 -57
  77. package/.agent/skills/frontend-design/SKILL.md +27 -7
  78. package/.agent/skills/frontend-security-expert/SKILL.md +8 -58
  79. package/.agent/skills/game-design-expert/SKILL.md +9 -59
  80. package/.agent/skills/game-engineering-expert/SKILL.md +9 -59
  81. package/.agent/skills/generative-ui-expert/SKILL.md +9 -28
  82. package/.agent/skills/geo-fundamentals/SKILL.md +9 -59
  83. package/.agent/skills/git-pro/SKILL.md +19 -30
  84. package/.agent/skills/github-operations/SKILL.md +8 -58
  85. package/.agent/skills/gpt-taste/SKILL.md +19 -16
  86. package/.agent/skills/gsap-core/SKILL.md +8 -78
  87. package/.agent/skills/gsap-frameworks/SKILL.md +8 -78
  88. package/.agent/skills/gsap-performance/SKILL.md +9 -77
  89. package/.agent/skills/gsap-plugins/SKILL.md +9 -77
  90. package/.agent/skills/gsap-react/SKILL.md +9 -21
  91. package/.agent/skills/gsap-scrolltrigger/SKILL.md +8 -78
  92. package/.agent/skills/gsap-timeline/SKILL.md +9 -77
  93. package/.agent/skills/gsap-utils/SKILL.md +9 -77
  94. package/.agent/skills/harden/SKILL.md +19 -16
  95. package/.agent/skills/harness-protocol/SKILL.md +9 -21
  96. package/.agent/skills/i18n-localization/SKILL.md +9 -59
  97. package/.agent/skills/impeccable/SKILL.md +19 -18
  98. package/.agent/skills/improve-codebase-architecture/SKILL.md +19 -17
  99. package/.agent/skills/improve-ui/SKILL.md +22 -14
  100. package/.agent/skills/intelligent-routing/SKILL.md +9 -23
  101. package/.agent/skills/knowledge-graph/SKILL.md +9 -21
  102. package/.agent/skills/landing-page/SKILL.md +19 -16
  103. package/.agent/skills/lint-and-validate/SKILL.md +9 -59
  104. package/.agent/skills/llm-engineering/SKILL.md +8 -58
  105. package/.agent/skills/local-first/SKILL.md +9 -59
  106. package/.agent/skills/local-first-architecture/SKILL.md +37 -20
  107. package/.agent/skills/lottie-animation/SKILL.md +19 -15
  108. package/.agent/skills/marquee-loop/SKILL.md +19 -16
  109. package/.agent/skills/masked-reveal/SKILL.md +19 -15
  110. package/.agent/skills/mcp-builder/SKILL.md +9 -59
  111. package/.agent/skills/micro-interaction/SKILL.md +19 -16
  112. package/.agent/skills/mobile-design/SKILL.md +8 -58
  113. package/.agent/skills/monorepo-management/SKILL.md +9 -59
  114. package/.agent/skills/morphing-icons/SKILL.md +19 -15
  115. package/.agent/skills/motion-engineering/SKILL.md +22 -15
  116. package/.agent/skills/nextjs-react-expert/SKILL.md +35 -67
  117. package/.agent/skills/nodejs-best-practices/SKILL.md +34 -61
  118. package/.agent/skills/observability/SKILL.md +8 -58
  119. package/.agent/skills/opentelemetry-observability/SKILL.md +31 -5
  120. package/.agent/skills/page-transition-animation/SKILL.md +19 -16
  121. package/.agent/skills/parallel-agents/SKILL.md +9 -59
  122. package/.agent/skills/performance-profiling/SKILL.md +8 -58
  123. package/.agent/skills/plan-writing/SKILL.md +36 -69
  124. package/.agent/skills/platform-engineer/SKILL.md +9 -59
  125. package/.agent/skills/platform-engineering-opentofu/SKILL.md +31 -5
  126. package/.agent/skills/playwright-ai-e2e/SKILL.md +31 -5
  127. package/.agent/skills/playwright-best-practices/SKILL.md +9 -59
  128. package/.agent/skills/polish/SKILL.md +19 -16
  129. package/.agent/skills/powershell-windows/SKILL.md +8 -58
  130. package/.agent/skills/pricing-page/SKILL.md +19 -16
  131. package/.agent/skills/product-aware-heuristics/SKILL.md +27 -8
  132. package/.agent/skills/progressive-blur/SKILL.md +19 -16
  133. package/.agent/skills/project-idioms/SKILL.md +9 -59
  134. package/.agent/skills/property-based-testing/SKILL.md +31 -5
  135. package/.agent/skills/python-patterns/SKILL.md +9 -59
  136. package/.agent/skills/python-pro/SKILL.md +35 -67
  137. package/.agent/skills/quieter/SKILL.md +19 -16
  138. package/.agent/skills/react-doctor/SKILL.md +19 -16
  139. package/.agent/skills/react-specialist/SKILL.md +26 -65
  140. package/.agent/skills/readme-builder/SKILL.md +9 -59
  141. package/.agent/skills/realtime-patterns/SKILL.md +8 -58
  142. package/.agent/skills/red-team-tactics/SKILL.md +9 -59
  143. package/.agent/skills/redesign-skill/SKILL.md +19 -16
  144. package/.agent/skills/review-animations/SKILL.md +21 -25
  145. package/.agent/skills/rust-pro/SKILL.md +30 -61
  146. package/.agent/skills/seo-fundamentals/SKILL.md +9 -59
  147. package/.agent/skills/server-management/SKILL.md +9 -59
  148. package/.agent/skills/shadcn-ui-expert/SKILL.md +9 -59
  149. package/.agent/skills/shape/SKILL.md +19 -16
  150. package/.agent/skills/skill-creator/SKILL.md +36 -86
  151. package/.agent/skills/soft-skill/SKILL.md +19 -16
  152. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -16
  153. package/.agent/skills/sql-pro/SKILL.md +47 -62
  154. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +9 -59
  155. package/.agent/skills/svg-animation/SKILL.md +19 -15
  156. package/.agent/skills/swiftui-expert/SKILL.md +9 -59
  157. package/.agent/skills/swiss-design/SKILL.md +19 -16
  158. package/.agent/skills/system-design-pro/SKILL.md +21 -26
  159. package/.agent/skills/systematic-debugging/SKILL.md +19 -60
  160. package/.agent/skills/systematic-debugging/condition-based-waiting.md +115 -0
  161. package/.agent/skills/systematic-debugging/defense-in-depth.md +122 -0
  162. package/.agent/skills/systematic-debugging/root-cause-tracing.md +169 -0
  163. package/.agent/skills/tailwind-patterns/SKILL.md +8 -58
  164. package/.agent/skills/taste-skill/SKILL.md +19 -16
  165. package/.agent/skills/tdd-workflow/SKILL.md +65 -25
  166. package/.agent/skills/test-result-analyzer/SKILL.md +9 -59
  167. package/.agent/skills/testing-patterns/SKILL.md +8 -58
  168. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +19 -18
  169. package/.agent/skills/thinking-protocol/SKILL.md +33 -2
  170. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -15
  171. package/.agent/skills/transitions-dev/SKILL.md +19 -15
  172. package/.agent/skills/trend-researcher/SKILL.md +9 -59
  173. package/.agent/skills/typescript-advanced/SKILL.md +21 -64
  174. package/.agent/skills/typeset/SKILL.md +19 -16
  175. package/.agent/skills/ui-reasoning-engine/SKILL.md +27 -8
  176. package/.agent/skills/ui-skill-packs/SKILL.md +26 -16
  177. package/.agent/skills/ui-skills-root/SKILL.md +22 -14
  178. package/.agent/skills/ui-ux-pro-max/SKILL.md +38 -12
  179. package/.agent/skills/ui-ux-researcher/SKILL.md +9 -59
  180. package/.agent/skills/vector-search-pgvector/SKILL.md +31 -5
  181. package/.agent/skills/verification-before-completion/SKILL.md +125 -0
  182. package/.agent/skills/vue-expert/SKILL.md +9 -57
  183. package/.agent/skills/vulnerability-scanner/SKILL.md +8 -58
  184. package/.agent/skills/web-accessibility-auditor/SKILL.md +9 -59
  185. package/.agent/skills/web-design-guidelines/SKILL.md +27 -7
  186. package/.agent/skills/web-quality-audit/SKILL.md +19 -16
  187. package/.agent/skills/webapp-testing/SKILL.md +9 -59
  188. package/.agent/skills/webgpu-performance/SKILL.md +9 -28
  189. package/.agent/skills/whimsy-injector/SKILL.md +9 -57
  190. package/.agent/skills/workflow-optimizer/SKILL.md +9 -57
  191. package/.agent/skills/zero-trust-passkeys/SKILL.md +31 -5
  192. package/.agent/templates/DESIGN.md +680 -160
  193. package/.agent/templates/sdd/implementer-prompt.md +53 -0
  194. package/.agent/templates/sdd/re-review-prompt.md +28 -0
  195. package/.agent/templates/sdd/task-reviewer-prompt.md +59 -0
  196. package/.agent/workflows/acf.md +4 -0
  197. package/.agent/workflows/api-tester.md +5 -0
  198. package/.agent/workflows/audit.md +5 -0
  199. package/.agent/workflows/brainstorm.md +17 -1
  200. package/.agent/workflows/changelog.md +5 -0
  201. package/.agent/workflows/contract.md +19 -0
  202. package/.agent/workflows/create.md +6 -1
  203. package/.agent/workflows/debug.md +5 -0
  204. package/.agent/workflows/deploy.md +6 -1
  205. package/.agent/workflows/enhance.md +6 -1
  206. package/.agent/workflows/fix-ci.md +5 -0
  207. package/.agent/workflows/fix.md +5 -0
  208. package/.agent/workflows/generate.md +5 -0
  209. package/.agent/workflows/marathon.md +6 -1
  210. package/.agent/workflows/migrate.md +5 -0
  211. package/.agent/workflows/minimal.md +4 -0
  212. package/.agent/workflows/orchestrate.md +6 -1
  213. package/.agent/workflows/performance-benchmarker.md +6 -1
  214. package/.agent/workflows/pipeline.md +5 -0
  215. package/.agent/workflows/plan.md +6 -1
  216. package/.agent/workflows/preview.md +6 -1
  217. package/.agent/workflows/refactor.md +6 -0
  218. package/.agent/workflows/review-ai.md +5 -0
  219. package/.agent/workflows/review.md +5 -0
  220. package/.agent/workflows/sdd.md +122 -0
  221. package/.agent/workflows/session.md +5 -0
  222. package/.agent/workflows/status.md +4 -0
  223. package/.agent/workflows/super-prompt.md +4 -0
  224. package/.agent/workflows/swarm.md +6 -1
  225. package/.agent/workflows/test.md +6 -1
  226. package/.agent/workflows/tribunal-backend.md +5 -0
  227. package/.agent/workflows/tribunal-cicd.md +5 -0
  228. package/.agent/workflows/tribunal-database.md +5 -0
  229. package/.agent/workflows/tribunal-full.md +8 -0
  230. package/.agent/workflows/tribunal-mobile.md +5 -0
  231. package/.agent/workflows/tribunal-performance.md +5 -0
  232. package/.agent/workflows/tribunal-speed.md +5 -0
  233. package/.agent/workflows/tribunal-ui.md +7 -0
  234. package/.agents/plugins/marketplace.json +20 -0
  235. package/.claude-plugin/marketplace.json +17 -0
  236. package/.claude-plugin/plugin.json +26 -0
  237. package/.codex-plugin/plugin.json +45 -0
  238. package/.cursor-plugin/plugin.json +26 -0
  239. package/.devin-plugin/plugin.json +14 -0
  240. package/.hermes-plugin/__init__.py +102 -0
  241. package/.hermes-plugin/plugin.yaml +6 -0
  242. package/.kimi-plugin/plugin.json +38 -0
  243. package/.opencode/INSTALL.md +41 -0
  244. package/.opencode/plugins/tribunal.js +101 -0
  245. package/.pi/extensions/tribunal.ts +133 -0
  246. package/CONTRIBUTING.md +1 -1
  247. package/README.md +246 -221
  248. package/bin/wrapper.js +1 -0
  249. package/dist/cli.js +355 -355
  250. package/dist/esm/index.mjs +142 -142
  251. package/dist/index.d.ts +349 -343
  252. package/gemini-extension.json +6 -0
  253. package/hooks/hooks-cursor.json +16 -0
  254. package/hooks/hooks.json +16 -0
  255. package/hooks/session-start.js +77 -0
  256. package/package.json +165 -146
  257. package/scripts/audit_skill_sdo.js +87 -0
  258. package/scripts/modernize_skills.js +254 -0
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: sounds-on-the-web
3
3
  description: Web Audio API procedural sound synthesis for tactile micro-interaction feedback (clicks, pops, success chimes) with mute toggles and accessibility awareness.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - delight
8
8
  - micro-interaction
@@ -27,6 +27,12 @@ Before implementing web audio feedback, you MUST inspect:
27
27
 
28
28
  Synthesize lightweight, zero-dependency tactile sound effects for web micro-interactions.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring Web Audio API procedural sound synthesis for tactile micro-interaction feedback (clicks, pops, success chimes) with mute toggles and accessibility awareness..
34
+ - **DO NOT activate when:** The task falls strictly outside sounds-on-the-web domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## Zero-Asset Web Audio API Click Synthesizer
@@ -83,28 +89,25 @@ export const soundFX = new SoundFeedback();
83
89
 
84
90
  ---
85
91
 
86
- ## πŸ€– LLM-Specific Traps
92
+ ## πŸ›οΈ Tribunal Verification & Guardrails
87
93
 
88
- 1. **Autoplay Audio Errors**: Triggering Web Audio API before user gesture interaction (violating browser autoplay policies).
89
- 2. **Missing Mute Toggle**: Failing to provide a persistent sound toggle switch in application settings.
90
-
91
- ---
94
+ **Slash command: `/review` or `/tribunal-full`**
95
+ **Active reviewers: `logic-reviewer` Β· `security-auditor`**
92
96
 
93
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
94
-
95
- **Active reviewers: `frontend-reviewer`**
97
+ ### ❌ Forbidden AI Tropes
98
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
99
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
100
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
96
101
 
97
102
  ### βœ… Pre-Flight Self-Audit
98
-
99
103
  ```
100
- βœ… Is AudioContext initialized strictly inside/after user gesture handlers?
101
- βœ… Is volume gain kept subtle ($\le 0.15$ max volume)?
102
- βœ… Is a persistent sound mute option provided?
104
+ βœ… Did I rely ONLY on real, verified tools and methods?
105
+ βœ… Is this solution appropriately scoped to the user's constraints?
106
+ βœ… Did I handle potential failure modes and edge cases?
107
+ βœ… Have I avoided generic boilerplate that doesn't add value?
103
108
  ```
104
109
 
105
110
  ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
106
-
107
111
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
108
-
109
112
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
110
113
  - βœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: sql-pro
3
3
  description: Senior SQL developer across major databases (PostgreSQL, MySQL, SQL Server, Oracle). Complex query design with CTEs, window functions, PIVOT, recursive queries, JSON operations, full-text search, performance optimization with EXPLAIN ANALYZE, indexing strategies, partitioning, and schema architecture. Use when writing queries, designing schemas, optimizing performance, or debugging slow queries.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - database-design
9
9
  - db-latency-auditor
@@ -21,11 +21,50 @@ scripts-binding:
21
21
 
22
22
  Before writing complex SQL queries or optimizing database performance, you MUST inspect:
23
23
 
24
- 1. SARGability Inspection (Section 328) β†’ Ensure WHERE clauses use SARGable predicates; avoid functions or string operations on indexed columns
25
- 2. Keyset Pagination over OFFSET (Section 74) β†’ Use keyset/cursor pagination (`WHERE (created_at, id) < (...)`) instead of `OFFSET` for large tables (>10K rows)
26
- 3. EXPLAIN ANALYZE Verification (Section 358) β†’ Run `EXPLAIN (ANALYZE, BUFFERS)` to inspect physical query cost, buffer hits, and join algorithms
27
-
28
- # SQL Pro β€” Advanced Query & Schema Mastery
24
+ 1. Parameterized Queries Mandatory β†’ All queries MUST use parameter markers (`$1`, `?`, `:param`); never concatenate raw user input into SQL strings
25
+ 2. SARGability Verification β†’ Ensure `WHERE` clauses are SARGable (no functions or expressions wrapping indexed columns)
26
+ 3. Keyset Cursor Pagination β†’ Use `WHERE (created_at, id) < ($1, $2) ORDER BY created_at DESC, id DESC LIMIT 50`; ban `OFFSET` on datasets > 1,000 rows
27
+ 4. EXPLAIN (ANALYZE, BUFFERS) β†’ Check actual execution plan, shared buffer hits, and sequential scan flags
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Designing complex SQL queries, CTEs, window functions, query performance tuning, index optimization, and debugging slow transactions.
32
+ - **DO NOT activate when:** Writing NoSQL document queries (Mongo/Redis) or handling client-side state.
33
+
34
+ ## 2026 SQL Performance & Query Invariants
35
+
36
+ 1. **SARGable Date/Time Predicates**:
37
+ ```sql
38
+ -- ❌ BAD: Function on column kills index scan (Seq Scan)
39
+ WHERE DATE(created_at) = '2026-01-01'
40
+ -- βœ… GOOD: Direct range comparison enables Index Scan
41
+ WHERE created_at >= '2026-01-01 00:00:00+00' AND created_at < '2026-01-02 00:00:00+00'
42
+ ```
43
+ 2. **Keyset Cursor Pagination (O(1) vs O(N) OFFSET)**:
44
+ ```sql
45
+ -- βœ… Instant lookup regardless of page depth
46
+ SELECT id, title, created_at
47
+ FROM articles
48
+ WHERE (created_at, id) < ($last_created_at, $last_id)
49
+ ORDER BY created_at DESC, id DESC
50
+ LIMIT 20;
51
+ ```
52
+ 3. **CTE Optimization (`AS NOT MATERIALIZED`)**: In PostgreSQL 12+, CTEs inline automatically unless marked `MATERIALIZED`. Explicitly control materialization when CTE contains heavy calculations.
53
+ 4. **Batch Upserts with `ON CONFLICT`**:
54
+ ```sql
55
+ INSERT INTO metrics (device_id, recorded_at, val)
56
+ VALUES ($1, $2, $3)
57
+ ON CONFLICT (device_id, recorded_at)
58
+ DO UPDATE SET val = EXCLUDED.val;
59
+ ```
60
+
61
+ ## Hallucination Traps (Read First)
62
+
63
+ - ❌ String-concatenating user input into SQL β†’ βœ… Always use parameterized queries (`$1`, `?`)
64
+ - ❌ Using `OFFSET 50000` for pagination β†’ βœ… Use keyset cursor pagination (`WHERE id > $last_id`)
65
+ - ❌ Wrapping indexed columns in functions in WHERE clauses β†’ βœ… Compare bare column against computed value
66
+ - ❌ `SELECT *` in production queries β†’ βœ… Select explicit columns to utilize covering indexes
67
+ - ❌ `COUNT(*)` on millions of rows for simple existence check β†’ βœ… Use `SELECT EXISTS(SELECT 1 FROM ...)`
29
68
 
30
69
  ---
31
70
 
@@ -608,69 +647,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
608
647
 
609
648
  ---
610
649
 
611
- **Slash command: `/review` or `/tribunal-full`**
612
- **Active reviewers: `logic-reviewer` Β· `security-auditor`**
613
-
614
- ### ❌ Forbidden AI Tropes
615
-
616
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
617
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
618
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
619
-
620
- Review these questions before confirming output:
621
-
622
- ```
623
- βœ… Did I rely ONLY on real, verified tools and methods?
624
- βœ… Is this solution appropriately scoped to the user's constraints?
625
- βœ… Did I handle potential failure modes and edge cases?
626
- βœ… Have I avoided generic boilerplate that doesn't add value?
627
- ```
628
-
629
- ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
630
-
631
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
632
-
633
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
634
- - βœ… **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.
635
-
636
- ## Pre-Flight Checklist
637
-
638
- - [ ] Have I reviewed the user's specific constraints and requests?
639
- - [ ] Have I checked the environment for relevant existing implementations?
640
-
641
- ## VBC Protocol (Verification-Before-Completion)
642
-
643
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
644
-
645
- ---
646
-
647
- ## πŸ€– LLM-Specific Traps
648
-
649
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
650
-
651
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
652
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
653
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
654
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
655
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
656
-
657
- ---
658
-
659
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
650
+ ## πŸ›οΈ Tribunal Verification & Guardrails
660
651
 
661
652
  **Slash command: `/review` or `/tribunal-full`**
662
653
  **Active reviewers: `logic-reviewer` Β· `security-auditor`**
663
654
 
664
655
  ### ❌ Forbidden AI Tropes
665
-
666
656
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
667
657
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
668
658
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
669
659
 
670
660
  ### βœ… Pre-Flight Self-Audit
671
-
672
- Review these questions before confirming output:
673
-
674
661
  ```
675
662
  βœ… Did I rely ONLY on real, verified tools and methods?
676
663
  βœ… Is this solution appropriately scoped to the user's constraints?
@@ -679,8 +666,6 @@ Review these questions before confirming output:
679
666
  ```
680
667
 
681
668
  ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
682
-
683
669
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
684
-
685
670
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
686
671
  - βœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: supabase-postgres-best-practices
3
3
  description: Database architect expert in Supabase and PostgreSQL. Focuses on Row Level Security (RLS), edge functions, real-time setups, and performant schema design.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - database-design
9
9
  - sql-pro
@@ -25,6 +25,12 @@ Before engineering Supabase schemas or writing PostgreSQL migrations, you MUST i
25
25
  2. Direct UID Match RLS Rule (Section 30) β†’ Use direct equality (`auth.uid() = user_id`) in RLS policies; avoid slow `IN` subqueries
26
26
  3. SQL Migration File Requirement (Section 38) β†’ Write explicit SQL migration files (`supabase/migrations/`) rather than manual GUI operations
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Database architect expert in Supabase and PostgreSQL. Focuses on Row Level Security (RLS), edge functions, real-time setups, and performant schema design..
32
+ - **DO NOT activate when:** The task falls strictly outside supabase-postgres-best-practices domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Using Supabase without enabling Row Level Security (RLS) -> βœ… ALL tables MUST have RLS enabled; without it, data is publicly accessible
@@ -34,8 +40,6 @@ Before engineering Supabase schemas or writing PostgreSQL migrations, you MUST i
34
40
 
35
41
  ---
36
42
 
37
- # Supabase & Postgres Best Practices
38
-
39
43
  You are a Supabase Data Architect. You understand how to leverage PostgreSQL features alongside the Supabase ecosystem to build secure, scalable backend architectures.
40
44
 
41
45
  ## Core Directives
@@ -76,69 +80,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
76
80
 
77
81
  ---
78
82
 
79
- **Slash command: `/review` or `/tribunal-full`**
80
- **Active reviewers: `logic-reviewer` Β· `security-auditor`**
81
-
82
- ### ❌ Forbidden AI Tropes
83
-
84
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
85
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
86
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
87
-
88
- Review these questions before confirming output:
89
-
90
- ```
91
- βœ… Did I rely ONLY on real, verified tools and methods?
92
- βœ… Is this solution appropriately scoped to the user's constraints?
93
- βœ… Did I handle potential failure modes and edge cases?
94
- βœ… Have I avoided generic boilerplate that doesn't add value?
95
- ```
96
-
97
- ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
98
-
99
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
100
-
101
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
102
- - βœ… **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.
103
-
104
- ## Pre-Flight Checklist
105
-
106
- - [ ] Have I reviewed the user's specific constraints and requests?
107
- - [ ] Have I checked the environment for relevant existing implementations?
108
-
109
- ## VBC Protocol (Verification-Before-Completion)
110
-
111
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
112
-
113
- ---
114
-
115
- ## πŸ€– LLM-Specific Traps
116
-
117
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
118
-
119
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
120
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
121
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
122
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
123
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
124
-
125
- ---
126
-
127
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
83
+ ## πŸ›οΈ Tribunal Verification & Guardrails
128
84
 
129
85
  **Slash command: `/review` or `/tribunal-full`**
130
86
  **Active reviewers: `logic-reviewer` Β· `security-auditor`**
131
87
 
132
88
  ### ❌ Forbidden AI Tropes
133
-
134
89
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
135
90
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
136
91
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
137
92
 
138
93
  ### βœ… Pre-Flight Self-Audit
139
-
140
- Review these questions before confirming output:
141
-
142
94
  ```
143
95
  βœ… Did I rely ONLY on real, verified tools and methods?
144
96
  βœ… Is this solution appropriately scoped to the user's constraints?
@@ -147,8 +99,6 @@ Review these questions before confirming output:
147
99
  ```
148
100
 
149
101
  ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
150
-
151
102
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
152
-
153
103
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
154
104
  - βœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: svg-animation
3
3
  description: SVG stroke draw-on effects, path morphing, animated icons, motion paths, and interactive vector graphics.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - morphing-icons
8
8
  - 60fps-animation
@@ -27,6 +27,12 @@ Before engineering SVG path or stroke animations, you MUST inspect:
27
27
 
28
28
  Craft crisp, resolution-independent vector animations using CSS, Framer Motion, or GSAP.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring SVG stroke draw-on effects, path morphing, animated icons, motion paths, and interactive vector graphics..
34
+ - **DO NOT activate when:** The task falls strictly outside svg-animation domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 3 SVG Motion Techniques
@@ -83,27 +89,25 @@ gsap.to('#start-shape', {
83
89
 
84
90
  ---
85
91
 
86
- ## πŸ€– LLM-Specific Traps
92
+ ## πŸ›οΈ Tribunal Verification & Guardrails
87
93
 
88
- 1. **Incorrect `stroke-dasharray` Length**: Guessing path lengths without measuring `path.getTotalLength()`, resulting in clipped or incomplete draw-on animations.
89
- 2. **Missing `fill="none"`**: Forgetting `fill="none"` on draw-on stroke paths, causing black fill shapes during path animation.
90
-
91
- ---
94
+ **Slash command: `/review` or `/tribunal-full`**
95
+ **Active reviewers: `logic-reviewer` Β· `security-auditor`**
92
96
 
93
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
94
-
95
- **Active reviewers: `frontend-reviewer` Β· `motion-reviewer`**
97
+ ### ❌ Forbidden AI Tropes
98
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
99
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
100
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
96
101
 
97
102
  ### βœ… Pre-Flight Self-Audit
98
-
99
103
  ```
100
- βœ… Is `stroke-dasharray` calibrated to match the true SVG path length?
101
- βœ… Is `vector-effect="non-scaling-stroke"` applied if SVG elements scale responsively?
104
+ βœ… Did I rely ONLY on real, verified tools and methods?
105
+ βœ… Is this solution appropriately scoped to the user's constraints?
106
+ βœ… Did I handle potential failure modes and edge cases?
107
+ βœ… Have I avoided generic boilerplate that doesn't add value?
102
108
  ```
103
109
 
104
110
  ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
105
-
106
111
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
107
-
108
112
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
109
113
  - βœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: swiftui-expert
3
3
  description: SwiftUI development mastery. View architecture, state management (@State, @Binding, @Environment, @Observable), performance optimization (identifiable loops, implicit vs explicit animations), architectural patterns (MVVM vs TCA), and iOS-native UX paradigms. Use when writing native Apple platforms code.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - mobile-design
9
9
  - building-native-ui
@@ -25,6 +25,12 @@ Before writing or refactoring SwiftUI components, you MUST inspect:
25
25
  2. Identifiable Protocol in ForEach (Section 125) β†’ Conform model types to `Identifiable` for `ForEach`; ban integer index iteration (`0..<items.count`)
26
26
  3. NavigationStack Standard (Section 18) β†’ Use `NavigationStack` or `NavigationSplitView`; ban deprecated legacy `NavigationView`
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring SwiftUI development mastery. View architecture, state management (@State, @Binding, @Environment, @Observable), performance optimization (identifiable loops, implicit vs explicit animations), architectural patterns (MVVM vs TCA), and iOS-native UX paradigms. Use when writing native Apple platforms code..
32
+ - **DO NOT activate when:** The task falls strictly outside swiftui-expert domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ Using `@State` for shared data between views -> βœ… `@State` is local to a view; use `@Binding`, `@Environment`, or `@Observable` for sharing
@@ -34,8 +40,6 @@ Before writing or refactoring SwiftUI components, you MUST inspect:
34
40
 
35
41
  ---
36
42
 
37
- # SwiftUI Expert β€” Native Apple Platforms Mastery
38
-
39
43
  ---
40
44
 
41
45
  ## 1. Modern State Management (iOS 17+ / Swift 5.9+)
@@ -183,69 +187,17 @@ AI coding assistants often fall into specific bad habits when dealing with this
183
187
 
184
188
  ---
185
189
 
186
- **Slash command: `/review` or `/tribunal-full`**
187
- **Active reviewers: `logic-reviewer` Β· `security-auditor`**
188
-
189
- ### ❌ Forbidden AI Tropes
190
-
191
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
192
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
193
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
194
-
195
- Review these questions before confirming output:
196
-
197
- ```
198
- βœ… Did I rely ONLY on real, verified tools and methods?
199
- βœ… Is this solution appropriately scoped to the user's constraints?
200
- βœ… Did I handle potential failure modes and edge cases?
201
- βœ… Have I avoided generic boilerplate that doesn't add value?
202
- ```
203
-
204
- ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
205
-
206
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
207
-
208
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
209
- - βœ… **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.
210
-
211
- ## Pre-Flight Checklist
212
-
213
- - [ ] Have I reviewed the user's specific constraints and requests?
214
- - [ ] Have I checked the environment for relevant existing implementations?
215
-
216
- ## VBC Protocol (Verification-Before-Completion)
217
-
218
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
219
-
220
- ---
221
-
222
- ## πŸ€– LLM-Specific Traps
223
-
224
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
225
-
226
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
227
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
228
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
229
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
230
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
231
-
232
- ---
233
-
234
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
190
+ ## πŸ›οΈ Tribunal Verification & Guardrails
235
191
 
236
192
  **Slash command: `/review` or `/tribunal-full`**
237
193
  **Active reviewers: `logic-reviewer` Β· `security-auditor`**
238
194
 
239
195
  ### ❌ Forbidden AI Tropes
240
-
241
196
  1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
242
197
  2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
243
198
  3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
244
199
 
245
200
  ### βœ… Pre-Flight Self-Audit
246
-
247
- Review these questions before confirming output:
248
-
249
201
  ```
250
202
  βœ… Did I rely ONLY on real, verified tools and methods?
251
203
  βœ… Is this solution appropriately scoped to the user's constraints?
@@ -254,8 +206,6 @@ Review these questions before confirming output:
254
206
  ```
255
207
 
256
208
  ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
257
-
258
209
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
259
-
260
210
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
261
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.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: swiss-design
3
3
  description: International Typographic Style (Swiss Design) principles for web interfaces. Strict grid discipline, asymmetric layouts, bold typographic contrast, flush-left un-justified text, and mathematical negative space.
4
- version: 3.0.0
5
- last-updated: 2026-07-30
4
+ version: 4.0.0
5
+ last-updated: 2026-09-07
6
6
  skills:
7
7
  - typeset
8
8
  - baseline-ui
@@ -27,6 +27,12 @@ Before applying Swiss Design aesthetics, you MUST inspect:
27
27
 
28
28
  Architect pristine, print-inspired interfaces grounded in grid discipline, objective clarity, and asymmetric typographic hierarchy.
29
29
 
30
+
31
+ ## Activation Boundaries
32
+
33
+ - **Activate when:** Operating in tasks requiring International Typographic Style (Swiss Design) principles for web interfaces. Strict grid discipline, asymmetric layouts, bold typographic contrast, flush-left un-justified text, and mathematical negative space..
34
+ - **DO NOT activate when:** The task falls strictly outside swiss-design domain or belongs to a different dedicated specialist.
35
+
30
36
  ---
31
37
 
32
38
  ## 4 Swiss Design Pillars
@@ -51,28 +57,25 @@ Architect pristine, print-inspired interfaces grounded in grid discipline, objec
51
57
 
52
58
  ---
53
59
 
54
- ## πŸ€– LLM-Specific Traps
60
+ ## πŸ›οΈ Tribunal Verification & Guardrails
55
61
 
56
- 1. **Justified Text Alignment**: Setting `text-align: justify` which creates uneven, ugly gaps ("rivers") between words. Use `text-align: left`.
57
- 2. **Centered Text Overuse**: Centering body text paragraphs. Keep content strictly left-aligned.
58
-
59
- ---
62
+ **Slash command: `/review` or `/tribunal-full`**
63
+ **Active reviewers: `logic-reviewer` Β· `security-auditor`**
60
64
 
61
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
62
-
63
- **Active reviewers: `frontend-reviewer` Β· `ui-ux-auditor`**
65
+ ### ❌ Forbidden AI Tropes
66
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
67
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
68
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
64
69
 
65
70
  ### βœ… Pre-Flight Self-Audit
66
-
67
71
  ```
68
- βœ… Are all text paragraphs aligned flush-left (`text-align: left`)?
69
- βœ… Is layout structured on an explicit grid axis with generous negative space?
70
- βœ… Are tabular numbers (`tabular-nums`) used for numbered section markers?
72
+ βœ… Did I rely ONLY on real, verified tools and methods?
73
+ βœ… Is this solution appropriately scoped to the user's constraints?
74
+ βœ… Did I handle potential failure modes and edge cases?
75
+ βœ… Have I avoided generic boilerplate that doesn't add value?
71
76
  ```
72
77
 
73
78
  ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
74
-
75
79
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
76
-
77
80
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
78
81
  - βœ… **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
@@ -2,8 +2,8 @@
2
2
  name: system-design-pro
3
3
  description: Industry-level system design mastery for interviews and production. The 6-step design framework, scale estimation (DAUβ†’QPSβ†’storageβ†’bandwidth), core building blocks (load balancers L4/L7, CDN, caches, queues), database selection matrix, CAP Theorem applied, and reference designs for URL shortener, rate limiter, Twitter feed, distributed cache, and notification system. Use when designing systems for scale, conducting architecture reviews, or preparing system design discussions.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
- version: 3.0.0
6
- last-updated: 2026-07-30
5
+ version: 4.0.0
6
+ last-updated: 2026-09-07
7
7
  skills:
8
8
  - architecture
9
9
  - database-design
@@ -25,6 +25,12 @@ Before designing system architecture or writing scale proposals, you MUST inspec
25
25
  2. Quantified Scale Estimation (Section 65) β†’ Calculate read/write QPS, storage growth, and bandwidth before selecting database or caching tiers
26
26
  3. Monolith First Rule (Section 17) β†’ Start with modular monolith for $<10\text{K}$ RPM; ban introducing microservices or sharding prematurely
27
27
 
28
+
29
+ ## Activation Boundaries
30
+
31
+ - **Activate when:** Operating in tasks requiring Industry-level system design mastery for interviews and production. The 6-step design framework, scale estimation (DAU→QPS→storage→bandwidth), core building blocks (load balancers L4/L7, CDN, caches, queues), database selection matrix, CAP Theorem applied, and reference designs for URL shortener, rate limiter, Twitter feed, distributed cache, and notification system. Use when designing systems for scale, conducting architecture reviews, or preparing system design discussions..
32
+ - **DO NOT activate when:** The task falls strictly outside system-design-pro domain or belongs to a different dedicated specialist.
33
+
28
34
  ## Hallucination Traps (Read First)
29
35
 
30
36
  - ❌ "Just use microservices" for <10K RPM β†’ βœ… Microservices add operational complexity that kills small teams. Start monolith.
@@ -35,8 +41,6 @@ Before designing system architecture or writing scale proposals, you MUST inspec
35
41
 
36
42
  ---
37
43
 
38
- # System Design Pro β€” Industry-Level Mastery
39
-
40
44
  ## 1. The 6-Step Design Framework
41
45
 
42
46
  Use this structure for every system design discussion:
@@ -325,34 +329,25 @@ Failure handling:
325
329
 
326
330
  ---
327
331
 
328
- ## πŸ€– LLM-Specific Traps
329
-
330
- 1. **Premature sharding**: Suggesting database sharding before the user has even mentioned scale issues. Sharding is complex; exhaust simpler options first.
331
- 2. **NoSQL for everything**: DynamoDB and MongoDB are not universally better. They sacrifice joins and ACID. Present the tradeoffs honestly.
332
- 3. **Ignoring the 80/20 of read QPS**: Most web apps are 80-95% reads. Design the read path first (caching, CDN, read replicas) before optimizing writes.
333
- 4. **Forgetting the Coordinator Problem**: Distributed systems need coordination (who is the leader?). Mention ZooKeeper/etcd or leaderless designs when relevant.
334
- 5. **Over-specifying CAP**: Real systems pick AP vs CP at the feature level, not the system level. A shopping cart (AP) and payment processing (CP) can coexist.
335
-
336
- ---
337
-
338
- ## πŸ›οΈ Tribunal Integration (Anti-Hallucination)
332
+ ## πŸ›οΈ Tribunal Verification & Guardrails
339
333
 
340
334
  **Slash command: `/review` or `/tribunal-full`**
341
- **Active reviewers: `logic-reviewer` Β· `system-architect` Β· `database-architect`**
335
+ **Active reviewers: `logic-reviewer` Β· `security-auditor`**
342
336
 
343
- ### βœ… Pre-Flight Self-Audit
337
+ ### ❌ Forbidden AI Tropes
338
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
339
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
340
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
344
341
 
342
+ ### βœ… Pre-Flight Self-Audit
345
343
  ```
346
- βœ… Did I quantify the scale before recommending a solution?
347
- βœ… Did I present at least 2 database options with tradeoffs?
348
- βœ… Did I define the read:write ratio before choosing a caching strategy?
349
- βœ… Did I verify the system doesn't need microservices before recommending them?
350
- βœ… Did I define a failure mode and mitigation for the primary bottleneck?
344
+ βœ… Did I rely ONLY on real, verified tools and methods?
345
+ βœ… Is this solution appropriately scoped to the user's constraints?
346
+ βœ… Did I handle potential failure modes and edge cases?
347
+ βœ… Have I avoided generic boilerplate that doesn't add value?
351
348
  ```
352
349
 
353
350
  ### πŸ›‘ Verification-Before-Completion (VBC) Protocol
354
-
355
351
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
356
-
357
- - ❌ **Forbidden**: Recommending an architecture without first establishing scale numbers.
358
- - βœ… **Required**: Every system design must include: QPS estimates, data model, caching strategy, and at least one identified bottleneck with a scaling plan.
352
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
353
+ - βœ… **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.