tribunal-kit 9.2.4 → 9.2.5

package/.agent/workflows/tribunal-full.md

@@ -1,156 +1,156 @@
----
-description: Runs ALL 28 parallel reviewers simultaneously. Maximum hallucination coverage. Use before merging any AI-generated code, before production deployments, or when maximum confidence is required.
-tools: Read, Grep, Glob, Bash, Edit, Write
-version: 3.0.0
-last-updated: 2026-07-30
-required-skills:
-  - clean-code
-  - backend-security-expert
-  - frontend-design
-  - database-design
-  - mobile-design
-  - performance-profiling
-scripts-binding:
-  - .agent/scripts/security_scan.js
-  - .agent/scripts/dependency_analyzer.js
-  - .agent/scripts/lint_runner.js
-  - .agent/scripts/schema_validator.js
-  - .agent/scripts/test_runner.js
-  - .agent/scripts/bundle_analyzer.js
-  - .agent/scripts/verify_all.js
----
-
-# /tribunal-full — Complete 28-Reviewer Audit
-
-$ARGUMENTS
-
----
-
-## Mandatory Pre-Flight Context Inspection
-
-Before launching the full 28-reviewer audit, you MUST inspect:
-
-1. Pending Code Modifications (`git diff` / modified files) → Inspect diffs across all domains (frontend, backend, database, mobile)
-2. Workspace Configuration Context (`package.json`, `tsconfig.json`, `tailwind.config`) → Verify project build contracts
-3. 28-Reviewer Synthesis Gate → Execute all 28 specialized reviewers in parallel; halt on any security violation or critical bug before Human Gate approval
-
-4. Required Skills → Before executing, load and follow procedural rules from:
-   - `clean-code` (.agent/skills/clean-code/SKILL.md): Self-documenting naming, no over-engineering, error handling patterns
-   - `backend-security-expert` (.agent/skills/backend-security-expert/SKILL.md): Server-side security, auth, JWT, ORM injection, RBAC
-   - `frontend-design` (.agent/skills/frontend-design/SKILL.md): Design engineering with OKLCH color syntax, spatial grid math
-   - `database-design` (.agent/skills/database-design/SKILL.md): Schema normalization, indexing, migration strategy
-   - `mobile-design` (.agent/skills/mobile-design/SKILL.md): Mobile-first design for iOS, Android, touch, haptics, 120Hz
-   - `performance-profiling` (.agent/skills/performance-profiling/SKILL.md): Performance measurement methodology and profiling tools
-
----
-
-## When to Use /tribunal-full
-
-| Use `/tribunal-full` when...         | Use targeted tribunal when...        |
-| :----------------------------------- | :----------------------------------- |
-| Before merging any AI-generated code | Backend only → `/tribunal-backend`   |
-| Before production deployment         | Frontend only → `/tribunal-frontend` |
-| Security-critical feature review     | DB only → `/tribunal-database`       |
-| Code affects auth, payments, or PII  |                                      |
-| Maximum confidence required          |                                      |
-
----
-
-## 28 Reviewers — Stage-Partitioned Execution (3 Waves)
-
-To eliminate context window saturation and reviewer attention dilution, the 28 reviewers execute in 3 partitioned passes:
-
-```
-Wave 1: Core Integrity & Precedences (Pass 1)
-├── precedence-reviewer    → Checks local repo Case Law for past rejections
-├── logic-reviewer         → Hallucinated methods, impossible logic, undefined refs
-├── schema-reviewer        → Missing input validation, loose schemas, raw req.body
-└── resilience-reviewer    → Swallowed errors, unhandled rejections, missing retries
-
-Wave 2: Security, Types & Code Quality (Pass 2)
-├── security-auditor       → OWASP 2025, injection, JWT, SSRF, IDOR
-├── dependency-reviewer    → Fabricated packages, supply chain, version compatibility
-├── type-safety-reviewer   → 'any' epidemic, Zod parse vs cast, unguarded access
-├── complexity-reviewer    → Enforces the Dependency Ladder to prevent over-engineering
-└── sql-reviewer           → Injection, N+1, missing indexes, unscoped mutations
-
-Wave 3: Domain, UI & Performance (Pass 3)
-├── frontend-reviewer      → React 19 APIs, RSC violations, hook rules, hydration
-├── performance-reviewer   → Core Web Vitals targets, re-render cascades, memory leaks
-├── mobile-reviewer        → Reanimated thread safety, FlashList, safe area insets
-├── ai-code-reviewer       → Model name hallucinations, prompt injection, cost explosion
-├── test-coverage-reviewer → Happy path only, brittle selectors, missing edge cases
-├── accessibility-reviewer → WCAG 2.2 AA, ARIA misuse, focus management, live regions
-├── ui-ux-auditor          → Generic AI aesthetics, missing hover states, contrast
-├── review-animations      → UI animations >300ms, origin-unaware popovers, ease-in
-├── vitals-reviewer        → Frontend CWV depth: Suspense waterfalls, paint jank
-├── db-latency-auditor     → DB layer: N+1, unbounded queries, unindexed WHERE
-└── throughput-optimizer   → Server runtime: event-loop blocks, serialized awaits
-```
-
----
-
-## Active Reviewers by Code Type
-
-Not all 28 reviewers produce meaningful findings on all code types. Active reviewers detect their first finding immediately — inactive reviewers auto-pass with "N/A for this code type."
-
-| Code Under Review   | Critical Reviewers                                                |
-| :------------------ | :---------------------------------------------------------------- |
-| REST API route      | logic, security, dependency, type-safety, sql, schema, resilience |
-| React component     | logic, frontend, accessibility, type-safety, resilience, ui-ux    |
-| Database query      | logic, security, sql, resilience                                  |
-| AI LLM integration  | logic, security, ai-code, dependency                              |
-| Test file           | test-coverage, logic                                              |
-| React Native / Expo | mobile, logic, security, performance, ui-ux                       |
-| Next.js page        | logic, frontend, performance, accessibility, ui-ux                |
-| Auth/JWT code       | security, logic, type-safety                                      |
-
----
-
-## Verdict Aggregation
-
-```
-All 28 verdicts are collected. Aggregated result:
-
-If ANY reviewer = ❌ REJECTED → Global verdict: ❌ REJECTED (must fix before Human Gate)
-If any reviewer = ⚠️ WARNING  → Global verdict: ⚠️ WARNINGS (proceed with attention)
-If all reviewers = ✅ APPROVED → Global verdict: ✅ APPROVED (proceed to Human Gate)
-```
-
----
-
-## Retry Protocol
-
-When code is rejected:
-
-```
-Attempt 1: Maker revises with reviewer feedback
-Attempt 2: Maker revises with stricter constraints + full reviewer context
-Attempt 3: Maker revises with maximum constraints + full context dump
-
-After 3 failed attempts:
-  → HALT
-  → Report to human with full failure history
-  → DO NOT retry silently
-```
-
----
-
-## Usage Examples
-
-```
-/tribunal-full audit all changes since last commit
-```
-
----
-
-## After /tribunal-full — Next Steps
-
-| Outcome                    | Next Command                                   |
-| :------------------------- | :--------------------------------------------- |
-| All 28 reviewers approve   | → `/deploy` — highest confidence state         |
-| Reject with multiple fixes | → `/fix` for simple issues, `/debug` for logic |
-| Performance rejection      | → `/tribunal-speed` for granular profiling     |
-| Security rejection         | → Immediate `/tribunal-backend` to resolve     |
-
----
+---
+description: Runs ALL 28 parallel reviewers simultaneously. Maximum hallucination coverage. Use before merging any AI-generated code, before production deployments, or when maximum confidence is required.
+tools: Read, Grep, Glob, Bash, Edit, Write
+version: 3.0.0
+last-updated: 2026-07-30
+required-skills:
+  - clean-code
+  - backend-security-expert
+  - frontend-design
+  - database-design
+  - mobile-design
+  - performance-profiling
+scripts-binding:
+  - .agent/scripts/security_scan.js
+  - .agent/scripts/dependency_analyzer.js
+  - .agent/scripts/lint_runner.js
+  - .agent/scripts/schema_validator.js
+  - .agent/scripts/test_runner.js
+  - .agent/scripts/bundle_analyzer.js
+  - .agent/scripts/verify_all.js
+---
+
+# /tribunal-full — Complete 28-Reviewer Audit
+
+$ARGUMENTS
+
+---
+
+## Mandatory Pre-Flight Context Inspection
+
+Before launching the full 28-reviewer audit, you MUST inspect:
+
+1. Pending Code Modifications (`git diff` / modified files) → Inspect diffs across all domains (frontend, backend, database, mobile)
+2. Workspace Configuration Context (`package.json`, `tsconfig.json`, `tailwind.config`) → Verify project build contracts
+3. 28-Reviewer Synthesis Gate → Execute all 28 specialized reviewers in parallel; halt on any security violation or critical bug before Human Gate approval
+
+4. Required Skills → Before executing, load and follow procedural rules from:
+   - `clean-code` (.agent/skills/clean-code/SKILL.md): Self-documenting naming, no over-engineering, error handling patterns
+   - `backend-security-expert` (.agent/skills/backend-security-expert/SKILL.md): Server-side security, auth, JWT, ORM injection, RBAC
+   - `frontend-design` (.agent/skills/frontend-design/SKILL.md): Design engineering with OKLCH color syntax, spatial grid math
+   - `database-design` (.agent/skills/database-design/SKILL.md): Schema normalization, indexing, migration strategy
+   - `mobile-design` (.agent/skills/mobile-design/SKILL.md): Mobile-first design for iOS, Android, touch, haptics, 120Hz
+   - `performance-profiling` (.agent/skills/performance-profiling/SKILL.md): Performance measurement methodology and profiling tools
+
+---
+
+## When to Use /tribunal-full
+
+| Use `/tribunal-full` when...         | Use targeted tribunal when...        |
+| :----------------------------------- | :----------------------------------- |
+| Before merging any AI-generated code | Backend only → `/tribunal-backend`   |
+| Before production deployment         | Frontend only → `/tribunal-frontend` |
+| Security-critical feature review     | DB only → `/tribunal-database`       |
+| Code affects auth, payments, or PII  |                                      |
+| Maximum confidence required          |                                      |
+
+---
+
+## 28 Reviewers — Stage-Partitioned Execution (3 Waves)
+
+To eliminate context window saturation and reviewer attention dilution, the 28 reviewers execute in 3 partitioned passes:
+
+```
+Wave 1: Core Integrity & Precedences (Pass 1)
+├── precedence-reviewer    → Checks local repo Case Law for past rejections
+├── logic-reviewer         → Hallucinated methods, impossible logic, undefined refs
+├── schema-reviewer        → Missing input validation, loose schemas, raw req.body
+└── resilience-reviewer    → Swallowed errors, unhandled rejections, missing retries
+
+Wave 2: Security, Types & Code Quality (Pass 2)
+├── security-auditor       → OWASP 2025, injection, JWT, SSRF, IDOR
+├── dependency-reviewer    → Fabricated packages, supply chain, version compatibility
+├── type-safety-reviewer   → 'any' epidemic, Zod parse vs cast, unguarded access
+├── complexity-reviewer    → Enforces the Dependency Ladder to prevent over-engineering
+└── sql-reviewer           → Injection, N+1, missing indexes, unscoped mutations
+
+Wave 3: Domain, UI & Performance (Pass 3)
+├── frontend-reviewer      → React 19 APIs, RSC violations, hook rules, hydration
+├── performance-reviewer   → Core Web Vitals targets, re-render cascades, memory leaks
+├── mobile-reviewer        → Reanimated thread safety, FlashList, safe area insets
+├── ai-code-reviewer       → Model name hallucinations, prompt injection, cost explosion
+├── test-coverage-reviewer → Happy path only, brittle selectors, missing edge cases
+├── accessibility-reviewer → WCAG 2.2 AA, ARIA misuse, focus management, live regions
+├── ui-ux-auditor          → Generic AI aesthetics, missing hover states, contrast
+├── review-animations      → UI animations >300ms, origin-unaware popovers, ease-in
+├── vitals-reviewer        → Frontend CWV depth: Suspense waterfalls, paint jank
+├── db-latency-auditor     → DB layer: N+1, unbounded queries, unindexed WHERE
+└── throughput-optimizer   → Server runtime: event-loop blocks, serialized awaits
+```
+
+---
+
+## Active Reviewers by Code Type
+
+Not all 28 reviewers produce meaningful findings on all code types. Active reviewers detect their first finding immediately — inactive reviewers auto-pass with "N/A for this code type."
+
+| Code Under Review   | Critical Reviewers                                                |
+| :------------------ | :---------------------------------------------------------------- |
+| REST API route      | logic, security, dependency, type-safety, sql, schema, resilience |
+| React component     | logic, frontend, accessibility, type-safety, resilience, ui-ux    |
+| Database query      | logic, security, sql, resilience                                  |
+| AI LLM integration  | logic, security, ai-code, dependency                              |
+| Test file           | test-coverage, logic                                              |
+| React Native / Expo | mobile, logic, security, performance, ui-ux                       |
+| Next.js page        | logic, frontend, performance, accessibility, ui-ux                |
+| Auth/JWT code       | security, logic, type-safety                                      |
+
+---
+
+## Verdict Aggregation
+
+```
+All 28 verdicts are collected. Aggregated result:
+
+If ANY reviewer = ❌ REJECTED → Global verdict: ❌ REJECTED (must fix before Human Gate)
+If any reviewer = ⚠️ WARNING  → Global verdict: ⚠️ WARNINGS (proceed with attention)
+If all reviewers = ✅ APPROVED → Global verdict: ✅ APPROVED (proceed to Human Gate)
+```
+
+---
+
+## Retry Protocol
+
+When code is rejected:
+
+```
+Attempt 1: Maker revises with reviewer feedback
+Attempt 2: Maker revises with stricter constraints + full reviewer context
+Attempt 3: Maker revises with maximum constraints + full context dump
+
+After 3 failed attempts:
+  → HALT
+  → Report to human with full failure history
+  → DO NOT retry silently
+```
+
+---
+
+## Usage Examples
+
+```
+/tribunal-full audit all changes since last commit
+```
+
+---
+
+## After /tribunal-full — Next Steps
+
+| Outcome                    | Next Command                                   |
+| :------------------------- | :--------------------------------------------- |
+| All 28 reviewers approve   | → `/deploy` — highest confidence state         |
+| Reject with multiple fixes | → `/fix` for simple issues, `/debug` for logic |
+| Performance rejection      | → `/tribunal-speed` for granular profiling     |
+| Security rejection         | → Immediate `/tribunal-backend` to resolve     |
+
+---

package/.agent/workflows/tribunal-mobile.md

@@ -1,142 +1,142 @@
----
-description: Mobile-specific Tribunal. Runs Logic + Security + Mobile reviewers. Use for React Native, Expo, gesture handlers, animations, navigation, and any iOS/Android-targeted code.
-tools: Read, Grep, Glob, Bash, Edit, Write
-version: 3.0.0
-last-updated: 2026-07-30
-required-skills:
-  - building-native-ui
-  - mobile-design
-  - swiftui-expert
-scripts-binding:
-  - .agent/scripts/lint_runner.js
-  - .agent/scripts/security_scan.js
----
-
-# /tribunal-mobile — Mobile Code Audit
-
-$ARGUMENTS
-
----
-
-## Mandatory Pre-Flight Context Inspection
-
-Before auditing React Native, Expo, or native mobile code, you MUST inspect:
-
-1. Native Configuration Manifests (`app.json`, `app.config.js`, `package.json`) → Verify Expo SDK version, Reanimated dependencies, and permissions
-2. Gesture & 60fps Motion Rules → Enforce `react-native-reanimated` worklets on UI thread; ban JavaScript bridge layout thrashing
-3. 28-Reviewer Mobile Gate → Run logic-reviewer, security-auditor, and mobile-reviewer before approving mobile component diffs
-
-4. Required Skills → Before executing, load and follow procedural rules from:
-   - `building-native-ui` (.agent/skills/building-native-ui/SKILL.md): Native UI component patterns for cross-platform apps
-   - `mobile-design` (.agent/skills/mobile-design/SKILL.md): Mobile-first design for iOS, Android, touch, haptics, 120Hz
-   - `swiftui-expert` (.agent/skills/swiftui-expert/SKILL.md): SwiftUI declarative UI, @Observable, NavigationStack, Charts
-
----
-
-## When to Use /tribunal-mobile
-
-| Use `/tribunal-mobile` when...       | Use something else when...                 |
-| :----------------------------------- | :----------------------------------------- |
-| React Native components              | Web-only components → `/tribunal-frontend` |
-| Expo Router navigation               | API routes → `/tribunal-backend`           |
-| Reanimated animations/gestures       | Full audit → `/tribunal-full`              |
-| FlashList / FlatList code            |                                            |
-| Platform-specific (ios/android) code |                                            |
-
----
-
-## 4 Active Reviewers (All Run Simultaneously)
-
-### precedence-reviewer → Checks local repo Case Law for past rejections
-
-logic-reviewer
-
-- `runOnJS` called inside `onUpdate` instead of `onEnd` (runs every frame)
-- Missing `'worklet'` directive on functions called inside Reanimated
-- FlatList inside ScrollView (disables virtualization)
-- `useSharedValue` vs `useState` confusion (SharedValue on wrong thread)
-
-### security-auditor
-
-- AsyncStorage storing sensitive data (tokens, PII) unencrypted
-- API keys in source code (should be in EAS Secrets)
-- cleartext HTTP traffic (should be HTTPS on all platforms)
-- Deep link not validated before processing URL scheme
-
-### mobile-reviewer
-
-- `setState` inside Reanimated `onUpdate` (JS bridge crossing = jank)
-- Missing `'worklet'` on custom functions used in Reanimated
-- FlatList for large lists (use FlashList with `estimatedItemSize`)
-- Hardcoded pixel insets instead of `useSafeAreaInsets()`
-- `Platform.OS === 'ios'` inside StyleSheet.create (not evaluated correctly)
-- Missing `AppState` subscription cleanup (`subscription.remove()`)
-- `react-native Image` used instead of `expo-image` (poor caching)
-
-### type-safety-reviewer
-
-- React Native components with `any` typed props
-- Navigation route params missing strict types (e.g., React Navigation types)
-- Untyped gesture handler events
-- Unsafe type assertions when bridging native modules
-
----
-
-## Verdict System
-
-```
-If ANY reviewer → ❌ REJECTED: fix before Human Gate
-If any reviewer → ⚠️ WARNING:  proceed with flagged items
-If all reviewers → ✅ APPROVED: Human Gate
-```
-
----
-
-## Mobile-Specific Hallucination Traps (Common LLM Mistakes)
-
-```tsx
-// ❌ Missing 'worklet' — animation function crashes silently
-const clamp = (val: number, min: number, max: number) => Math.min(Math.max(val, min), max);
-// ✅ Must have worklet directive
-const clamp = (val: number, min: number, max: number): number => {
-  'worklet';
-  return Math.min(Math.max(val, min), max);
-};
-
-// ❌ Expo Router: navigate() was refactored in v4 — old API
-import { navigate } from 'expo-router'; // Named export doesn't exist
-// ✅ Current Expo Router v4
-import { router } from 'expo-router';
-router.push('/products/123');
-
-// ❌ React Native: StyleSheet.create doesn't eval functions
-const styles = StyleSheet.create({
-  box: { paddingTop: Platform.OS === 'ios' ? 20 : 0 }, // Doesn't work in all contexts
-});
-// ✅ Use Platform.select or dynamic style object
-const boxStyle = Platform.select({ ios: { paddingTop: 20 }, android: { paddingTop: 0 } });
-```
-
----
-
-## Usage Examples
-
-```
-/tribunal-mobile the SwipeToDelete gesture implementation with Reanimated 3
-/tribunal-mobile the ProductList component using FlashList
-/tribunal-mobile the auth token storage and retrieval functions
-/tribunal-mobile the ProfileScreen with safe area insets
-```
-
----
-
-## After /tribunal-mobile — Next Steps
-
-| Outcome                     | Next Command                                      |
-| :-------------------------- | :------------------------------------------------ |
-| All checks pass             | → Safe to test on simulator / deploy              |
-| Reviewers reject with fixes | → Apply fixes, then run `/tribunal-mobile` again  |
-| Needs advanced mobile UI    | → `/ui-ux-pro-max` for premium app design         |
-| Animation drops frames      | → `/tribunal-performance` for JS thread profiling |
-
----
+---
+description: Mobile-specific Tribunal. Runs Logic + Security + Mobile reviewers. Use for React Native, Expo, gesture handlers, animations, navigation, and any iOS/Android-targeted code.
+tools: Read, Grep, Glob, Bash, Edit, Write
+version: 3.0.0
+last-updated: 2026-07-30
+required-skills:
+  - building-native-ui
+  - mobile-design
+  - swiftui-expert
+scripts-binding:
+  - .agent/scripts/lint_runner.js
+  - .agent/scripts/security_scan.js
+---
+
+# /tribunal-mobile — Mobile Code Audit
+
+$ARGUMENTS
+
+---
+
+## Mandatory Pre-Flight Context Inspection
+
+Before auditing React Native, Expo, or native mobile code, you MUST inspect:
+
+1. Native Configuration Manifests (`app.json`, `app.config.js`, `package.json`) → Verify Expo SDK version, Reanimated dependencies, and permissions
+2. Gesture & 60fps Motion Rules → Enforce `react-native-reanimated` worklets on UI thread; ban JavaScript bridge layout thrashing
+3. 28-Reviewer Mobile Gate → Run logic-reviewer, security-auditor, and mobile-reviewer before approving mobile component diffs
+
+4. Required Skills → Before executing, load and follow procedural rules from:
+   - `building-native-ui` (.agent/skills/building-native-ui/SKILL.md): Native UI component patterns for cross-platform apps
+   - `mobile-design` (.agent/skills/mobile-design/SKILL.md): Mobile-first design for iOS, Android, touch, haptics, 120Hz
+   - `swiftui-expert` (.agent/skills/swiftui-expert/SKILL.md): SwiftUI declarative UI, @Observable, NavigationStack, Charts
+
+---
+
+## When to Use /tribunal-mobile
+
+| Use `/tribunal-mobile` when...       | Use something else when...                 |
+| :----------------------------------- | :----------------------------------------- |
+| React Native components              | Web-only components → `/tribunal-frontend` |
+| Expo Router navigation               | API routes → `/tribunal-backend`           |
+| Reanimated animations/gestures       | Full audit → `/tribunal-full`              |
+| FlashList / FlatList code            |                                            |
+| Platform-specific (ios/android) code |                                            |
+
+---
+
+## 4 Active Reviewers (All Run Simultaneously)
+
+### precedence-reviewer → Checks local repo Case Law for past rejections
+
+logic-reviewer
+
+- `runOnJS` called inside `onUpdate` instead of `onEnd` (runs every frame)
+- Missing `'worklet'` directive on functions called inside Reanimated
+- FlatList inside ScrollView (disables virtualization)
+- `useSharedValue` vs `useState` confusion (SharedValue on wrong thread)
+
+### security-auditor
+
+- AsyncStorage storing sensitive data (tokens, PII) unencrypted
+- API keys in source code (should be in EAS Secrets)
+- cleartext HTTP traffic (should be HTTPS on all platforms)
+- Deep link not validated before processing URL scheme
+
+### mobile-reviewer
+
+- `setState` inside Reanimated `onUpdate` (JS bridge crossing = jank)
+- Missing `'worklet'` on custom functions used in Reanimated
+- FlatList for large lists (use FlashList with `estimatedItemSize`)
+- Hardcoded pixel insets instead of `useSafeAreaInsets()`
+- `Platform.OS === 'ios'` inside StyleSheet.create (not evaluated correctly)
+- Missing `AppState` subscription cleanup (`subscription.remove()`)
+- `react-native Image` used instead of `expo-image` (poor caching)
+
+### type-safety-reviewer
+
+- React Native components with `any` typed props
+- Navigation route params missing strict types (e.g., React Navigation types)
+- Untyped gesture handler events
+- Unsafe type assertions when bridging native modules
+
+---
+
+## Verdict System
+
+```
+If ANY reviewer → ❌ REJECTED: fix before Human Gate
+If any reviewer → ⚠️ WARNING:  proceed with flagged items
+If all reviewers → ✅ APPROVED: Human Gate
+```
+
+---
+
+## Mobile-Specific Hallucination Traps (Common LLM Mistakes)
+
+```tsx
+// ❌ Missing 'worklet' — animation function crashes silently
+const clamp = (val: number, min: number, max: number) => Math.min(Math.max(val, min), max);
+// ✅ Must have worklet directive
+const clamp = (val: number, min: number, max: number): number => {
+  'worklet';
+  return Math.min(Math.max(val, min), max);
+};
+
+// ❌ Expo Router: navigate() was refactored in v4 — old API
+import { navigate } from 'expo-router'; // Named export doesn't exist
+// ✅ Current Expo Router v4
+import { router } from 'expo-router';
+router.push('/products/123');
+
+// ❌ React Native: StyleSheet.create doesn't eval functions
+const styles = StyleSheet.create({
+  box: { paddingTop: Platform.OS === 'ios' ? 20 : 0 }, // Doesn't work in all contexts
+});
+// ✅ Use Platform.select or dynamic style object
+const boxStyle = Platform.select({ ios: { paddingTop: 20 }, android: { paddingTop: 0 } });
+```
+
+---
+
+## Usage Examples
+
+```
+/tribunal-mobile the SwipeToDelete gesture implementation with Reanimated 3
+/tribunal-mobile the ProductList component using FlashList
+/tribunal-mobile the auth token storage and retrieval functions
+/tribunal-mobile the ProfileScreen with safe area insets
+```
+
+---
+
+## After /tribunal-mobile — Next Steps
+
+| Outcome                     | Next Command                                      |
+| :-------------------------- | :------------------------------------------------ |
+| All checks pass             | → Safe to test on simulator / deploy              |
+| Reviewers reject with fixes | → Apply fixes, then run `/tribunal-mobile` again  |
+| Needs advanced mobile UI    | → `/ui-ux-pro-max` for premium app design         |
+| Animation drops frames      | → `/tribunal-performance` for JS thread profiling |
+
+---