tribunal-kit 2.4.6 → 3.1.0

package/.agent/skills/whimsy-injector/SKILL.md

@@ -24,11 +24,11 @@ You are a specialized agent for injecting "micro-delights" into user interfaces
 
 ## Whimsy Philosophy
 
-> **Whimsy is not decoration.** Every animation must serve a purpose:
-> - Guide attention → where should the user look?
-> - Confirm action → did the thing work?
-> - Create continuity → where did I come from, where am I going?
-> - Build personality → does this app feel human?
+**Whimsy is not decoration.** Every animation must serve a purpose:
+- Guide attention → where should the user look?
+- Confirm action → did the thing work?
+- Create continuity → where did I come from, where am I going?
+- Build personality → does this app feel human?
 
 **If an animation doesn't serve one of these purposes, don't add it.**
 
@@ -36,13 +36,13 @@ You are a specialized agent for injecting "micro-delights" into user interfaces
 
 ### Category 1: Entrance Animations
 
-| Pattern | Purpose | Duration | Trigger |
+|Pattern|Purpose|Duration|Trigger|
 |---|---|---|---|
-| Fade-up | Content appearing naturally | 300-400ms | On mount / viewport entry |
-| Scale-in | Modal or card emphasis | 200-300ms | On open / on mount |
-| Stagger cascade | List items loading sequentially | 50ms delay × index | On mount / data load |
-| Slide-in | Side panels, drawers | 250-350ms | On toggle |
-| Blur-to-sharp | Hero images, lazy content | 400-600ms | On image load |
+|Fade-up|Content appearing naturally|300-400ms|On mount / viewport entry|
+|Scale-in|Modal or card emphasis|200-300ms|On open / on mount|
+|Stagger cascade|List items loading sequentially|50ms delay × index|On mount / data load|
+|Slide-in|Side panels, drawers|250-350ms|On toggle|
+|Blur-to-sharp|Hero images, lazy content|400-600ms|On image load|
 
 **Framework Implementations:**
 
@@ -94,14 +94,14 @@ document.querySelectorAll('.reveal').forEach(el => observer.observe(el));
 
 ### Category 2: Hover & Interaction States
 
-| Pattern | CSS Implementation | Purpose |
+|Pattern|CSS Implementation|Purpose|
 |---|---|---|
-| Card lift | `transform: translateY(-2px); box-shadow: 0 8px 24px rgba(0,0,0,0.12)` | Clickable affordance |
-| Button press | `transform: scale(0.97)` on `:active` | Tactile feedback |
-| Link underline draw | `background-size: 100% 2px` from `0% 2px` | Navigation affordance |
-| Icon rotate | `transform: rotate(90deg)` on expand | State change indicator |
-| Color shift | `background-color` transition on hover | Interactive affordance |
-| Border glow | `box-shadow: 0 0 0 3px rgba(primary, 0.2)` on focus | Accessibility + delight |
+|Card lift|`transform: translateY(-2px); box-shadow: 0 8px 24px rgba(0,0,0,0.12)`|Clickable affordance|
+|Button press|`transform: scale(0.97)` on `:active`|Tactile feedback|
+|Link underline draw|`background-size: 100% 2px` from `0% 2px`|Navigation affordance|
+|Icon rotate|`transform: rotate(90deg)` on expand|State change indicator|
+|Color shift|`background-color` transition on hover|Interactive affordance|
+|Border glow|`box-shadow: 0 0 0 3px rgba(primary, 0.2)` on focus|Accessibility + delight|
 
 ```css
 /* Card Lift — Universal */
@@ -135,12 +135,12 @@ document.querySelectorAll('.reveal').forEach(el => observer.observe(el));
 
 ### Category 3: Loading & Skeleton States
 
-| Pattern | When | Duration |
+|Pattern|When|Duration|
 |---|---|---|
-| Shimmer pulse | Data fetching, image loading | Continuous until loaded |
-| Spinner-to-content | Short waits (< 2s) | Until complete |
-| Progress bar | File uploads, long processes | Mapped to actual progress |
-| Skeleton screen | Initial page paint | Until first data render |
+|Shimmer pulse|Data fetching, image loading|Continuous until loaded|
+|Spinner-to-content|Short waits (< 2s)|Until complete|
+|Progress bar|File uploads, long processes|Mapped to actual progress|
+|Skeleton screen|Initial page paint|Until first data render|
 
 ```css
 /* Shimmer Skeleton */
@@ -163,13 +163,13 @@ document.querySelectorAll('.reveal').forEach(el => observer.observe(el));
 
 ### Category 4: Micro-Feedback
 
-| Pattern | Trigger | Duration |
+|Pattern|Trigger|Duration|
 |---|---|---|
-| Success checkmark draw | Form submit success | 300ms |
-| Error shake | Validation failure | 300ms (3 oscillations) |
-| Counter tick-up | Stat change | 600ms (ease-out) |
-| Toast slide-in | Notification | 250ms in, 200ms out |
-| Confetti burst | Achievement, first-time completion | 1.5s |
+|Success checkmark draw|Form submit success|300ms|
+|Error shake|Validation failure|300ms (3 oscillations)|
+|Counter tick-up|Stat change|600ms (ease-out)|
+|Toast slide-in|Notification|250ms in, 200ms out|
+|Confetti burst|Achievement, first-time completion|1.5s|
 
 ```css
 /* Error Shake */
@@ -185,12 +185,12 @@ document.querySelectorAll('.reveal').forEach(el => observer.observe(el));
 
 ### Category 5: Page Transitions
 
-| Pattern | When | CSS Approach |
+|Pattern|When|CSS Approach|
 |---|---|---|
-| Crossfade | Default page change | `view-transition-name` (View Transitions API) |
-| Slide lateral | Tab switching, step wizard | `transform: translateX(±100%)` |
-| Scale + fade | Modal open/close | `scale(0.95)` + `opacity: 0` → `scale(1)` + `opacity: 1` |
-| Morph | Shared element between pages | `view-transition-name` on shared elements |
+|Crossfade|Default page change|`view-transition-name` (View Transitions API)|
+|Slide lateral|Tab switching, step wizard|`transform: translateX(±100%)`|
+|Scale + fade|Modal open/close|`scale(0.95)` + `opacity: 0` → `scale(1)` + `opacity: 1`|
+|Morph|Shared element between pages|`view-transition-name` on shared elements|
 
 ```css
 /* View Transitions API (Chrome 111+) */
@@ -206,33 +206,33 @@ document.querySelectorAll('.reveal').forEach(el => observer.observe(el));
 ## Whimsy Quota Rules
 
 > [!IMPORTANT]
-> Whimsy must be **tasteful, not invasive**. These are hard limits:
+Whimsy must be **tasteful, not invasive**. These are hard limits:
 
 ### Hard Constraints
-| Rule | Limit | Reason |
+|Rule|Limit|Reason|
 |---|---|---|
-| Max animation types per page | 3 distinct | Visual coherence |
-| Max concurrent animations | 5 elements | Performance |
-| `prefers-reduced-motion` | **MANDATORY** | Accessibility (WCAG 2.3.3) |
-| CLS impact | **Zero** | Core Web Vitals |
+|Max animation types per page|3 distinct|Visual coherence|
+|Max concurrent animations|5 elements|Performance|
+|`prefers-reduced-motion`|**MANDATORY**|Accessibility (WCAG 2.3.3)|
+|CLS impact|**Zero**|Core Web Vitals|
 
 ### Duration Constraints
-| Animation Type | Min | Max | Sweet Spot |
+|Animation Type|Min|Max|Sweet Spot|
 |---|---|---|---|
-| Entrance | 200ms | 500ms | 300ms |
-| Hover / Interaction | 100ms | 250ms | 150ms |
-| Feedback | 100ms | 400ms | 200ms |
-| Page transition | 150ms | 400ms | 250ms |
-| Loading (loop) | 1000ms | 2000ms | 1500ms |
+|Entrance|200ms|500ms|300ms|
+|Hover / Interaction|100ms|250ms|150ms|
+|Feedback|100ms|400ms|200ms|
+|Page transition|150ms|400ms|250ms|
+|Loading (loop)|1000ms|2000ms|1500ms|
 
 ### Easing Reference
-| Easing | CSS Value | Use For |
+|Easing|CSS Value|Use For|
 |---|---|---|
-| Standard | `cubic-bezier(0.4, 0, 0.2, 1)` | Most UI motion |
-| Decelerate | `cubic-bezier(0, 0, 0.2, 1)` | Entrances (coming into view) |
-| Accelerate | `cubic-bezier(0.4, 0, 1, 1)` | Exits (leaving view) |
-| Spring-like | `cubic-bezier(0.34, 1.56, 0.64, 1)` | Playful UI, toggles |
-| **Never** | `linear` | ❌ Not for UI motion |
+|Standard|`cubic-bezier(0.4, 0, 0.2, 1)`|Most UI motion|
+|Decelerate|`cubic-bezier(0, 0, 0.2, 1)`|Entrances (coming into view)|
+|Accelerate|`cubic-bezier(0.4, 0, 1, 1)`|Exits (leaving view)|
+|Spring-like|`cubic-bezier(0.34, 1.56, 0.64, 1)`|Playful UI, toggles|
+|**Never**|`linear`|❌ Not for UI motion|
 
 ### Mandatory Accessibility Block
 Every file with animations MUST include:
@@ -254,49 +254,15 @@ Every file with animations MUST include:
 - **Use `will-change` sparingly** — only on elements that are actively animating.
 - **Remove observers** when components unmount.
 
-## Output Format
-
-```
-🎭 Whimsy Injection Report
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Page/Component:  [name]
-Injections:      [count]
-Total duration:  [max concurrent animation time]
-
-━━━ Injection 1 ━━━━━━━━━━━━━━━━━━━━━━━━
-Target:     [element/component]
-Type:       [Entrance / Hover / Feedback / Loading / Transition]
-Animation:  [description]
-Duration:   [ms]
-Easing:     [value]
-Trigger:    [on-load / on-hover / on-scroll / on-action]
-A11y:       prefers-reduced-motion handled? ✅
-CLS risk:   None (transform + opacity only)
-Framework:  [CSS / Framer Motion / Vue / GSAP]
-
-[Code snippet]
-
-━━━ Injection 2 ━━━━━━━━━━━━━━━━━━━━━━━━
-...
-
-━━━ Checklist ━━━━━━━━━━━━━━━━━━━━━━━━━━
-✅ prefers-reduced-motion media query present
-✅ Only transform/opacity animated
-✅ Max 3 animation types on this page
-✅ No layout shift risk
-✅ Observers cleaned up on unmount
-```
-
 ## Cross-Skill Integration
 
-| Paired Skill | Integration Point |
+|Paired Skill|Integration Point|
 |---|---|
-| `trend-researcher` | Receives motion intent → implements specific animations |
-| `ui-ux-researcher` | Addresses P2.5 audit findings (missing micro-interactions) |
-| `frontend-design` | Ensures animations match component design tokens |
-| `performance-profiling` | Monitors that injections don't degrade Web Vitals |
-| `web-design-guidelines` | Validates animations against established UI patterns |
+|`trend-researcher`|Receives motion intent → implements specific animations|
+|`ui-ux-researcher`|Addresses P2.5 audit findings (missing micro-interactions)|
+|`frontend-design`|Ensures animations match component design tokens|
+|`performance-profiling`|Monitors that injections don't degrade Web Vitals|
+|`web-design-guidelines`|Validates animations against established UI patterns|
 
 ## Anti-Hallucination Guard
 
@@ -306,44 +272,4 @@ Framework:  [CSS / Framer Motion / Vue / GSAP]
 - **Never suggest animations that cause layout shift** — enforce `transform` and `opacity` only.
 - **Verify `will-change` usage** — only apply to actively animating elements, remove after animation completes.
 
-
----
-
-## 🤖 LLM-Specific Traps
-
-AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
-
-1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
-2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
-3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
-4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
-5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
-
 ---
-
-## 🏛️ Tribunal Integration (Anti-Hallucination)
-
-**Slash command: `/review` or `/tribunal-full`**
-**Active reviewers: `logic-reviewer` · `security-auditor`**
-
-### ❌ 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
-
-Review these questions before confirming output:
-```
-✅ 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?
-```
-
-### 🛑 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.

package/.agent/skills/workflow-optimizer/SKILL.md

@@ -27,18 +27,18 @@ You are a specialized agent for analyzing and optimizing the efficiency of AI ag
 
 Examine a sequence of tool calls and classify each into:
 
-| Pattern | Description | Waste Level | Fix |
+|Pattern|Description|Waste Level|Fix|
 |---|---|---|---|
-| **Redundant Read** | File read multiple times without changes | 🔴 High | Cache the content; read once |
-| **Blind Search** | `grep_search` or `find_by_name` when path was known | 🟡 Medium | Use `view_file` directly |
-| **Serial Bottleneck** | Independent calls made sequentially | 🔴 High | Parallelize with concurrent calls |
-| **Ping-Pong Edit** | Multiple `replace_file_content` on same file | 🟡 Medium | Combine into `multi_replace_file_content` |
-| **Over-Read** | `view_file` full file when only one function needed | 🟡 Medium | Use `view_code_item` or line ranges |
-| **Unnecessary Outline** | `view_file_outline` on a file already fully read | 🟢 Low | Skip — content already in context |
-| **Search Then Read** | `grep_search` → `view_file` → `view_code_item` | 🟡 Medium | Skip directly to relevant tool |
-| **Repeated Status** | Multiple `command_status` calls before completion | 🟢 Low | Use `WaitDurationSeconds` parameter |
-| **Task Churn** | `task_boundary` called every single tool call | 🟡 Medium | Update every 3-5 tool calls |
-| **Context Dump** | Reading entire large files into context | 🔴 High | Targeted reads with line ranges |
+|**Redundant Read**|File read multiple times without changes|🔴 High|Cache the content; read once|
+|**Blind Search**|`grep_search` or `find_by_name` when path was known|🟡 Medium|Use `view_file` directly|
+|**Serial Bottleneck**|Independent calls made sequentially|🔴 High|Parallelize with concurrent calls|
+|**Ping-Pong Edit**|Multiple `replace_file_content` on same file|🟡 Medium|Combine into `multi_replace_file_content`|
+|**Over-Read**|`view_file` full file when only one function needed|🟡 Medium|Use `view_code_item` or line ranges|
+|**Unnecessary Outline**|`view_file_outline` on a file already fully read|🟢 Low|Skip — content already in context|
+|**Search Then Read**|`grep_search` → `view_file` → `view_code_item`|🟡 Medium|Skip directly to relevant tool|
+|**Repeated Status**|Multiple `command_status` calls before completion|🟢 Low|Use `WaitDurationSeconds` parameter|
+|**Task Churn**|`task_boundary` called every single tool call|🟡 Medium|Update every 3-5 tool calls|
+|**Context Dump**|Reading entire large files into context|🔴 High|Targeted reads with line ranges|
 
 ### 2. Parallelism Opportunity Detection
 
@@ -65,34 +65,34 @@ Identify tool calls that have no data dependencies and should run simultaneously
 
 Evaluate `task.md` and `task_boundary` usage:
 
-| Issue | Symptom | Fix |
+|Issue|Symptom|Fix|
 |---|---|---|
-| **Too Granular** | One `task_boundary` per tool call | Group into logical phases (3-8 calls per task) |
-| **Too Broad** | One task for entire request | Break into Planning → Execution → Verification |
-| **Stale Summary** | `TaskSummary` repeating same text | Accumulate new info each update |
-| **Backward Status** | `TaskStatus` describes what was *done* | Must describe what *will happen next* |
-| **Missing Mode** | Never switches between PLANNING/EXECUTION/VERIFICATION | Use mode transitions to signal phase changes |
+|**Too Granular**|One `task_boundary` per tool call|Group into logical phases (3-8 calls per task)|
+|**Too Broad**|One task for entire request|Break into Planning → Execution → Verification|
+|**Stale Summary**|`TaskSummary` repeating same text|Accumulate new info each update|
+|**Backward Status**|`TaskStatus` describes what was *done*|Must describe what *will happen next*|
+|**Missing Mode**|Never switches between PLANNING/EXECUTION/VERIFICATION|Use mode transitions to signal phase changes|
 
 ### 4. Context Window Budget Analysis
 
-| Metric | Target | Action if Exceeded |
+|Metric|Target|Action if Exceeded|
 |---|---|---|
-| Total lines read | < 500 per task phase | Filter to relevant sections |
-| Files in context | < 10 simultaneously | Prioritize; drop stale reads |
-| Search results | < 20 matches | Narrow filters (`Includes`, `Pattern`) |
-| File reads per file | 1 per phase | Cache mentally; don't re-read |
-| Artifact updates | < 5 per task | Batch updates |
+|Total lines read|< 500 per task phase|Filter to relevant sections|
+|Files in context|< 10 simultaneously|Prioritize; drop stale reads|
+|Search results|< 20 matches|Narrow filters (`Includes`, `Pattern`)|
+|File reads per file|1 per phase|Cache mentally; don't re-read|
+|Artifact updates|< 5 per task|Batch updates|
 
 ### 5. Error Recovery Efficiency
 
 Analyze how errors are handled:
 
-| Pattern | Efficiency | Better Approach |
+|Pattern|Efficiency|Better Approach|
 |---|---|---|
-| Retry same command identically | 🔴 Wasted | Analyze error first, modify approach |
-| Read error → re-read entire file | 🟡 Inefficient | Read only the relevant section |
-| Tool error → ask user | 🟡 Premature | Try alternative approach first |
-| Build error → fix one issue → rebuild | 🟢 OK if targeted | Batch multiple fixes before rebuild |
+|Retry same command identically|🔴 Wasted|Analyze error first, modify approach|
+|Read error → re-read entire file|🟡 Inefficient|Read only the relevant section|
+|Tool error → ask user|🟡 Premature|Try alternative approach first|
+|Build error → fix one issue → rebuild|🟢 OK if targeted|Batch multiple fixes before rebuild|
 
 ## Optimization Metrics
 
@@ -176,44 +176,4 @@ Before analyzing, check for these common quick wins:
 - **Never fabricate efficiency scores** — always calculate from actual vs optimal counts.
 - **Acknowledge uncertainty**: "Cannot determine if calls 3-5 had data dependency — may be correctly sequential."
 
-
----
-
-## 🤖 LLM-Specific Traps
-
-AI coding assistants often fall into specific bad habits when dealing with this domain. These are strictly forbidden:
-
-1. **Over-engineering:** Proposing complex abstractions or distributed systems when a simpler approach suffices.
-2. **Hallucinated Libraries/Methods:** Using non-existent methods or packages. Always `// VERIFY` or check `package.json` / `requirements.txt`.
-3. **Skipping Edge Cases:** Writing the "happy path" and ignoring error handling, timeouts, or data validation.
-4. **Context Amnesia:** Forgetting the user's constraints and offering generic advice instead of tailored solutions.
-5. **Silent Degradation:** Catching and suppressing errors without logging or re-raising.
-
 ---
-
-## 🏛️ Tribunal Integration (Anti-Hallucination)
-
-**Slash command: `/review` or `/tribunal-full`**
-**Active reviewers: `logic-reviewer` · `security-auditor`**
-
-### ❌ 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
-
-Review these questions before confirming output:
-```
-✅ 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?
-```
-
-### 🛑 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.