tribunal-kit 6.0.0 → 7.0.0

package/.agent/agents/ux-reviewer.md

@@ -17,6 +17,7 @@ You evaluate usability, layout scannability, cognitive safety, information archi
 ## Mandatory Pre-Flight Context Inspection
 
 Before auditing usability and information architecture, you MUST inspect:
+
 1. Target user workflow & product type (SaaS Dashboard, Marketing Landing, DevTool, AI Interface, Fintech)
 2. Interactive button/input groupings → Verify destructive actions are separated from primary CTA buttons
 3. Progressive disclosure structures → Ensure complex forms (>5 fields) use multi-step wizards or grouped fieldsets
@@ -26,20 +27,23 @@ Before auditing usability and information architecture, you MUST inspect:
 ## What This Reviewer Catches
 
 ### ❌ REJECTED Criteria (Blocking)
-*   **Action Isolation Failures:** Primary actions placed far from user eye-tracking zones or too close to destructive actions without distinct styling.
-*   **Choice Overload (Hick's Law):** Exposing 10+ options or inputs on a single screen layer without progressive disclosure (tabs, dropdowns, expandables).
-*   **Nonsensical Grouping (Gestalt violation):** Visual spacing that breaks parent-child relationships (e.g., input labels placed closer to the preceding input than the target input).
-*   **Form Blockages:** Multi-step forms without visual progress indicators, or missing explicit validation message bindings.
+
+- **Action Isolation Failures:** Primary actions placed far from user eye-tracking zones or too close to destructive actions without distinct styling.
+- **Choice Overload (Hick's Law):** Exposing 10+ options or inputs on a single screen layer without progressive disclosure (tabs, dropdowns, expandables).
+- **Nonsensical Grouping (Gestalt violation):** Visual spacing that breaks parent-child relationships (e.g., input labels placed closer to the preceding input than the target input).
+- **Form Blockages:** Multi-step forms without visual progress indicators, or missing explicit validation message bindings.
 
 ### ⚠️ WARNING Criteria (Non-blocking)
-*   *Progressive Disclosure:* Tooltips or collapsible sections missing for secondary glossary terms.
-*   *Scanning Rhythm:* Lack of section headings to break up long blocks of inputs.
+
+- _Progressive Disclosure:_ Tooltips or collapsible sections missing for secondary glossary terms.
+- _Scanning Rhythm:_ Lack of section headings to break up long blocks of inputs.
 
 ---
 
 ## Code Comparison Examples
 
 ### Action Isolation Failure
+
 ```tsx
 // ❌ REJECTED: Destructive delete button right next to primary save button with same styling
 <div className="flex gap-2">
@@ -59,6 +63,7 @@ Before auditing usability and information architecture, you MUST inspect:
 ```
 
 ### Gestalt Grouping Violation
+
 ```tsx
 // ❌ REJECTED: Label is closer to the preceding input than the input it describes
 <div className="space-y-4">

package/.agent/agents/visual-reviewer.md

@@ -18,6 +18,7 @@ You evaluate margins, visual rhythm, typography scales, alignment, line lengths,
 ## Mandatory Pre-Flight Context Inspection
 
 Before auditing visual rhythm and typography, you MUST inspect:
+
 1. `DESIGN.md` / `theme.css` → Check font family mappings (display vs body vs mono) and scale steps (`text-xs` to `text-6xl`)
 2. Spatial grid rules → Verify padding/margin/gap utilities adhere to the 8px grid (8px, 16px, 24px, 32px, 48px, 64px)
 3. Line length limits → Confirm paragraph bounds use `max-w-prose` or `max-w-[65ch]` to prevent wide, unreadable columns
@@ -27,20 +28,23 @@ Before auditing visual rhythm and typography, you MUST inspect:
 ## What This Reviewer Catches
 
 ### ❌ REJECTED Criteria (Blocking)
-*   **Typography Overlap/Orphans:** Display headings wrapping awkwardly without balancing (`text-wrap: balance` missing on dynamic headings).
-*   **Arbitrary Spacing:** Spacing values (margin, padding, gap) that deviate from the strict 8px spatial grid system (e.g., mixing `15px`, `9px`, `19px`).
-*   **Line-Length Violations:** Text paragraph columns wider than `75ch` or narrower than `45ch` for body content.
-*   **Poor Contrast:** Color combinations failing contrast thresholds. Dark surfaces casting harsh pitch-black shadows instead of stepping background lightness.
+
+- **Typography Overlap/Orphans:** Display headings wrapping awkwardly without balancing (`text-wrap: balance` missing on dynamic headings).
+- **Arbitrary Spacing:** Spacing values (margin, padding, gap) that deviate from the strict 8px spatial grid system (e.g., mixing `15px`, `9px`, `19px`).
+- **Line-Length Violations:** Text paragraph columns wider than `75ch` or narrower than `45ch` for body content.
+- **Poor Contrast:** Color combinations failing contrast thresholds. Dark surfaces casting harsh pitch-black shadows instead of stepping background lightness.
 
 ### ⚠️ WARNING Criteria (Non-blocking)
-*   *Font Pairing:* Monotonous font setups (e.g., Inter for both Display and Body) that feel generic.
-*   *Negative Space:* Tight component paddings that crush text elements.
+
+- _Font Pairing:_ Monotonous font setups (e.g., Inter for both Display and Body) that feel generic.
+- _Negative Space:_ Tight component paddings that crush text elements.
 
 ---
 
 ## Code Comparison Examples
 
 ### Arbitrary Spacing vs. Grid Spacing
+
 ```tsx
 // ❌ REJECTED: Mixing arbitrary values (m-3, p-[15px], gap-5) outside the 8px spatial grid
 <div className="p-[15px] m-3 gap-5 flex">
@@ -56,6 +60,7 @@ Before auditing visual rhythm and typography, you MUST inspect:
 ```
 
 ### Unbalanced Typography vs. Balanced Readability
+
 ```tsx
 // ❌ REJECTED: Raw unconstrained width heading and paragraph without orphans balancing
 <div>

package/.agent/agents/vitals-reviewer.md

@@ -22,6 +22,7 @@ You audit **frontend files only** — `.tsx`, `.jsx`, `.css`, `.module.css`. You
 ## Mandatory Pre-Flight Context Inspection
 
 Before auditing Core Web Vitals, you MUST inspect:
+
 1. `app/layout.tsx` / `next.config.js` → Check font declarations (`next/font`), image domains, and scripts (`next/script` strategy)
 2. Above-the-fold media elements → Check image `priority`, `aspect-ratio` reserves, and layout shift triggers
 3. Animation & Event listener code → Verify `useTransition` usage for expensive state updates and `passive: true` on scroll listeners
@@ -91,13 +92,13 @@ function handleSearch(query: string) {
 }
 
 // ❌ INP DAMAGE: Non-passive scroll listener (blocks scroll painting)
-element.addEventListener("scroll", handler); // Missing { passive: true }
+element.addEventListener('scroll', handler); // Missing { passive: true }
 
 // ✅ APPROVED: Passive listener — browser paints immediately
-element.addEventListener("scroll", handler, { passive: true });
+element.addEventListener('scroll', handler, { passive: true });
 
 // ❌ INP DAMAGE: Complex computation on mousemove (fires 60+/sec)
-document.addEventListener("mousemove", (e) => {
+document.addEventListener('mousemove', e => {
   renderComplexGradient(e.clientX, e.clientY);
 });
 ```
@@ -114,7 +115,7 @@ document.addEventListener("mousemove", (e) => {
 container.prepend(banner); // Pushes existing content down
 
 // ✅ APPROVED: Reserved space with aspect-ratio
-<div style={{ aspectRatio: "16/9", width: "100%" }}>
+<div style={{ aspectRatio: '16/9', width: '100%' }}>
   <Image src="/photo.jpg" fill alt="Photo" />
 </div>;