tribunal-kit 4.5.0 → 4.6.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 (217) hide show
  1. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  2. package/.agent/ARCHITECTURE.md +279 -277
  3. package/.agent/GEMINI.md +127 -121
  4. package/.agent/agents/accessibility-reviewer.md +187 -187
  5. package/.agent/agents/ai-code-reviewer.md +199 -199
  6. package/.agent/agents/api-architect.md +71 -66
  7. package/.agent/agents/backend-specialist.md +219 -215
  8. package/.agent/agents/cloud-engineer.md +98 -0
  9. package/.agent/agents/code-archaeologist.md +168 -161
  10. package/.agent/agents/database-architect.md +184 -184
  11. package/.agent/agents/db-latency-auditor.md +213 -216
  12. package/.agent/agents/debugger.md +198 -191
  13. package/.agent/agents/dependency-reviewer.md +106 -103
  14. package/.agent/agents/devops-engineer.md +218 -218
  15. package/.agent/agents/documentation-writer.md +209 -201
  16. package/.agent/agents/explorer-agent.md +167 -160
  17. package/.agent/agents/frontend-reviewer.md +162 -160
  18. package/.agent/agents/frontend-specialist.md +257 -248
  19. package/.agent/agents/game-developer.md +48 -48
  20. package/.agent/agents/logic-reviewer.md +118 -116
  21. package/.agent/agents/mobile-developer.md +197 -200
  22. package/.agent/agents/mobile-reviewer.md +159 -162
  23. package/.agent/agents/orchestrator.md +187 -181
  24. package/.agent/agents/penetration-tester.md +160 -157
  25. package/.agent/agents/performance-optimizer.md +183 -183
  26. package/.agent/agents/performance-reviewer.md +178 -178
  27. package/.agent/agents/precedence-reviewer.md +251 -250
  28. package/.agent/agents/product-manager.md +149 -142
  29. package/.agent/agents/product-owner.md +81 -80
  30. package/.agent/agents/project-planner.md +152 -142
  31. package/.agent/agents/qa-automation-engineer.md +216 -225
  32. package/.agent/agents/resilience-reviewer.md +88 -88
  33. package/.agent/agents/schema-reviewer.md +67 -67
  34. package/.agent/agents/security-auditor.md +180 -174
  35. package/.agent/agents/seo-specialist.md +188 -193
  36. package/.agent/agents/sql-reviewer.md +159 -161
  37. package/.agent/agents/supervisor-agent.md +173 -184
  38. package/.agent/agents/swarm-worker-contracts.md +170 -166
  39. package/.agent/agents/swarm-worker-registry.md +92 -92
  40. package/.agent/agents/system-architect.md +85 -0
  41. package/.agent/agents/test-coverage-reviewer.md +158 -160
  42. package/.agent/agents/test-engineer.md +118 -118
  43. package/.agent/agents/throughput-optimizer.md +291 -299
  44. package/.agent/agents/type-safety-reviewer.md +182 -175
  45. package/.agent/agents/ui-ux-auditor.md +300 -292
  46. package/.agent/agents/vitals-reviewer.md +223 -223
  47. package/.agent/mcp_config.json +37 -40
  48. package/.agent/patterns/generator.md +11 -9
  49. package/.agent/patterns/inversion.md +14 -12
  50. package/.agent/patterns/pipeline.md +11 -9
  51. package/.agent/patterns/reviewer.md +15 -13
  52. package/.agent/patterns/tool-wrapper.md +11 -9
  53. package/.agent/routing_index.json +654 -0
  54. package/.agent/rules/GEMINI.md +358 -352
  55. package/.agent/scripts/compile_router.py +112 -0
  56. package/.agent/scripts/migrate_skills_frontmatter.py +64 -0
  57. package/.agent/scripts/strengthen_skills.js +1 -1
  58. package/.agent/skills/advanced-rag-pipelines/SKILL.md +56 -0
  59. package/.agent/skills/agent-organizer/SKILL.md +156 -150
  60. package/.agent/skills/agentic-patterns/SKILL.md +313 -315
  61. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +190 -184
  62. package/.agent/skills/api-patterns/SKILL.md +253 -247
  63. package/.agent/skills/api-security-auditor/SKILL.md +195 -193
  64. package/.agent/skills/app-builder/SKILL.md +573 -572
  65. package/.agent/skills/app-builder/templates/SKILL.md +108 -115
  66. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  67. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  68. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  69. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  70. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  71. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  72. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  73. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -122
  74. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -122
  75. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -169
  76. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -134
  77. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  78. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -119
  79. package/.agent/skills/appflow-wireframe/SKILL.md +146 -145
  80. package/.agent/skills/architecture/SKILL.md +226 -219
  81. package/.agent/skills/authentication-best-practices/SKILL.md +197 -189
  82. package/.agent/skills/backend-security-expert/SKILL.md +16 -2
  83. package/.agent/skills/bash-linux/SKILL.md +179 -179
  84. package/.agent/skills/behavioral-modes/SKILL.md +239 -223
  85. package/.agent/skills/brainstorming/SKILL.md +498 -486
  86. package/.agent/skills/browser-native-ai/SKILL.md +57 -4
  87. package/.agent/skills/building-native-ui/SKILL.md +202 -202
  88. package/.agent/skills/cicd-pro/SKILL.md +442 -0
  89. package/.agent/skills/clean-code/SKILL.md +400 -381
  90. package/.agent/skills/cloud-architect/SKILL.md +439 -0
  91. package/.agent/skills/code-review-checklist/SKILL.md +203 -194
  92. package/.agent/skills/config-validator/SKILL.md +165 -165
  93. package/.agent/skills/containerization-pro/SKILL.md +452 -0
  94. package/.agent/skills/csharp-developer/SKILL.md +518 -518
  95. package/.agent/skills/data-validation-schemas/SKILL.md +333 -328
  96. package/.agent/skills/database-design/SKILL.md +247 -240
  97. package/.agent/skills/deployment-procedures/SKILL.md +172 -169
  98. package/.agent/skills/devops-engineer/SKILL.md +345 -345
  99. package/.agent/skills/devops-incident-responder/SKILL.md +143 -137
  100. package/.agent/skills/doc.md +209 -177
  101. package/.agent/skills/documentation-templates/SKILL.md +291 -279
  102. package/.agent/skills/edge-computing/SKILL.md +183 -181
  103. package/.agent/skills/error-resilience/SKILL.md +411 -428
  104. package/.agent/skills/extract-design-system/SKILL.md +160 -158
  105. package/.agent/skills/framer-motion-expert/SKILL.md +253 -244
  106. package/.agent/skills/frontend-design/SKILL.md +208 -201
  107. package/.agent/skills/frontend-security-expert/SKILL.md +16 -3
  108. package/.agent/skills/game-design-expert/SKILL.md +132 -129
  109. package/.agent/skills/game-engineering-expert/SKILL.md +148 -146
  110. package/.agent/skills/generative-ui-expert/SKILL.md +57 -1
  111. package/.agent/skills/geo-fundamentals/SKILL.md +148 -147
  112. package/.agent/skills/git-pro/SKILL.md +435 -0
  113. package/.agent/skills/github-operations/SKILL.md +335 -329
  114. package/.agent/skills/gsap-core/SKILL.md +319 -308
  115. package/.agent/skills/gsap-frameworks/SKILL.md +213 -207
  116. package/.agent/skills/gsap-performance/SKILL.md +139 -133
  117. package/.agent/skills/gsap-plugins/SKILL.md +486 -480
  118. package/.agent/skills/gsap-react/SKILL.md +202 -189
  119. package/.agent/skills/gsap-scrolltrigger/SKILL.md +357 -350
  120. package/.agent/skills/gsap-timeline/SKILL.md +165 -161
  121. package/.agent/skills/gsap-utils/SKILL.md +344 -338
  122. package/.agent/skills/harness-protocol/SKILL.md +48 -0
  123. package/.agent/skills/i18n-localization/SKILL.md +174 -163
  124. package/.agent/skills/intelligent-routing/SKILL.md +202 -246
  125. package/.agent/skills/knowledge-graph/SKILL.md +60 -52
  126. package/.agent/skills/lint-and-validate/SKILL.md +261 -261
  127. package/.agent/skills/llm-engineering/SKILL.md +400 -394
  128. package/.agent/skills/local-first/SKILL.md +178 -178
  129. package/.agent/skills/mcp-builder/SKILL.md +143 -142
  130. package/.agent/skills/mobile-design/SKILL.md +272 -263
  131. package/.agent/skills/monorepo-management/SKILL.md +335 -334
  132. package/.agent/skills/motion-engineering/SKILL.md +266 -234
  133. package/.agent/skills/nextjs-react-expert/SKILL.md +236 -234
  134. package/.agent/skills/nodejs-best-practices/SKILL.md +547 -548
  135. package/.agent/skills/observability/SKILL.md +343 -343
  136. package/.agent/skills/parallel-agents/SKILL.md +143 -146
  137. package/.agent/skills/performance-profiling/SKILL.md +259 -267
  138. package/.agent/skills/plan-writing/SKILL.md +150 -142
  139. package/.agent/skills/platform-engineer/SKILL.md +148 -147
  140. package/.agent/skills/playwright-best-practices/SKILL.md +188 -187
  141. package/.agent/skills/powershell-windows/SKILL.md +162 -162
  142. package/.agent/skills/project-idioms/SKILL.md +137 -137
  143. package/.agent/skills/python-patterns/SKILL.md +260 -259
  144. package/.agent/skills/python-pro/SKILL.md +324 -323
  145. package/.agent/skills/react-specialist/SKILL.md +305 -277
  146. package/.agent/skills/readme-builder/SKILL.md +310 -300
  147. package/.agent/skills/realtime-patterns/SKILL.md +323 -319
  148. package/.agent/skills/red-team-tactics/SKILL.md +231 -218
  149. package/.agent/skills/rust-pro/SKILL.md +671 -673
  150. package/.agent/skills/seo-fundamentals/SKILL.md +179 -179
  151. package/.agent/skills/server-management/SKILL.md +218 -214
  152. package/.agent/skills/shadcn-ui-expert/SKILL.md +231 -231
  153. package/.agent/skills/skill-creator/SKILL.md +87 -86
  154. package/.agent/skills/sql-pro/SKILL.md +629 -629
  155. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +97 -97
  156. package/.agent/skills/swiftui-expert/SKILL.md +204 -201
  157. package/.agent/skills/system-design-pro/SKILL.md +345 -0
  158. package/.agent/skills/systematic-debugging/SKILL.md +153 -142
  159. package/.agent/skills/tailwind-patterns/SKILL.md +610 -566
  160. package/.agent/skills/tdd-workflow/SKILL.md +169 -161
  161. package/.agent/skills/test-result-analyzer/SKILL.md +313 -309
  162. package/.agent/skills/testing-patterns/SKILL.md +566 -579
  163. package/.agent/skills/trend-researcher/SKILL.md +243 -237
  164. package/.agent/skills/typescript-advanced/SKILL.md +336 -335
  165. package/.agent/skills/ui-ux-pro-max/SKILL.md +590 -562
  166. package/.agent/skills/ui-ux-researcher/SKILL.md +244 -244
  167. package/.agent/skills/vue-expert/SKILL.md +294 -275
  168. package/.agent/skills/vulnerability-scanner/SKILL.md +416 -404
  169. package/.agent/skills/web-accessibility-auditor/SKILL.md +219 -218
  170. package/.agent/skills/web-design-guidelines/SKILL.md +192 -186
  171. package/.agent/skills/webapp-testing/SKILL.md +167 -169
  172. package/.agent/skills/webgpu-performance/SKILL.md +56 -2
  173. package/.agent/skills/whimsy-injector/SKILL.md +346 -325
  174. package/.agent/skills/workflow-optimizer/SKILL.md +231 -229
  175. package/.agent/workflows/acf.md +141 -0
  176. package/.agent/workflows/api-tester.md +176 -151
  177. package/.agent/workflows/audit.md +150 -127
  178. package/.agent/workflows/brainstorm.md +134 -110
  179. package/.agent/workflows/changelog.md +140 -112
  180. package/.agent/workflows/create.md +168 -124
  181. package/.agent/workflows/debug.md +190 -165
  182. package/.agent/workflows/deploy.md +201 -180
  183. package/.agent/workflows/enhance.md +154 -128
  184. package/.agent/workflows/fix.md +136 -114
  185. package/.agent/workflows/generate.md +198 -183
  186. package/.agent/workflows/marathon.md +37 -11
  187. package/.agent/workflows/migrate.md +184 -160
  188. package/.agent/workflows/orchestrate.md +192 -168
  189. package/.agent/workflows/performance-benchmarker.md +135 -114
  190. package/.agent/workflows/plan.md +196 -173
  191. package/.agent/workflows/preview.md +103 -80
  192. package/.agent/workflows/refactor.md +192 -161
  193. package/.agent/workflows/review-ai.md +125 -101
  194. package/.agent/workflows/review.md +141 -116
  195. package/.agent/workflows/session.md +122 -94
  196. package/.agent/workflows/status.md +101 -79
  197. package/.agent/workflows/strengthen-skills.md +164 -138
  198. package/.agent/workflows/super-prompt.md +24 -0
  199. package/.agent/workflows/swarm.md +193 -179
  200. package/.agent/workflows/test.md +211 -189
  201. package/.agent/workflows/tribunal-backend.md +136 -105
  202. package/.agent/workflows/tribunal-database.md +122 -95
  203. package/.agent/workflows/tribunal-frontend.md +221 -96
  204. package/.agent/workflows/tribunal-full.md +129 -100
  205. package/.agent/workflows/tribunal-mobile.md +122 -95
  206. package/.agent/workflows/tribunal-performance.md +136 -110
  207. package/.agent/workflows/tribunal-speed.md +209 -183
  208. package/.agent/workflows/ui-ux-pro-max.md +145 -122
  209. package/README.md +107 -55
  210. package/bin/mcp-server.js +159 -0
  211. package/bin/tribunal-kit.js +105 -29
  212. package/bin/wrapper.js +16 -7
  213. package/mcp_config.json +9 -0
  214. package/package.json +94 -86
  215. package/scripts/changelog.js +4 -3
  216. package/scripts/validate-payload.js +6 -1
  217. package/scripts/postinstall.js +0 -127
@@ -1,6 +1,9 @@
1
1
  ---
2
2
  name: harness-protocol
3
3
  description: Rules and guidelines for the Marathon long-running agent harness
4
+ routing:
5
+ domain: general
6
+ tier: basic
4
7
  ---
5
8
 
6
9
  # Harness Protocol
@@ -16,8 +19,53 @@ This skill enforces the rules for the Marathon long-running agent harness.
16
19
  5. All agents must follow the Verification-Before-Completion (VBC) protocol.
17
20
 
18
21
  ## Pre-Flight Checklist
22
+
19
23
  - Check marathon session state
20
24
  - Confirm VBC guidelines are followed
21
25
 
22
26
  ## VBC Protocol
27
+
23
28
  - Verify task is complete before marking pass
29
+
30
+ ---
31
+
32
+ ## 🤖 LLM-Specific Traps
33
+
34
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
35
+
36
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
37
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
38
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
39
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
40
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
41
+
42
+ ---
43
+
44
+ ## 🏛️ Tribunal Integration (Anti-Hallucination)
45
+
46
+ **Slash command: `/review` or `/tribunal-full`**
47
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
48
+
49
+ ### ❌ Forbidden AI Tropes
50
+
51
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
52
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
53
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
54
+
55
+ ### ✅ Pre-Flight Self-Audit
56
+
57
+ Review these questions before confirming output:
58
+
59
+ ```
60
+ ✅ Did I rely ONLY on real, verified tools and methods?
61
+ ✅ Is this solution appropriately scoped to the user's constraints?
62
+ ✅ Did I handle potential failure modes and edge cases?
63
+ ✅ Have I avoided generic boilerplate that doesn't add value?
64
+ ```
65
+
66
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
67
+
68
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
69
+
70
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
71
+ - ✅ **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,167 +1,176 @@
1
- ---
2
- name: i18n-localization
3
- description: Internationalization (i18n) and localization mastery. Abstracting hardcoded strings, managing JSON/YAML translation dictionaries, bidirectional routing (RTL support for Arabic/Hebrew), Pluralization algorithms, date/currency formatting, and SSR locale detection in Next.js/React. Use when preparing an application for global multilingual scaling.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-02
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- ---
9
-
10
- ## Hallucination Traps (Read First)
11
- - ❌ Concatenating translated strings (`'Hello ' + name`) -> ✅ Use interpolation: `t('greeting', { name })` to handle word order differences
12
- - ❌ Hardcoding date/number formats -> ✅ Use `Intl.DateTimeFormat` and `Intl.NumberFormat` with the user's locale
13
- - Assuming all languages read left-to-right -> ✅ Arabic, Hebrew, Farsi are RTL; use CSS `dir='auto'` and logical properties
14
- - ❌ Using string length for validation on translated text -> ✅ Translations can be 30-200% longer than English; design for expansion
15
-
16
- ---
17
-
18
-
19
- # i18n & Localization — Global Scale Mastery
20
-
21
- ---
22
-
23
- ## 1. The i18n Architecture (Next.js / React)
24
-
25
- Do not hardcode strings inside UI components. Use a standardized library (e.g., `next-intl` or `react-i18next`).
26
-
27
- ### Step 1: Dictionary Abstraction
28
- ```json
29
- // messages/en.json
30
- {
31
- "Dashboard": {
32
- "welcomeMessage": "Welcome back, {name}!",
33
- "unreadAlerts": "{count, plural, =0 {No unread alerts} one {You have 1 unread alert} other {You have # unread alerts}}"
34
- }
35
- }
36
- ```
37
-
38
- ### Step 2: Component Implementation
39
- ```tsx
40
- // ❌ BAD: Hardcoded English text and manual variable interpolation
41
- export function Header({ user, alertCount }) {
42
- return <h1>Welcome back, {user.name}! You have {alertCount} alerts.</h1>;
43
- }
44
-
45
- // GOOD: i18n Abstraction (using next-intl)
46
- import { useTranslations } from 'next-intl';
47
-
48
- export function Header({ user, alertCount }) {
49
- const t = useTranslations('Dashboard');
50
-
51
- return (
52
- <header>
53
- <h1>{t('welcomeMessage', { name: user.name })}</h1>
54
- <p>{t('unreadAlerts', { count: alertCount })}</p>
55
- </header>
56
- );
57
- }
58
- ```
59
-
60
- ---
61
-
62
- ## 2. Advanced Native Formatting (`Intl`)
63
-
64
- Do not install `moment.js` or write massive regex string parsers to format currencies in Euros vs Dollars. The browser handles this natively with the `Intl` API.
65
-
66
- ```typescript
67
- // Data/Currency Formatting correctly tied to the active locale
68
- const locale = 'de-DE';
69
-
70
- // ✅ Currency
71
- const price = new Intl.NumberFormat(locale, { style: 'currency', currency: 'EUR' }).format(1200.50);
72
- // Output in Germany: "1.200,50 €"
73
-
74
- // ✅ Dates
75
- const date = new Intl.DateTimeFormat(locale, { dateStyle: 'full' }).format(new Date());
76
- // Output in Germany: "Freitag, 2. April 2026"
77
-
78
- // ✅ Relative Time
79
- const rtf = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });
80
- rtf.format(-2, 'day'); // Output: "vorgestern" (the day before yesterday)
81
- ```
82
-
83
- ---
84
-
85
- ## 3. Bidirectional Architecture (RTL)
86
-
87
- For languages like Arabic and Hebrew, the UI must fundamentally flip horizontally. Right-To-Left (RTL) breaks standard CSS `marginLeft` and `marginRight`.
88
-
89
- **The Solution:** Logical CSS Properties.
90
- Tailwind v4 (and modern CSS) natively supports logical direction.
91
-
92
- ```css
93
- /* ❌ BAD: Hardcoded physical space */
94
- .btn { margin-left: 10px; } /* Will break layout in Hebrew */
95
-
96
- /* GOOD: Logical spacing (Tailwind: ms-4, me-4) */
97
- .btn { margin-inline-start: 10px; } /* Automatically flips in RTL mode */
98
- ```
99
-
100
- *In React HTML tag:* `<html lang="ar" dir="rtl">`
101
-
102
- ---
103
-
104
- ## 4. Routing and SSR Detection
105
-
106
- Users should not face English UI natively in Japan. Detect their browser headers at the edge routing layer.
107
-
108
- In Next.js Middleware:
109
- 1. Parse the incoming `Accept-Language` header.
110
- 2. Intercept requests to `/dashboard`.
111
- 3. Rewrite URL to the detected locale (e.g., `/ja/dashboard`).
112
-
113
- ---
114
-
115
-
116
- ---
117
-
118
-
119
-
120
- AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
121
-
122
- 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
123
- 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
124
- 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
125
- 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
126
- 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
127
-
128
- ---
129
-
130
-
131
-
132
- **Slash command: `/review` or `/tribunal-full`**
133
- **Active reviewers: `logic-reviewer` · `security-auditor`**
134
-
135
- ### ❌ Forbidden AI Tropes
136
-
137
- 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
138
- 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
139
- 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
140
-
141
-
142
-
143
- Review these questions before confirming output:
144
- ```
145
- ✅ Did I rely ONLY on real, verified tools and methods?
146
- ✅ Is this solution appropriately scoped to the user's constraints?
147
- ✅ Did I handle potential failure modes and edge cases?
148
- ✅ Have I avoided generic boilerplate that doesn't add value?
149
- ```
150
-
151
- ### 🛑 Verification-Before-Completion (VBC) Protocol
152
-
153
- **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
154
- - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
155
- - ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing tests, compile success, or equivalent proof) that your output works as intended.
156
-
157
-
158
- ## Pre-Flight Checklist
159
- - [ ] Have I reviewed the user's specific constraints and requests?
160
- - [ ] Have I checked the environment for relevant existing implementations?
161
-
162
- ## VBC Protocol (Verification-Before-Completion)
163
- You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
1
+ ---
2
+ name: i18n-localization
3
+ description: Internationalization (i18n) and localization mastery. Abstracting hardcoded strings, managing JSON/YAML translation dictionaries, bidirectional routing (RTL support for Arabic/Hebrew), Pluralization algorithms, date/currency formatting, and SSR locale detection in Next.js/React. Use when preparing an application for global multilingual scaling.
4
+ allowed-tools: Read, Write, Edit, Glob, Grep
5
+ version: 2.0.0
6
+ last-updated: 2026-04-02
7
+ applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
+ routing:
9
+ domain: general
10
+ tier: basic
11
+ ---
12
+
13
+ ## Hallucination Traps (Read First)
14
+
15
+ - ❌ Concatenating translated strings (`'Hello ' + name`) -> ✅ Use interpolation: `t('greeting', { name })` to handle word order differences
16
+ - ❌ Hardcoding date/number formats -> ✅ Use `Intl.DateTimeFormat` and `Intl.NumberFormat` with the user's locale
17
+ - ❌ Assuming all languages read left-to-right -> ✅ Arabic, Hebrew, Farsi are RTL; use CSS `dir='auto'` and logical properties
18
+ - ❌ Using string length for validation on translated text -> ✅ Translations can be 30-200% longer than English; design for expansion
19
+
20
+ ---
21
+
22
+ # i18n & Localization — Global Scale Mastery
23
+
24
+ ---
25
+
26
+ ## 1. The i18n Architecture (Next.js / React)
27
+
28
+ Do not hardcode strings inside UI components. Use a standardized library (e.g., `next-intl` or `react-i18next`).
29
+
30
+ ### Step 1: Dictionary Abstraction
31
+
32
+ ```json
33
+ // messages/en.json
34
+ {
35
+ "Dashboard": {
36
+ "welcomeMessage": "Welcome back, {name}!",
37
+ "unreadAlerts": "{count, plural, =0 {No unread alerts} one {You have 1 unread alert} other {You have # unread alerts}}"
38
+ }
39
+ }
40
+ ```
41
+
42
+ ### Step 2: Component Implementation
43
+
44
+ ```tsx
45
+ // BAD: Hardcoded English text and manual variable interpolation
46
+ export function Header({ user, alertCount }) {
47
+ return (
48
+ <h1>
49
+ Welcome back, {user.name}! You have {alertCount} alerts.
50
+ </h1>
51
+ );
52
+ }
53
+
54
+ // GOOD: i18n Abstraction (using next-intl)
55
+ import { useTranslations } from "next-intl";
56
+
57
+ export function Header({ user, alertCount }) {
58
+ const t = useTranslations("Dashboard");
59
+
60
+ return (
61
+ <header>
62
+ <h1>{t("welcomeMessage", { name: user.name })}</h1>
63
+ <p>{t("unreadAlerts", { count: alertCount })}</p>
64
+ </header>
65
+ );
66
+ }
67
+ ```
68
+
69
+ ---
70
+
71
+ ## 2. Advanced Native Formatting (`Intl`)
72
+
73
+ Do not install `moment.js` or write massive regex string parsers to format currencies in Euros vs Dollars. The browser handles this natively with the `Intl` API.
74
+
75
+ ```typescript
76
+ // Data/Currency Formatting correctly tied to the active locale
77
+ const locale = "de-DE";
78
+
79
+ // Currency
80
+ const price = new Intl.NumberFormat(locale, { style: "currency", currency: "EUR" }).format(1200.5);
81
+ // Output in Germany: "1.200,50 €"
82
+
83
+ // ✅ Dates
84
+ const date = new Intl.DateTimeFormat(locale, { dateStyle: "full" }).format(new Date());
85
+ // Output in Germany: "Freitag, 2. April 2026"
86
+
87
+ // Relative Time
88
+ const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
89
+ rtf.format(-2, "day"); // Output: "vorgestern" (the day before yesterday)
90
+ ```
91
+
92
+ ---
93
+
94
+ ## 3. Bidirectional Architecture (RTL)
95
+
96
+ For languages like Arabic and Hebrew, the UI must fundamentally flip horizontally. Right-To-Left (RTL) breaks standard CSS `marginLeft` and `marginRight`.
97
+
98
+ **The Solution:** Logical CSS Properties.
99
+ Tailwind v4 (and modern CSS) natively supports logical direction.
100
+
101
+ ```css
102
+ /* ❌ BAD: Hardcoded physical space */
103
+ .btn {
104
+ margin-left: 10px;
105
+ } /* Will break layout in Hebrew */
106
+
107
+ /* ✅ GOOD: Logical spacing (Tailwind: ms-4, me-4) */
108
+ .btn {
109
+ margin-inline-start: 10px;
110
+ } /* Automatically flips in RTL mode */
111
+ ```
112
+
113
+ _In React HTML tag:_ `<html lang="ar" dir="rtl">`
114
+
115
+ ---
116
+
117
+ ## 4. Routing and SSR Detection
118
+
119
+ Users should not face English UI natively in Japan. Detect their browser headers at the edge routing layer.
120
+
121
+ In Next.js Middleware:
122
+
123
+ 1. Parse the incoming `Accept-Language` header.
124
+ 2. Intercept requests to `/dashboard`.
125
+ 3. Rewrite URL to the detected locale (e.g., `/ja/dashboard`).
164
126
 
127
+ ---
128
+
129
+ ---
130
+
131
+ AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
132
+
133
+ 1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
134
+ 2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
135
+ 3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
136
+ 4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
137
+ 5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
138
+
139
+ ---
140
+
141
+ **Slash command: `/review` or `/tribunal-full`**
142
+ **Active reviewers: `logic-reviewer` · `security-auditor`**
143
+
144
+ ### ❌ Forbidden AI Tropes
145
+
146
+ 1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
147
+ 2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
148
+ 3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
149
+
150
+ Review these questions before confirming output:
151
+
152
+ ```
153
+ ✅ Did I rely ONLY on real, verified tools and methods?
154
+ ✅ Is this solution appropriately scoped to the user's constraints?
155
+ ✅ Did I handle potential failure modes and edge cases?
156
+ ✅ Have I avoided generic boilerplate that doesn't add value?
157
+ ```
158
+
159
+ ### 🛑 Verification-Before-Completion (VBC) Protocol
160
+
161
+ **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
162
+
163
+ - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
164
+ - ✅ **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.
165
+
166
+ ## Pre-Flight Checklist
167
+
168
+ - [ ] Have I reviewed the user's specific constraints and requests?
169
+ - [ ] Have I checked the environment for relevant existing implementations?
170
+
171
+ ## VBC Protocol (Verification-Before-Completion)
172
+
173
+ You MUST verify existing code signatures and variables before attempting to modify or call them. No hallucination is permitted.
165
174
 
166
175
  ---
167
176
 
@@ -191,6 +200,7 @@ AI coding assistants often fall into specific bad habits when dealing with this
191
200
  ### ✅ Pre-Flight Self-Audit
192
201
 
193
202
  Review these questions before confirming output:
203
+
194
204
  ```
195
205
  ✅ Did I rely ONLY on real, verified tools and methods?
196
206
  ✅ Is this solution appropriately scoped to the user's constraints?
@@ -201,5 +211,6 @@ Review these questions before confirming output:
201
211
  ### 🛑 Verification-Before-Completion (VBC) Protocol
202
212
 
203
213
  **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
214
+
204
215
  - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
205
216
  - ✅ **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.