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.
- package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
- package/.agent/ARCHITECTURE.md +279 -277
- package/.agent/GEMINI.md +127 -121
- package/.agent/agents/accessibility-reviewer.md +187 -187
- package/.agent/agents/ai-code-reviewer.md +199 -199
- package/.agent/agents/api-architect.md +71 -66
- package/.agent/agents/backend-specialist.md +219 -215
- package/.agent/agents/cloud-engineer.md +98 -0
- package/.agent/agents/code-archaeologist.md +168 -161
- package/.agent/agents/database-architect.md +184 -184
- package/.agent/agents/db-latency-auditor.md +213 -216
- package/.agent/agents/debugger.md +198 -191
- package/.agent/agents/dependency-reviewer.md +106 -103
- package/.agent/agents/devops-engineer.md +218 -218
- package/.agent/agents/documentation-writer.md +209 -201
- package/.agent/agents/explorer-agent.md +167 -160
- package/.agent/agents/frontend-reviewer.md +162 -160
- package/.agent/agents/frontend-specialist.md +257 -248
- package/.agent/agents/game-developer.md +48 -48
- package/.agent/agents/logic-reviewer.md +118 -116
- package/.agent/agents/mobile-developer.md +197 -200
- package/.agent/agents/mobile-reviewer.md +159 -162
- package/.agent/agents/orchestrator.md +187 -181
- package/.agent/agents/penetration-tester.md +160 -157
- package/.agent/agents/performance-optimizer.md +183 -183
- package/.agent/agents/performance-reviewer.md +178 -178
- package/.agent/agents/precedence-reviewer.md +251 -250
- package/.agent/agents/product-manager.md +149 -142
- package/.agent/agents/product-owner.md +81 -80
- package/.agent/agents/project-planner.md +152 -142
- package/.agent/agents/qa-automation-engineer.md +216 -225
- package/.agent/agents/resilience-reviewer.md +88 -88
- package/.agent/agents/schema-reviewer.md +67 -67
- package/.agent/agents/security-auditor.md +180 -174
- package/.agent/agents/seo-specialist.md +188 -193
- package/.agent/agents/sql-reviewer.md +159 -161
- package/.agent/agents/supervisor-agent.md +173 -184
- package/.agent/agents/swarm-worker-contracts.md +170 -166
- package/.agent/agents/swarm-worker-registry.md +92 -92
- package/.agent/agents/system-architect.md +85 -0
- package/.agent/agents/test-coverage-reviewer.md +158 -160
- package/.agent/agents/test-engineer.md +118 -118
- package/.agent/agents/throughput-optimizer.md +291 -299
- package/.agent/agents/type-safety-reviewer.md +182 -175
- package/.agent/agents/ui-ux-auditor.md +300 -292
- package/.agent/agents/vitals-reviewer.md +223 -223
- package/.agent/mcp_config.json +37 -40
- package/.agent/patterns/generator.md +11 -9
- package/.agent/patterns/inversion.md +14 -12
- package/.agent/patterns/pipeline.md +11 -9
- package/.agent/patterns/reviewer.md +15 -13
- package/.agent/patterns/tool-wrapper.md +11 -9
- package/.agent/routing_index.json +654 -0
- package/.agent/rules/GEMINI.md +358 -352
- package/.agent/scripts/compile_router.py +112 -0
- package/.agent/scripts/migrate_skills_frontmatter.py +64 -0
- package/.agent/scripts/strengthen_skills.js +1 -1
- package/.agent/skills/advanced-rag-pipelines/SKILL.md +56 -0
- package/.agent/skills/agent-organizer/SKILL.md +156 -150
- package/.agent/skills/agentic-patterns/SKILL.md +313 -315
- package/.agent/skills/ai-prompt-injection-defense/SKILL.md +190 -184
- package/.agent/skills/api-patterns/SKILL.md +253 -247
- package/.agent/skills/api-security-auditor/SKILL.md +195 -193
- package/.agent/skills/app-builder/SKILL.md +573 -572
- package/.agent/skills/app-builder/templates/SKILL.md +108 -115
- package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
- package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
- package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
- package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
- package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
- package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
- package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
- package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -122
- package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -122
- package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -169
- package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -134
- package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
- package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -119
- package/.agent/skills/appflow-wireframe/SKILL.md +146 -145
- package/.agent/skills/architecture/SKILL.md +226 -219
- package/.agent/skills/authentication-best-practices/SKILL.md +197 -189
- package/.agent/skills/backend-security-expert/SKILL.md +16 -2
- package/.agent/skills/bash-linux/SKILL.md +179 -179
- package/.agent/skills/behavioral-modes/SKILL.md +239 -223
- package/.agent/skills/brainstorming/SKILL.md +498 -486
- package/.agent/skills/browser-native-ai/SKILL.md +57 -4
- package/.agent/skills/building-native-ui/SKILL.md +202 -202
- package/.agent/skills/cicd-pro/SKILL.md +442 -0
- package/.agent/skills/clean-code/SKILL.md +400 -381
- package/.agent/skills/cloud-architect/SKILL.md +439 -0
- package/.agent/skills/code-review-checklist/SKILL.md +203 -194
- package/.agent/skills/config-validator/SKILL.md +165 -165
- package/.agent/skills/containerization-pro/SKILL.md +452 -0
- package/.agent/skills/csharp-developer/SKILL.md +518 -518
- package/.agent/skills/data-validation-schemas/SKILL.md +333 -328
- package/.agent/skills/database-design/SKILL.md +247 -240
- package/.agent/skills/deployment-procedures/SKILL.md +172 -169
- package/.agent/skills/devops-engineer/SKILL.md +345 -345
- package/.agent/skills/devops-incident-responder/SKILL.md +143 -137
- package/.agent/skills/doc.md +209 -177
- package/.agent/skills/documentation-templates/SKILL.md +291 -279
- package/.agent/skills/edge-computing/SKILL.md +183 -181
- package/.agent/skills/error-resilience/SKILL.md +411 -428
- package/.agent/skills/extract-design-system/SKILL.md +160 -158
- package/.agent/skills/framer-motion-expert/SKILL.md +253 -244
- package/.agent/skills/frontend-design/SKILL.md +208 -201
- package/.agent/skills/frontend-security-expert/SKILL.md +16 -3
- package/.agent/skills/game-design-expert/SKILL.md +132 -129
- package/.agent/skills/game-engineering-expert/SKILL.md +148 -146
- package/.agent/skills/generative-ui-expert/SKILL.md +57 -1
- package/.agent/skills/geo-fundamentals/SKILL.md +148 -147
- package/.agent/skills/git-pro/SKILL.md +435 -0
- package/.agent/skills/github-operations/SKILL.md +335 -329
- package/.agent/skills/gsap-core/SKILL.md +319 -308
- package/.agent/skills/gsap-frameworks/SKILL.md +213 -207
- package/.agent/skills/gsap-performance/SKILL.md +139 -133
- package/.agent/skills/gsap-plugins/SKILL.md +486 -480
- package/.agent/skills/gsap-react/SKILL.md +202 -189
- package/.agent/skills/gsap-scrolltrigger/SKILL.md +357 -350
- package/.agent/skills/gsap-timeline/SKILL.md +165 -161
- package/.agent/skills/gsap-utils/SKILL.md +344 -338
- package/.agent/skills/harness-protocol/SKILL.md +48 -0
- package/.agent/skills/i18n-localization/SKILL.md +174 -163
- package/.agent/skills/intelligent-routing/SKILL.md +202 -246
- package/.agent/skills/knowledge-graph/SKILL.md +60 -52
- package/.agent/skills/lint-and-validate/SKILL.md +261 -261
- package/.agent/skills/llm-engineering/SKILL.md +400 -394
- package/.agent/skills/local-first/SKILL.md +178 -178
- package/.agent/skills/mcp-builder/SKILL.md +143 -142
- package/.agent/skills/mobile-design/SKILL.md +272 -263
- package/.agent/skills/monorepo-management/SKILL.md +335 -334
- package/.agent/skills/motion-engineering/SKILL.md +266 -234
- package/.agent/skills/nextjs-react-expert/SKILL.md +236 -234
- package/.agent/skills/nodejs-best-practices/SKILL.md +547 -548
- package/.agent/skills/observability/SKILL.md +343 -343
- package/.agent/skills/parallel-agents/SKILL.md +143 -146
- package/.agent/skills/performance-profiling/SKILL.md +259 -267
- package/.agent/skills/plan-writing/SKILL.md +150 -142
- package/.agent/skills/platform-engineer/SKILL.md +148 -147
- package/.agent/skills/playwright-best-practices/SKILL.md +188 -187
- package/.agent/skills/powershell-windows/SKILL.md +162 -162
- package/.agent/skills/project-idioms/SKILL.md +137 -137
- package/.agent/skills/python-patterns/SKILL.md +260 -259
- package/.agent/skills/python-pro/SKILL.md +324 -323
- package/.agent/skills/react-specialist/SKILL.md +305 -277
- package/.agent/skills/readme-builder/SKILL.md +310 -300
- package/.agent/skills/realtime-patterns/SKILL.md +323 -319
- package/.agent/skills/red-team-tactics/SKILL.md +231 -218
- package/.agent/skills/rust-pro/SKILL.md +671 -673
- package/.agent/skills/seo-fundamentals/SKILL.md +179 -179
- package/.agent/skills/server-management/SKILL.md +218 -214
- package/.agent/skills/shadcn-ui-expert/SKILL.md +231 -231
- package/.agent/skills/skill-creator/SKILL.md +87 -86
- package/.agent/skills/sql-pro/SKILL.md +629 -629
- package/.agent/skills/supabase-postgres-best-practices/SKILL.md +97 -97
- package/.agent/skills/swiftui-expert/SKILL.md +204 -201
- package/.agent/skills/system-design-pro/SKILL.md +345 -0
- package/.agent/skills/systematic-debugging/SKILL.md +153 -142
- package/.agent/skills/tailwind-patterns/SKILL.md +610 -566
- package/.agent/skills/tdd-workflow/SKILL.md +169 -161
- package/.agent/skills/test-result-analyzer/SKILL.md +313 -309
- package/.agent/skills/testing-patterns/SKILL.md +566 -579
- package/.agent/skills/trend-researcher/SKILL.md +243 -237
- package/.agent/skills/typescript-advanced/SKILL.md +336 -335
- package/.agent/skills/ui-ux-pro-max/SKILL.md +590 -562
- package/.agent/skills/ui-ux-researcher/SKILL.md +244 -244
- package/.agent/skills/vue-expert/SKILL.md +294 -275
- package/.agent/skills/vulnerability-scanner/SKILL.md +416 -404
- package/.agent/skills/web-accessibility-auditor/SKILL.md +219 -218
- package/.agent/skills/web-design-guidelines/SKILL.md +192 -186
- package/.agent/skills/webapp-testing/SKILL.md +167 -169
- package/.agent/skills/webgpu-performance/SKILL.md +56 -2
- package/.agent/skills/whimsy-injector/SKILL.md +346 -325
- package/.agent/skills/workflow-optimizer/SKILL.md +231 -229
- package/.agent/workflows/acf.md +141 -0
- package/.agent/workflows/api-tester.md +176 -151
- package/.agent/workflows/audit.md +150 -127
- package/.agent/workflows/brainstorm.md +134 -110
- package/.agent/workflows/changelog.md +140 -112
- package/.agent/workflows/create.md +168 -124
- package/.agent/workflows/debug.md +190 -165
- package/.agent/workflows/deploy.md +201 -180
- package/.agent/workflows/enhance.md +154 -128
- package/.agent/workflows/fix.md +136 -114
- package/.agent/workflows/generate.md +198 -183
- package/.agent/workflows/marathon.md +37 -11
- package/.agent/workflows/migrate.md +184 -160
- package/.agent/workflows/orchestrate.md +192 -168
- package/.agent/workflows/performance-benchmarker.md +135 -114
- package/.agent/workflows/plan.md +196 -173
- package/.agent/workflows/preview.md +103 -80
- package/.agent/workflows/refactor.md +192 -161
- package/.agent/workflows/review-ai.md +125 -101
- package/.agent/workflows/review.md +141 -116
- package/.agent/workflows/session.md +122 -94
- package/.agent/workflows/status.md +101 -79
- package/.agent/workflows/strengthen-skills.md +164 -138
- package/.agent/workflows/super-prompt.md +24 -0
- package/.agent/workflows/swarm.md +193 -179
- package/.agent/workflows/test.md +211 -189
- package/.agent/workflows/tribunal-backend.md +136 -105
- package/.agent/workflows/tribunal-database.md +122 -95
- package/.agent/workflows/tribunal-frontend.md +221 -96
- package/.agent/workflows/tribunal-full.md +129 -100
- package/.agent/workflows/tribunal-mobile.md +122 -95
- package/.agent/workflows/tribunal-performance.md +136 -110
- package/.agent/workflows/tribunal-speed.md +209 -183
- package/.agent/workflows/ui-ux-pro-max.md +145 -122
- package/README.md +107 -55
- package/bin/mcp-server.js +159 -0
- package/bin/tribunal-kit.js +105 -29
- package/bin/wrapper.js +16 -7
- package/mcp_config.json +9 -0
- package/package.json +94 -86
- package/scripts/changelog.js +4 -3
- package/scripts/validate-payload.js +6 -1
- 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
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
//
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
//
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
.
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
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.
|