tribunal-kit 9.0.0 → 9.0.1

package/.agent/scripts/browser_audit.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+/**
+ * browser_audit.js — Live Browser Quality, Accessibility & Performance Auditor
+ *
+ * Runs browser-level audits capturing console errors, broken assets,
+ * WCAG accessibility violations, and Core Web Vitals.
+ *
+ * Usage:
+ *   node .agent/scripts/browser_audit.js http://localhost:3000
+ *   node .agent/scripts/browser_audit.js https://example.com --json
+ */
+
+'use strict';
+
+const { GREEN, YELLOW, RED, BOLD, RESET, banner, timer, formatMs } = require('./_colors');
+
+async function main() {
+  const args = process.argv.slice(2);
+  const isJson = args.includes('--json');
+  const url = args.find(a => !a.startsWith('--'));
+
+  if (!url) {
+    if (isJson) {
+      console.log(JSON.stringify({ error: 'Missing target URL' }));
+    } else {
+      console.error(`  ${RED}✖ Error:${RESET} Missing target URL. Usage: node .agent/scripts/browser_audit.js <url>`);
+    }
+    process.exit(1);
+  }
+
+  const elapsed = timer();
+  if (!isJson) {
+    console.log(banner('browser_audit.js', { Target: url }));
+  }
+
+  try {
+    const { auditURL } = require('../../dist/browser');
+    const report = await auditURL(url);
+
+    if (isJson) {
+      console.log(JSON.stringify(report, null, 2));
+      process.exit(report.summary.passed ? 0 : 1);
+    }
+
+    console.log(`  ${BOLD}Target:${RESET}    ${report.url}`);
+    console.log(`  ${BOLD}Title:${RESET}     ${report.page.title || '(No title)'}`);
+    console.log(`  ${BOLD}Duration:${RESET}  ${formatMs(report.durationMs)}\n`);
+
+    // Scores
+    const a11yCol = report.scores.accessibility >= 80 ? GREEN : report.scores.accessibility >= 60 ? YELLOW : RED;
+    const secCol = report.scores.security >= 80 ? GREEN : report.scores.security >= 60 ? YELLOW : RED;
+
+    console.log(`  ${BOLD}Audit Scores:${RESET}`);
+    console.log(`    Accessibility:   ${a11yCol}${report.scores.accessibility}/100${RESET}`);
+    console.log(`    Security:        ${secCol}${report.scores.security}/100${RESET}\n`);
+
+    if (report.violations.accessibility.length > 0) {
+      console.log(`  ${YELLOW}Accessibility Findings:${RESET}`);
+      for (const a of report.violations.accessibility) {
+        console.log(`    ${YELLOW}⚠${RESET} ${a.message}`);
+      }
+      console.log();
+    }
+
+    if (report.violations.consoleErrors.length > 0) {
+      console.log(`  ${RED}Console Errors:${RESET}`);
+      for (const err of report.violations.consoleErrors) {
+        console.log(`    ${RED}✖${RESET} [${err.level}] ${err.text}`);
+      }
+      console.log();
+    }
+
+    if (report.summary.passed) {
+      console.log(`  ${GREEN}${BOLD}✔ Browser audit passed in ${elapsed()} — No critical violations found.${RESET}\n`);
+      process.exit(0);
+    } else {
+      console.log(`  ${YELLOW}${BOLD}⚠ Browser audit completed in ${elapsed()} with ${report.summary.totalIssues} issue(s).${RESET}\n`);
+      process.exit(1);
+    }
+  } catch (err) {
+    if (isJson) {
+      console.log(JSON.stringify({ error: err.message }));
+    } else {
+      console.error(`  ${RED}✖ Browser audit execution failed:${RESET} ${err.message}\n`);
+    }
+    process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {};

package/.agent/scripts/context_compiler.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * context_compiler.js — Tribunal Kit SOTA Context Compiler Engine (tribunal-kit .agent mirror)
+ */
+'use strict';
+module.exports = require('../../scripts/context_compiler.js');
+if (require.main === module) {
+  require('../../scripts/context_compiler.js');
+}

package/.agent/scripts/prompt_compiler.js

@@ -20,6 +20,33 @@ const TECH_KEYWORDS = [
   'html',
   'prisma',
   'drizzle',
+  'fastapi',
+  'django',
+  'graphql',
+  'rust',
+  'docker',
+  'kubernetes',
+  'aws',
+  'terraform',
+  'opentofu',
+  'redis',
+  'supabase',
+  'playwright',
+  'jest',
+  'vitest',
+  'react-native',
+  'flutter',
+  'expo',
+  'c#',
+  '.net',
+  'blazor',
+  'angular',
+  'astro',
+  'sqlite',
+  'opentelemetry',
+  'webgpu',
+  'llm',
+  'rag',
 ];
 
 const ROUTER_MAP = {
@@ -39,18 +66,52 @@ const ROUTER_MAP = {
   html: ['frontend-design'],
   prisma: ['database-design'],
   drizzle: ['database-design'],
+  fastapi: ['python-pro', 'api-patterns'],
+  django: ['python-pro', 'database-design'],
+  graphql: ['api-patterns', 'backend-security-expert'],
+  rust: ['rust-pro', 'clean-code'],
+  docker: ['containerization-pro', 'devops-engineer'],
+  kubernetes: ['platform-engineer', 'containerization-pro'],
+  aws: ['cloud-architect', 'devops-engineer'],
+  terraform: ['platform-engineering-opentofu'],
+  opentofu: ['platform-engineering-opentofu'],
+  redis: ['database-design', 'backend-security-expert'],
+  supabase: ['supabase-postgres-best-practices', 'database-design'],
+  playwright: ['playwright-ai-e2e', 'webapp-testing'],
+  jest: ['testing-patterns'],
+  vitest: ['testing-patterns'],
+  'react-native': ['mobile-design', 'expo-router-v4'],
+  flutter: ['mobile-design'],
+  expo: ['expo-router-v4', 'mobile-design'],
+  'c#': ['csharp-developer'],
+  '.net': ['csharp-developer'],
+  blazor: ['csharp-developer'],
+  angular: ['clean-code'],
+  astro: ['frontend-design'],
+  sqlite: ['database-design'],
+  opentelemetry: ['opentelemetry-observability'],
+  webgpu: ['webgpu-performance'],
+  llm: ['llm-engineering', 'ai-app-hardening'],
+  rag: ['advanced-rag-pipelines', 'llm-engineering'],
 };
 
 const ACTION_ROUTER = {
-  build: ['architecture'],
-  create: ['architecture'],
-  fix: ['systematic-debugging'],
-  debug: ['systematic-debugging'],
-  refactor: ['clean-code'],
+  build: ['architecture', 'clean-code'],
+  create: ['architecture', 'clean-code'],
+  fix: ['systematic-debugging', 'clean-code'],
+  debug: ['systematic-debugging', 'diagnosing-bugs'],
+  refactor: ['clean-code', 'codebase-design'],
   update: ['clean-code'],
   write: ['clean-code'],
-  design: ['frontend-design'],
-  audit: ['vulnerability-scanner', 'lint-and-validate'],
+  design: ['frontend-design', 'better-ui'],
+  audit: ['vulnerability-scanner', 'lint-and-validate', 'code-review-checklist'],
+  test: ['testing-patterns', 'property-based-testing'],
+  benchmark: ['performance-profiling'],
+  optimize: ['performance-profiling', 'clean-code'],
+  deploy: ['deployment-procedures', 'devops-engineer'],
+  migrate: ['database-design'],
+  secure: ['vulnerability-scanner', 'backend-security-expert'],
+  contract: ['domain-modeling', 'clean-code'],
 };
 
 /**
@@ -64,12 +125,17 @@ function sanitizeUserInput(text) {
 
   // 2. Check for injection patterns
   const injectionPatterns = [
-    /ignore\s+(all\s+)?previous\s+instructions/i,
+    /ignore\s+(all\s+)?(previous|prior)\s+instructions/i,
+    /disregard\s+(all\s+)?(previous|prior)\s+instructions/i,
     /you\s+are\s+now\s+a?\s+/i,
+    /\bDAN\b|jailbreak/i,
     /system\s*:\s*/i,
     /assistant\s*:\s*/i,
-    /\[\[INST\]\]/i,
+    /user\s*:\s*/i,
+    /\[\[?INST\]?\]/i,
     /<<SYS>>/i,
+    /bypass\s+(all\s+)?(guardrails|safety|tribunal)/i,
+    /override\s+(system|model|all)\s+instructions/i,
   ];
 
   for (const pattern of injectionPatterns) {
@@ -82,6 +148,30 @@ function sanitizeUserInput(text) {
   return sanitized;
 }
 
+/**
+ * Classifies the governance impact tier (0-3) based on action and stack.
+ * @param {string} action
+ * @param {string[]} stack
+ * @param {string} text
+ * @returns {number} Tier (0-3)
+ */
+function inferImpactTier(action, stack, text) {
+  const lower = text.toLowerCase();
+  if (/auth|jwt|session|login|migration|breaking|schema|password|secret|key/i.test(lower)) {
+    return 3;
+  }
+  if (['deploy', 'migrate', 'secure'].includes(action)) {
+    return 3;
+  }
+  if (['build', 'create', 'refactor', 'contract'].includes(action) || stack.length >= 2) {
+    return 2;
+  }
+  if (['fix', 'debug', 'update', 'test'].includes(action)) {
+    return 1;
+  }
+  return 0;
+}
+
 /**
  * Programmatically compile a user request or spec object into a hyper-dense super-prompt string.
  * @param {string|object} input
@@ -103,11 +193,10 @@ function compileSuperPrompt(input) {
   // Sanitize the input to prevent prompt injection
   const originalInput = sanitizeUserInput(rawText);
   const trimmedInput = originalInput.trim();
-  const _cleanInput = trimmedInput;
 
   // 1. Extract Action (Intent mapping) using trimmed input
   const actionMatch = trimmedInput.match(
-    /^(?:(?:hey,?\s*|please\s+|can you\s+|could you\s+|would you\s+|i need you to\s+|i want to\s+)*)(build|create|fix|debug|refactor|update|write|design|audit)\b/i,
+    /^(?:(?:hey,?\s*|please\s+|can you\s+|could you\s+|would you\s+|i need you to\s+|i want to\s+)*)(build|create|fix|debug|refactor|update|write|design|audit|test|benchmark|optimize|deploy|migrate|secure|contract)\b/i,
   );
   const action = actionMatch ? actionMatch[1].toLowerCase() : 'execute';
 
@@ -133,7 +222,8 @@ function compileSuperPrompt(input) {
     }
   });
 
-  const finalSkills = Array.from(recommendedSkills).slice(0, 4);
+  const finalSkills = Array.from(recommendedSkills).slice(0, 5);
+  const impactTier = inferImpactTier(action, stack, trimmedInput);
 
   // 4. Compact YAML Generation with prompt injection defense
   // Preserve leading whitespace and escape leading "---" or "..." to prevent YAML document start
@@ -162,7 +252,9 @@ function compileSuperPrompt(input) {
     `target: |`,
     indentedTarget,
     `stack: [${stack.join(', ')}]`,
+    `impact_tier: ${impactTier}`,
     `recommended_skills: [${finalSkills.join(', ')}]`,
+    `governance: tribunal-v9`,
   ].join('\n');
 }
 
@@ -177,4 +269,4 @@ if (require.main === module) {
   console.log(compileSuperPrompt(rawInput));
 }
 
-module.exports = { compileSuperPrompt };
+module.exports = { compileSuperPrompt, sanitizeUserInput, inferImpactTier };

package/.agent/skill_topic_map.json

@@ -151,7 +151,8 @@
       "tdd-workflow",
       "test-result-analyzer",
       "playwright-ai-e2e",
-      "property-based-testing"
+      "property-based-testing",
+      "browser-audit"
     ],
     "meta": [
       "agent-organizer",

package/.agent/skills/12-principles-of-animation/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: 12-principles-of-animation
-description: Application of Disney's 12 Principles of Animation (Squash & Stretch, Anticipation, Staging, Follow Through, Slow In & Slow Out, Arc, Secondary Action, Timing, Exaggeration, Solid Drawing, Appeal) to modern web UI motion.
-version: 4.0.0
-last-updated: 2026-09-07
+description: Use when Application of Disney's 12 Principles of Animation (Squash & Stretch, Anticipation, Staging, Follow Through, Slow In & Slow Out, Arc, Secondary Action, Timing, Exaggeration, Solid Drawing, Appeal) to modern web UI motion.
+version: 5.0.0
+last-updated: 2026-09-13
 skills:
   - motion-engineering
   - 60fps-animation
@@ -15,23 +15,41 @@ scripts-binding:
 
 # 12 Principles of Animation — Web UI Motion Theory
 
----
-
 ## Mandatory Pre-Flight Context Inspection
 
-Before applying animation principles to web components, you MUST inspect:
+Before generating, refactoring, or reviewing code in the `12-principles-of-animation` domain, inspect these 5 critical parameters:
 
-1. Target interaction pattern → Identify applicability of Squash & Stretch, Anticipation, Slow In/Out, or Follow Through
-2. Volume-Preservation Rule (Section 26) → Keep UI squash/stretch subtle (max 2%-4%); if height scales to 0.97, width MUST scale to 1.03
-3. Staging Rules (Section 31) → Direct user focus with sequential motion rather than competing simultaneous animations
+1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
+2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
+3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
+4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
+5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
 
-Translate Disney's 12 classic principles of animation into modern CSS, Web API, and Framer Motion code patterns.
+## Activation Boundaries
 
+- **Activate when:** Use when Application of Disney's 12 Principles of Animation (Squash & Stretch, Anticipation, Staging, Follow Through, Slow In & Slow Out, Arc, Secondary Action, Timing, Exaggeration, Solid Drawing, Appeal) to modern web UI motion.
+- **DO NOT activate when:** The task falls outside the `12-principles-of-animation` domain or is managed by a different dedicated specialist.
 
-## Activation Boundaries
+## 🔁 Multi-Pass Execution Protocol
+
+Execute all non-trivial tasks through this 7-pass cognitive loop:
+
+| Pass | Phase | Core Action |
+|:---|:---|:---|
+| **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
+| **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
+| **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
+| **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
+| **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
+| **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
+| **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
+
+---
+
+## 🛠️ Technical Architecture & Reference Recipes
+
+---
 
-- **Activate when:** Operating in tasks requiring Application of Disney's 12 Principles of Animation (Squash & Stretch, Anticipation, Staging, Follow Through, Slow In & Slow Out, Arc, Secondary Action, Timing, Exaggeration, Solid Drawing, Appeal) to modern web UI motion..
-- **DO NOT activate when:** The task falls strictly outside 12-principles-of-animation domain or belongs to a different dedicated specialist.
 
 ---
 
@@ -64,25 +82,45 @@ Translate Disney's 12 classic principles of animation into modern CSS, Web API,
 
 ---
 
+## 🚨 Edge-Case & Failure Mode Matrix
+
+| Scenario | Risk | Mitigation Strategy |
+|:---|:---|:---|
+| **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
+| **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
+| **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
+| **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
+| **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
+
+---
+
+## 🤖 LLM-Specific Traps Table
+
+| Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
+|:---|:---|:---|
+| **The Instant Pop Trap** | Conditionally unmounting elements without animated interpolation | Use AnimatePresence or coordinate morphs with continuous geometry |
+| **Layout Thrashing** | Animating width, height, top, or left inside animation loops | Animate composite-only transform (translate3d, scale) and opacity |
+| **Sluggish Duration** | Setting micro-interaction transitions to 600ms+ causing interface lag | Cap interactive feedback at 160ms–240ms with snappy ease-out curves |
+
+---
+
 ## 🏛️ Tribunal Verification & Guardrails
 
-**Slash command: `/review` or `/tribunal-full`**
-**Active reviewers: `logic-reviewer` · `security-auditor`**
+**Active Reviewers:** `frontend-reviewer` · `motion-reviewer` · `ui-ux-auditor`
+**Slash Command:** `/review` or `/tribunal-full`
 
-### ❌ Forbidden AI Tropes
-1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
-2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
-3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
+### ✅ Pre-Flight Self-Audit Checklist
 
-### ✅ Pre-Flight Self-Audit
 ```
-✅ Did I rely ONLY on real, verified tools and methods?
-✅ Is this solution appropriately scoped to the user's constraints?
-✅ Did I handle potential failure modes and edge cases?
-✅ Have I avoided generic boilerplate that doesn't add value?
+✅ Does animation maintain 60fps/120fps using transform and opacity?
+✅ Is optical mass conserved across state interpolations without volume collapse?
+✅ Is duration capped within micro-interaction budgets (160ms–280ms)?
+✅ Is prefers-reduced-motion respected with graceful instant fallbacks?
+✅ Did I prevent layout thrashing and continuous geometry mutations?
 ```
 
 ### 🛑 Verification-Before-Completion (VBC) Protocol
+
 **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
 - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
-- ✅ **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.
+- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.

package/.agent/skills/60fps-animation/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: 60fps-animation
-description: Web animation performance guidance for avoiding layout thrashing, achieving 60/120fps motion, and using GPU compositor-friendly properties (transform, opacity).
-version: 4.0.0
-last-updated: 2026-09-07
+description: Use when Web animation performance guidance for avoiding layout thrashing, achieving 60/120fps motion, and using GPU compositor-friendly properties (transform, opacity).
+version: 5.0.0
+last-updated: 2026-09-13
 skills:
   - motion-engineering
   - accessible-animation
@@ -15,21 +15,45 @@ scripts-binding:
 
 # 60fps Animation — GPU Compositor & High-Performance Motion
 
----
-
 ## Mandatory Pre-Flight Context Inspection
 
-Before writing animation CSS or JS, you MUST inspect:
+Before generating, refactoring, or reviewing code in the `60fps-animation` domain, inspect these 5 critical parameters:
 
-1. Target Animated Properties → Strictly enforce GPU compositor-only properties (`transform`, `opacity`); ban layout-triggering properties (`width`, `height`, `top`, `left`, `margin`)
-2. CSS `@starting-style` & Popover API → Use native CSS entry transitions for dialogs/popovers; avoid manual JavaScript mount/unmount timers
-3. Layout Containment → Apply `contain: layout paint` or `content-visibility: auto` to isolate animation paint boundaries from parent DOM trees
-4. Frame Rate Budget → Animations must complete within a 16.6ms frame budget (8.3ms on 120Hz ProMotion displays) without dropping frames
+1. **System Boundaries & Dependencies**: Verify that all required dependencies exist in target package manifests and environment paths.
+2. **Runtime Context & Platform Invariants**: Confirm target platform constraints (Node.js, Browser, Mobile OS, Edge runtime) before applying APIs.
+3. **Execution Guardrails**: Identify potential side-effects, state mutations, and unhandled asynchronous exceptions.
+4. **Validation & Type Contracts**: Validate input data schemas and strict type constraints across all module interfaces.
+5. **Observability & Proof of Execution**: Ensure execution produces tangible verification signals (terminal output, tests, metrics).
 
 ## Activation Boundaries
 
-- **Activate when:** Designing web animations, transitions, micro-interactions, scroll animations, and fixing visual jank or low frame rates.
-- **DO NOT activate when:** Writing static layouts without motion or backend Node.js business logic.
+- **Activate when:** Use when Web animation performance guidance for avoiding layout thrashing, achieving 60/120fps motion, and using GPU compositor-friendly properties (transform, opacity).
+- **DO NOT activate when:** The task falls outside the `60fps-animation` domain or is managed by a different dedicated specialist.
+
+## 🔁 Multi-Pass Execution Protocol
+
+Execute all non-trivial tasks through this 7-pass cognitive loop:
+
+| Pass | Phase | Core Action |
+|:---|:---|:---|
+| **Pass 1** | **Understand** | Deconstruct the user's explicit objective, implicit requirements, and platform constraints. |
+| **Pass 2** | **Plan** | Decompose the task into smallest logical steps; map dependencies and required tool calls. |
+| **Pass 3** | **Execute** | Implement the solution with production-grade craft, zero placeholders, and strict typing. |
+| **Pass 4** | **Verify** | Run linters, unit tests, or compiler checks to validate structural correctness. |
+| **Pass 5** | **Attack** | Perform an adversarial review searching for edge-case failures, race conditions, and traps. |
+| **Pass 6** | **Improve** | Eliminate discovered friction, optimize performance, and harden error boundaries. |
+| **Pass 7** | **Quality Gate** | Enforce Verification-Before-Completion (VBC) with concrete terminal proof before finalizing. |
+
+---
+
+## 🛠️ Technical Architecture & Reference Recipes
+
+---
+
+## 🛠️ Technical Architecture & Reference Recipes
+
+---
+
 
 ## 2026 Motion Performance & GPU Invariants
 
@@ -96,25 +120,45 @@ Instead of animating `width: 100px` to `200px`:
 
 ---
 
+## 🚨 Edge-Case & Failure Mode Matrix
+
+| Scenario | Risk | Mitigation Strategy |
+|:---|:---|:---|
+| **Empty or Null Inputs** | Unhandled exception or unexpected rendering collapse | Enforce fallback guards, optional chaining, and explicit empty state handlers |
+| **Network Timeout / Latency** | Hanging operations or duplicate side-effects | Implement bounded abort controllers, exponential backoff, and idempotency keys |
+| **Concurrency / Race Conditions** | Stale state overwrite or inconsistent data mutations | Use atomic transactions, mutex locking, or cancel-on-resubmit controls |
+| **Invalid Schema / Malformed Payload** | Downstream runtime errors or security injection | Validate boundary payloads with Zod/Pydantic schemas prior to execution |
+| **Resource / Memory Saturation** | OOM errors, frame drops, or memory leaks | Clean up listeners, cancel active timers, and enforce pagination/virtualization |
+
+---
+
+## 🤖 LLM-Specific Traps Table
+
+| Anti-Pattern | What AI Commonly Does Wrong | What Is Actually Correct |
+|:---|:---|:---|
+| **The Instant Pop Trap** | Conditionally unmounting elements without animated interpolation | Use AnimatePresence or coordinate morphs with continuous geometry |
+| **Layout Thrashing** | Animating width, height, top, or left inside animation loops | Animate composite-only transform (translate3d, scale) and opacity |
+| **Sluggish Duration** | Setting micro-interaction transitions to 600ms+ causing interface lag | Cap interactive feedback at 160ms–240ms with snappy ease-out curves |
+
+---
+
 ## 🏛️ Tribunal Verification & Guardrails
 
-**Slash command: `/review` or `/tribunal-full`**
-**Active reviewers: `logic-reviewer` · `security-auditor`**
+**Active Reviewers:** `frontend-reviewer` · `motion-reviewer` · `ui-ux-auditor`
+**Slash Command:** `/review` or `/tribunal-full`
 
-### ❌ Forbidden AI Tropes
-1. **Blind Assumptions:** Never make an assumption without documenting it clearly with `// VERIFY: [reason]`.
-2. **Silent Degradation:** Catching and suppressing errors without logging or handling.
-3. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
+### ✅ Pre-Flight Self-Audit Checklist
 
-### ✅ Pre-Flight Self-Audit
 ```
-✅ Did I rely ONLY on real, verified tools and methods?
-✅ Is this solution appropriately scoped to the user's constraints?
-✅ Did I handle potential failure modes and edge cases?
-✅ Have I avoided generic boilerplate that doesn't add value?
+✅ Does animation maintain 60fps/120fps using transform and opacity?
+✅ Is optical mass conserved across state interpolations without volume collapse?
+✅ Is duration capped within micro-interaction budgets (160ms–280ms)?
+✅ Is prefers-reduced-motion respected with graceful instant fallbacks?
+✅ Did I prevent layout thrashing and continuous geometry mutations?
 ```
 
 ### 🛑 Verification-Before-Completion (VBC) Protocol
+
 **CRITICAL:** You must follow a strict "evidence-based closeout" state machine.
 - ❌ **Forbidden:** Declaring a task complete because the output "looks correct."
-- ✅ **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.
+- ✅ **Required:** You are explicitly forbidden from finalizing any task without providing **concrete evidence** (terminal output, passing test suites, compiler success, or equivalent operational proof) that your output works as intended.