@8gi-foundation/8gent-code 0.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.
@@ -0,0 +1,180 @@
1
+ ---
2
+ name: billiondollarboardroom
3
+ description: Summons 8 business legends as AI advisors to deliberate on any business, marketing, sales, or growth problem. Each expert analyses through their proven framework. Returns consensus recommendations and areas of tension.
4
+ trigger: /billiondollarboardroom
5
+ aliases: [/bdb, /billionboard]
6
+ ---
7
+
8
+ # Billion Dollar Boardroom
9
+
10
+ **8 Business Legends. 1 Deliberation. Your Unfair Advantage.**
11
+
12
+ Summons Alex Hormozi, Grant Cardone, Seth Godin, Gary Vee, Jordan Belfort, Russell Brunson, Dan Kennedy, and Tony Robbins as AI advisors. Each analyses the problem through their signature framework, debates tensions, and converges on ranked recommendations.
13
+
14
+ ---
15
+
16
+ ## When to Use
17
+
18
+ - Pricing decisions — what to charge, how to structure tiers
19
+ - Offer design — what to bundle, how to position
20
+ - Sales process — how to close, handle objections, increase volume
21
+ - Marketing strategy — positioning, content, channels, funnels
22
+ - Growth problems — stalled revenue, poor conversion, weak pipeline
23
+ - Product launches — sequencing, messaging, mechanism
24
+ - Any time you need commercial thinking that goes beyond tech
25
+
26
+ ---
27
+
28
+ ## The 8 Board Members
29
+
30
+ ### 1. ALEX HORMOZI — The Offer Architect
31
+ **Core:** "Make your offer so good, people feel stupid saying no."
32
+ **Frameworks:**
33
+ - Value Equation: `Value = (Dream Outcome × Perceived Likelihood) / (Time Delay × Effort & Sacrifice)`
34
+ - Grand Slam Offer: List every ICP problem → specific solution per problem → bundle → guarantee → scarcity → premium name
35
+ - Pricing Ladder: Entry $500-$2K → Core $5K-$25K → Premium $25K-$100K → Elite $100K+ (equity/profit-share)
36
+ - LTV Formula: `LTV = Deal Size × Transactions × Customer Lifespan`
37
+ **His lens:** Is the offer irresistible? Is value perceived high enough? What risk reversal makes this a no-brainer?
38
+
39
+ ---
40
+
41
+ ### 2. GRANT CARDONE — The 10X Sales Master
42
+ **Core:** "10X your goals, 10X your actions, 10X your thinking."
43
+ **Frameworks:**
44
+ - 10X Rule: Set goals 10X bigger → forces different strategies, not just harder effort
45
+ - Four Degrees of Action: Do Nothing → Retreat → Normal Action → **Massive Action** (only one wins)
46
+ - Sales Multiplication: More prospects, more touches (10-20+), more channels, more frequency
47
+ - Follow-Up Formula: Day 1 contact → Day 2 call → Day 3 video → Day 7 check-in → Day 14 case study → Day 21 final offer → Day 30+ never stop
48
+ - Objection System: Acknowledge → Isolate ("Is this the ONLY thing stopping you?") → Reframe → Close again
49
+ **His lens:** Are we taking massive enough action? Is volume 10X what we think is needed? Are we giving up too early in follow-up?
50
+
51
+ ---
52
+
53
+ ### 3. SETH GODIN — The Positioning Genius
54
+ **Core:** "Don't find customers for your products, find products for your customers."
55
+ **Frameworks:**
56
+ - Purple Cow: Being "very good" is invisible. Being remarkable is the only strategy. Would someone voluntarily talk about this?
57
+ - Smallest Viable Market: "Who's it for?" Define minimum viable audience → understand their worldview → build for THEM → dominate before expanding
58
+ - Story Framework: Status Quo (pain) → External Problem (surface) → Internal Problem (emotional) → Philosophical Problem (injustice) → The Change (transformation)
59
+ - Positioning Statement: "[Brand] is for [specific people] who believe [worldview]. Unlike [alternative], we [key difference] so that [outcome they care about]."
60
+ **His lens:** Is this remarkable enough to spread? Are we too broad? Does the positioning make the ICP say "this is exactly for me"?
61
+
62
+ ---
63
+
64
+ ### 4. GARY VEE — The Content Strategist
65
+ **Core:** "Document, don't create."
66
+ **Frameworks:**
67
+ - Jab Jab Jab Right Hook: Give, give, give, then ask. 80% value / 20% CTA.
68
+ - Content Pyramid: 1 pillar piece → 20-100 micro content pieces (posts, carousels, videos, threads)
69
+ - Volume Strategy: Minimum 5-7 posts/week. Elite: 10-14 posts + 30-50 comments/day. `Volume × Quality × Consistency × Time = Market Dominance`
70
+ - Personal Brand Pillars: Authenticity, Expertise, Consistency, Vulnerability, Value
71
+ - Content Mix: 40% Educational, 30% Inspirational, 20% Personal, 10% Promotional
72
+ **His lens:** Are we documenting everything? Is content volume a fraction of what's needed? What pillar content can we atomise right now?
73
+
74
+ ---
75
+
76
+ ### 5. JORDAN BELFORT — The Sales Psychology Expert
77
+ **Core:** "Every sale is a transfer of certainty from you to your prospect."
78
+ **Frameworks:**
79
+ - Straight Line System — Three Tens: Prospects need 10/10 certainty on Product ("this will solve my problem"), Trust ("I trust this person"), Company ("this company will deliver")
80
+ - Looping Technique: Hit objection → Acknowledge → Loop back to build certainty → Re-attempt close. Loop 3-5 times per call.
81
+ - Tonality Framework: Absolute Certainty (product/features) | Reasonable Man (price) | Empathy/Sincerity (pain points) | Mystery/Intrigue (value props)
82
+ - High-Ticket Close: Rapport fast (90 sec) → Qualify hard (pain + budget) → Present with certainty → Assume sale → Loop objections → Close with urgency
83
+ **His lens:** How certain does the prospect feel? Are we looping enough? Is our tonality calibrated to what we're talking about?
84
+
85
+ ---
86
+
87
+ ### 6. RUSSELL BRUNSON — The Funnel Architect
88
+ **Core:** "A business without a funnel is bleeding money."
89
+ **Frameworks:**
90
+ - Value Ladder: Lead Magnet (Free) → Tripwire ($100-$500) → Core Offer ($1K-$10K) → High-Ticket ($10K-$100K+)
91
+ - High-Ticket B2B Funnel: LinkedIn Post → Lead Magnet → Thank You Page → Application → Calendar → Sales Call
92
+ - Perfect Webinar: Origin Story (5-10 min) → One Thing (5 min) → Three Secrets (30-45 min) → The Stack (10-15 min) → The Close (10-15 min)
93
+ - SOAP Opera Sequence: Day 1 Stage Set → Day 2 High Drama → Day 3 Epiphany → Day 4 Hidden Benefits → Day 5 Urgency + CTA
94
+ **His lens:** Where is the funnel leaking? Is there a value ladder? What's the ascension path from free to high-ticket?
95
+
96
+ ---
97
+
98
+ ### 7. DAN KENNEDY — The High-Ticket Marketing Specialist
99
+ **Core:** "Make money, not excuses."
100
+ **Frameworks:**
101
+ - Message-Market-Media Match: Message (USP/offer/positioning) + Market (problems/desires/beliefs) + Media (channel/format) — all three must align. Diagnose which is broken when marketing fails.
102
+ - Magnetic Marketing: Capture Attention → Educate + Build Authority → Make Irresistible Offer → Follow Up Relentlessly (7-12 touches)
103
+ - High-Ticket Positioning — 5 Pillars: Exclusivity (you don't work with everyone) | Authority (you prescribe, not pitch) | Results-Focused (outcomes not services) | Professional Presentation | Premium Pricing (never apologise for price)
104
+ - Sales Letter Formula: Headline → Lead → Story → Offer → Proof → Stack → Price → Guarantee → Scarcity → CTA → P.S.
105
+ - Marketing to the Affluent: They value time over money. They buy status and exclusivity. They want experts not vendors. They buy on emotion, justify with logic.
106
+ **His lens:** Are message, market, and media aligned? Are we positioned as the exclusive expert or just another vendor? Are we marketing to the affluent correctly?
107
+
108
+ ---
109
+
110
+ ### 8. TONY ROBBINS — The Peak Performance Strategist
111
+ **Core:** "The only thing keeping you from getting what you want is the story you keep telling yourself."
112
+ **Frameworks:**
113
+ - Six Human Needs: Certainty (comfort) | Uncertainty (adventure) | Significance (uniqueness) | Connection (belonging) | Growth (progress) | Contribution (legacy) — position your offer to fulfil the need your prospect values most
114
+ - State Management Triad: Physiology (body/posture/breath) + Focus (problems vs solutions) + Language (empowering vs disempowering) → Peak state → Peak decisions → Peak results
115
+ - Raving Fan Formula: Meet Expectations (satisfied) → Exceed Expectations (happy) → Create Raving Fans (evangelists). 1 Raving Fan = 3-5 referrals/year + social proof + higher LTV
116
+ - Ultimate Success Formula: Know Outcome (specific/measurable) → Massive Action → Know What's Working (measure everything) → Change Approach (pivot until outcome hit)
117
+ - Power of Decisions: Committed decisions (all in, no hedging), cut off alternatives, take immediate action
118
+ **His lens:** What story is blocking progress? Which human need does this offer fulfil? Are we creating raving fans or just satisfied customers?
119
+
120
+ ---
121
+
122
+ ## The Deliberation Process
123
+
124
+ When invoked with a business problem:
125
+
126
+ ### Phase 1 — Each Expert Analyses (parallel)
127
+ Each expert responds through ONLY their framework:
128
+ - Position (1-2 sentences on what they see)
129
+ - Key Framework Applied (which specific tool)
130
+ - Critical Issue (what they'd fix first)
131
+ - Recommendation (concrete, actionable)
132
+
133
+ ### Phase 2 — Boardroom Table
134
+ Present all 8 positions in a structured table:
135
+
136
+ ```
137
+ BILLION DOLLAR BOARDROOM
138
+ ========================
139
+ HORMOZI: [offer/pricing insight]
140
+ CARDONE: [volume/sales insight]
141
+ GODIN: [positioning/remarkability insight]
142
+ GARY VEE: [content/distribution insight]
143
+ BELFORT: [sales psychology/certainty insight]
144
+ BRUNSON: [funnel/ascension insight]
145
+ KENNEDY: [message-market-media insight]
146
+ ROBBINS: [psychology/state/human needs insight]
147
+
148
+ CONSENSUS: [what all 8 agree on]
149
+ TENSIONS: [where they conflict]
150
+ WILDCARD: [most counterintuitive advice]
151
+ ```
152
+
153
+ ### Phase 3 — Ranked Action Plan
154
+ Synthesise into 3-5 ranked, specific actions:
155
+ 1. **Immediate** (this week): highest leverage, lowest effort
156
+ 2. **Short-term** (30 days): structural changes
157
+ 3. **Strategic** (90 days): positioning/system changes
158
+
159
+ ---
160
+
161
+ ## Example Trigger
162
+
163
+ ```
164
+ User: "/billiondollarboardroom — we're pricing our AI vessel platform at $299/month but nobody's converting from the free tier"
165
+
166
+ → 8 experts each analyse through their frameworks
167
+ → Boardroom table presented
168
+ → Consensus: offer re-engineering + funnel gap identified
169
+ → Ranked actions with specific frameworks applied
170
+ ```
171
+
172
+ ---
173
+
174
+ ## Rules
175
+
176
+ 1. Each expert speaks in their authentic voice — Cardone is intense, Godin is philosophical, Belfort is certain, Robbins is empowering
177
+ 2. Experts can disagree — tension is valuable signal
178
+ 3. No generic advice — every recommendation cites a specific framework from the reference
179
+ 4. Output is actionable — not theoretical
180
+ 5. The user is the Chairman — they have final veto on all recommendations
@@ -0,0 +1,106 @@
1
+ ---
2
+ name: clone-react
3
+ description: 8gent's component extraction workflow. Apply when recreating a UI component from a screenshot, website, or design reference.
4
+ type: skill
5
+ ---
6
+
7
+ # Clone React
8
+
9
+ Cloning is reverse-engineering design decisions, not copying code. Understand why something works before rebuilding it.
10
+
11
+ ## The 5-Step Workflow
12
+
13
+ ### Step 1 - Screenshot and Describe
14
+
15
+ Before touching any code, analyze the target:
16
+ - What is the visual hierarchy?
17
+ - What spacing system is in use? (4px? 8px? Custom?)
18
+ - What are the color relationships?
19
+ - What typography scale is visible?
20
+ - What interaction states exist? (hover, focus, active, disabled)
21
+
22
+ Write this down before building. If you can't articulate why something works, you're not ready to build it.
23
+
24
+ ### Step 2 - Identify Design Tokens
25
+
26
+ Map what you see to values:
27
+
28
+ | Observed | Token candidate |
29
+ |----------|----------------|
30
+ | Padding ~24px | `spacing.lg` (24px on 8px grid) |
31
+ | Font ~14px/20px | `text-sm` or `typography.small` |
32
+ | `#1a1a1a` | Check against `colors.text.primary` |
33
+ | Subtle shadow | `shadow-sm` or `elevation.low` |
34
+ | Rounded corners ~8px | `radius.md` |
35
+
36
+ If no match exists in the design system, add the token — don't hardcode.
37
+
38
+ ### Step 3 - Map to Existing Primitives
39
+
40
+ Check what already exists before building:
41
+ - `packages/skills/design-excellence` tokens
42
+ - `apps/tui/src/components/primitives/` for TUI work
43
+ - Your project's component library
44
+
45
+ The best cloned component is one that uses 90% existing primitives.
46
+
47
+ ### Step 4 - Build with System Components
48
+
49
+ ```tsx
50
+ // Wrong - raw extraction
51
+ <div style={{ padding: '24px', borderRadius: '8px', boxShadow: '0 1px 3px rgba(0,0,0,0.1)' }}>
52
+
53
+ // Right - system primitives
54
+ <Card padding="lg" elevation="low">
55
+ ```
56
+
57
+ Rules:
58
+ - Never copy-paste CSS from DevTools. Always translate to design tokens.
59
+ - No magic numbers. Every value traces to a token.
60
+ - No inline styles except genuinely dynamic values (width from JS, etc.).
61
+ - Props typed. No `any`.
62
+
63
+ ### Step 5 - Verify All States and Responsiveness
64
+
65
+ Every component must handle:
66
+ - [ ] Default state
67
+ - [ ] Hover state
68
+ - [ ] Focus state (keyboard accessible — `focus-visible`)
69
+ - [ ] Active / pressed state
70
+ - [ ] Disabled state
71
+ - [ ] Loading state (if applicable)
72
+ - [ ] Error state (if applicable)
73
+ - [ ] Empty state (if applicable)
74
+
75
+ Responsive:
76
+ - Mobile-first. Design for 375px, scale up.
77
+ - No fixed pixel widths on layout elements.
78
+ - Tables: horizontal scroll container on mobile.
79
+ - Grids: 1 col < 600px, 2 col at 768px, full grid at 960px+.
80
+
81
+ ## Anti-Patterns
82
+
83
+ - **Pixel-perfect obsession** - 1px differences don't matter. Patterns do.
84
+ - **Style soup** - 50 CSS properties when 5 design tokens work.
85
+ - **Missing states** - Default state only is not a complete component.
86
+ - **Hardcoded content** - Extracted text as a string, not a prop.
87
+ - **Ignoring system** - Building from scratch when a primitive exists.
88
+ - **Wholesale CSS copy** - Never paste a block of DevTools CSS directly.
89
+
90
+ ## Accessibility Requirements
91
+
92
+ - Semantic HTML: `<button>` not `<div onClick>`, `<nav>` not `<div class="nav">`
93
+ - ARIA labels for icon-only elements
94
+ - Keyboard navigable (tab order, enter/space for buttons)
95
+ - Focus visible (never `outline: none` without a replacement)
96
+
97
+ ## Checklist Before Shipping the Clone
98
+
99
+ - [ ] All 5 steps completed in order
100
+ - [ ] Every value traces to a design token
101
+ - [ ] No inline styles except dynamic values
102
+ - [ ] All interaction states handled
103
+ - [ ] Semantic HTML and ARIA correct
104
+ - [ ] Keyboard navigable
105
+ - [ ] Responsive at 375px, 768px, 1440px
106
+ - [ ] Component accepts props — no hardcoded content
@@ -0,0 +1,97 @@
1
+ ---
2
+ name: design-excellence
3
+ description: 8gent's design philosophy and system. Apply when building any UI — TUI, web, or artifact. Design is intentional structure, not decoration.
4
+ type: skill
5
+ ---
6
+
7
+ # Design Excellence
8
+
9
+ Design is **intentional structure**. Every element serves a purpose. Restraint creates impact.
10
+
11
+ ## Core Principles
12
+
13
+ 1. **Visual hierarchy first** - Guide the eye. Not everything is equally important.
14
+ 2. **Restraint amplifies impact** - 3-4 colors max. 2-3 font families max. Whitespace is not wasted space.
15
+ 3. **Consistency is trust** - Same patterns, same spacing, same tokens throughout.
16
+ 4. **Accessibility is non-negotiable** - WCAG 2.1 AA minimum. High contrast. Keyboard navigation.
17
+
18
+ ## Grid and Spacing
19
+
20
+ - Base unit: **8px** (use multiples: 4, 8, 16, 24, 32, 48, 64)
21
+ - Every element has a defined place. No arbitrary margins.
22
+ - Fixed sidebars/navigation prevent layout shifts.
23
+ - Consistent padding within components (don't mix values without reason).
24
+
25
+ ```
26
+ Spacing tokens:
27
+ xs = 4px sm = 8px md = 16px
28
+ lg = 24px xl = 32px 2xl = 48px 3xl = 64px
29
+ ```
30
+
31
+ ## Typography
32
+
33
+ - **Scale**: Display 64px / H1 48px / H2 32px / H3 24px / Body 16px / Small 14px / Tiny 12px
34
+ - At least 2x size difference between adjacent hierarchy levels.
35
+ - Line-height: 1.5-1.6 for body, tighter (1.1-1.3) for headings.
36
+ - Labels and technical data: uppercase, monospace or small caps.
37
+ - Prefer system font stack for body. Use a single display font for character.
38
+
39
+ ## Color
40
+
41
+ Rules that cannot be broken:
42
+ - Max 3-4 colors in the primary palette.
43
+ - Accent color for emphasis only — not decoration.
44
+ - WCAG AA contrast ratio (4.5:1 for text, 3:1 for UI elements).
45
+ - Color must not be the only way information is conveyed.
46
+ - In terminals: never use `gray`, `white`, or `black` — use `dimColor`, semantic tokens, or safe ANSI colors.
47
+
48
+ Semantic mappings:
49
+ | Role | Use |
50
+ |------|-----|
51
+ | Primary | Brand, key actions |
52
+ | Success | green |
53
+ | Error | red |
54
+ | Warning | yellow |
55
+ | Muted | dimColor / secondary text |
56
+ | Accent | Single vibrant color, sparingly |
57
+
58
+ ## Component Hierarchy
59
+
60
+ Build atoms first, compose up:
61
+ - **Atoms**: Button, Input, Badge, Icon, Text
62
+ - **Molecules**: FormField, Card, SearchBar, Alert
63
+ - **Organisms**: Header, Sidebar, DataTable, Modal
64
+
65
+ Never skip levels. A screen composes organisms. An organism composes molecules.
66
+
67
+ ## Layout Patterns
68
+
69
+ - **Dashboard**: Fixed sidebar (240-320px) + flexible scrollable content
70
+ - **Data display**: Grid-based equal-height cards, consistent gutters
71
+ - **Content-heavy**: Column layout, clear typographic hierarchy
72
+
73
+ ## Interaction Design
74
+
75
+ - No unexpected layout shifts. Reserve space for dynamic content.
76
+ - Smart scroll: only auto-scroll if user is within 100px of bottom.
77
+ - Keyboard shortcuts visible. Focus order logical. CMD+K for command palettes.
78
+ - All interactive states designed: default, hover, focus, active, disabled, loading, error, empty.
79
+
80
+ ## Anti-Patterns
81
+
82
+ - No grid system - random spacing, no visual structure
83
+ - Too many colors - no focus, no hierarchy
84
+ - Arbitrary spacing - breaks visual rhythm
85
+ - Layout shifts on load or state change
86
+ - Cluttered density - use tabs, accordions, modals instead of cramming
87
+ - Weak contrast - if you have to squint, it fails
88
+
89
+ ## Checklist Before Shipping
90
+
91
+ - [ ] 8px grid - all spacing is a multiple of 4 or 8
92
+ - [ ] Max 4 colors, max 3 font families
93
+ - [ ] WCAG AA contrast verified
94
+ - [ ] All interactive states designed (hover, focus, disabled, error, empty)
95
+ - [ ] Keyboard navigable
96
+ - [ ] No layout shifts
97
+ - [ ] Consistent tokens throughout (no magic numbers)
@@ -0,0 +1,99 @@
1
+ ---
2
+ name: dogfood-qa
3
+ description: 8gent's QA workflow for systematic exploration and bug reporting. Apply when asked to QA, dogfood, test, or find issues in a TUI or web interface.
4
+ type: skill
5
+ ---
6
+
7
+ # Dogfood QA
8
+
9
+ Systematic exploration of every UI surface. Repro-first. Evidence for every finding.
10
+
11
+ ## Priority Levels
12
+
13
+ | Level | Definition |
14
+ |-------|-----------|
15
+ | P0 | Crash, hang, data loss, security breach |
16
+ | P1 | Core feature broken, no workaround |
17
+ | P2 | Broken UX, has workaround |
18
+ | P3 | Cosmetic, typo, minor misalignment |
19
+
20
+ Aim for 5-10 well-documented issues. Depth of evidence beats issue count.
21
+
22
+ ## Workflow
23
+
24
+ ```
25
+ 1. Orient - Understand the app structure before diving in
26
+ 2. Explore - Visit every surface systematically
27
+ 3. Document - Repro immediately when an issue is found
28
+ 4. Wrap up - Severity counts, summary, next steps
29
+ ```
30
+
31
+ ### 1. Orient
32
+
33
+ - Take an initial screenshot of the starting state.
34
+ - Map the main navigation and list sections to visit.
35
+ - Note the terminal size / viewport for TUI work.
36
+
37
+ ### 2. Explore
38
+
39
+ Work through the app top-to-bottom, feature-by-feature:
40
+ - Visit every top-level navigation section.
41
+ - Test interactive elements: buttons, inputs, dropdowns, modals, keyboard shortcuts.
42
+ - Try edge cases: empty state, long input, special characters, rapid clicks.
43
+ - Run end-to-end workflows: create, edit, delete.
44
+ - Check console/logs for errors after each interaction.
45
+
46
+ For TUI specifically:
47
+ - Test at narrow (80 col), standard (120 col), and wide (160+ col) terminal widths.
48
+ - Test at short (24 row) and tall (50+ row) terminal heights.
49
+ - Verify all keyboard navigation paths work (tab, arrow keys, enter, esc).
50
+ - Test screen reader output if applicable.
51
+
52
+ ### 3. Document Issues (Repro-First)
53
+
54
+ Document immediately when found. Never batch for later.
55
+
56
+ Every issue requires:
57
+ - **Title**: Short, active voice ("Submit button crashes on empty input")
58
+ - **Priority**: P0-P3
59
+ - **Steps to reproduce**: Numbered, specific
60
+ - **Expected**: What should happen
61
+ - **Actual**: What actually happens
62
+ - **Evidence**: Screenshot for static issues, recording for interactive issues
63
+
64
+ Interactive/behavioral issues - full repro:
65
+ 1. Start recording before reproducing.
66
+ 2. Step through at human pace (pause between actions).
67
+ 3. Capture broken state with annotated screenshot.
68
+ 4. Stop recording.
69
+ 5. Write numbered steps referencing screenshots.
70
+
71
+ Static issues (typo, misalignment, wrong color) - single annotated screenshot is enough. No video needed.
72
+
73
+ Increment issue counter: ISSUE-001, ISSUE-002, ...
74
+
75
+ ### 4. Wrap Up
76
+
77
+ - Update severity counts to match actual issues found.
78
+ - Summarize: total issues, breakdown by priority, top P0/P1 findings.
79
+ - Close session / reset state.
80
+
81
+ ## Rules
82
+
83
+ - Repro is everything. If you can't reproduce it, don't report it.
84
+ - Screenshot each step for interactive issues. Label them step-1, step-2, result.
85
+ - Check keyboard navigation on every interactive element.
86
+ - Never read the target app's source code during QA — test as a user.
87
+ - Never delete output files mid-session. Work forward.
88
+ - Write findings as you go. If session is interrupted, findings are preserved.
89
+
90
+ ## Checklist
91
+
92
+ - [ ] All navigation sections visited
93
+ - [ ] Empty states tested
94
+ - [ ] Error states triggered
95
+ - [ ] Keyboard-only navigation verified
96
+ - [ ] Multiple terminal sizes tested (TUI)
97
+ - [ ] Console/logs checked for silent errors
98
+ - [ ] End-to-end workflows completed (create, edit, delete)
99
+ - [ ] Every issue has repro steps and evidence
@@ -0,0 +1,104 @@
1
+ ---
2
+ name: motion-design
3
+ description: 8gent's animation and motion rules for web and TUI. Apply when adding transitions, loading states, or interactive feedback to any interface.
4
+ type: skill
5
+ ---
6
+
7
+ # Motion Design
8
+
9
+ Motion is communication. When done right, it's invisible — users just feel like the interface understands them.
10
+
11
+ ## Purpose Order
12
+
13
+ 1. **Feedback** - Confirm an action happened (click, submit, error)
14
+ 2. **Orientation** - Show where something came from or is going
15
+ 3. **Delight** - Add personality to moments that deserve it
16
+
17
+ Never animate just because you can.
18
+
19
+ ## Timing
20
+
21
+ | Type | Duration | Use |
22
+ |------|----------|-----|
23
+ | Micro-interaction | 100-150ms | Hover, focus, toggle, button press |
24
+ | Standard transition | 200-300ms | Modal open/close, menu, navigation |
25
+ | Entrance / complex | 300-500ms | Page transitions, staggered lists |
26
+
27
+ Rules:
28
+ - Feedback must be under 200ms — anything slower feels broken.
29
+ - Never exceed 500ms for a single animation.
30
+ - Small elements animate faster than large surfaces.
31
+ - Stagger grouped elements (50ms between children).
32
+
33
+ ## Easing
34
+
35
+ | Curve | When |
36
+ |-------|------|
37
+ | ease-out | Entrances — arrives fast, settles gently |
38
+ | ease-in | Exits — builds momentum before leaving |
39
+ | ease-in-out | Panel slides, drawer moves |
40
+ | spring | Organic moments (sparingly) |
41
+
42
+ Never use `linear` for UI motion — it feels mechanical.
43
+
44
+ ## Terminal-Specific Patterns
45
+
46
+ - **Cursor blink**: Standard terminal rate (530ms on/off). Don't override unless showing custom state.
47
+ - **Text fade-in**: Opacity 0 -> 1 at 150ms for arriving content. Keeps the terminal feel without harsh pops.
48
+ - **Progressive reveal**: Stream text or list items one at a time instead of all-at-once. Faster perceived response.
49
+ - **Spinner frames**: 80-100ms per frame for a smooth feel. Use Unicode block characters for smooth animation.
50
+ - **Status transitions**: Dim old status, pause 50ms, show new status. Prevents jarring state jumps.
51
+
52
+ ## What to Animate
53
+
54
+ Good candidates:
55
+ - State changes: open/close, selected/unselected, on/off
56
+ - Entrances and exits: modals, menus, notifications, new list items
57
+ - Feedback: button press, form submission, error shake
58
+ - Loading: skeleton screens, progress bars, spinners
59
+
60
+ Skip animation for:
61
+ - High-frequency actions (context menus, tooltips that repeat)
62
+ - Large amounts of content (50 list items animating is noise)
63
+ - User-initiated instant actions (typing)
64
+ - Anything that delays task completion
65
+
66
+ ## Performance
67
+
68
+ - Animate only `transform` and `opacity` — compositor properties only.
69
+ - Never animate `width`, `height`, `top`, `left`, `margin`, `padding` on large elements.
70
+ - Max 3 concurrent animations. More than that is visual noise.
71
+ - Test on low-powered devices and reduced-motion settings.
72
+
73
+ ## Accessibility (MANDATORY)
74
+
75
+ ```css
76
+ @media (prefers-reduced-motion: reduce) {
77
+ *, *::before, *::after {
78
+ animation-duration: 0.01ms !important;
79
+ transition-duration: 0.01ms !important;
80
+ animation-iteration-count: 1 !important;
81
+ }
82
+ }
83
+ ```
84
+
85
+ - Never use motion as the only way to convey information.
86
+ - Pause looping animations when off-screen.
87
+
88
+ ## Animation Budget
89
+
90
+ | Budget item | Limit |
91
+ |-------------|-------|
92
+ | Concurrent animations | 3 max |
93
+ | Single animation duration | 500ms max |
94
+ | Stagger delay per child | 50ms |
95
+ | Feedback latency | 200ms max |
96
+
97
+ ## Checklist
98
+
99
+ - [ ] Does this animation serve feedback, orientation, or delight?
100
+ - [ ] Duration is under 500ms
101
+ - [ ] Entrances use ease-out
102
+ - [ ] Only transform/opacity animated
103
+ - [ ] prefers-reduced-motion handled
104
+ - [ ] Tested at 60fps on target device
@@ -0,0 +1,86 @@
1
+ ---
2
+ name: team-validation
3
+ description: 8gent's code review and validation pattern. Use when orchestrating multi-agent workflows or reviewing code for correctness, security, and performance.
4
+ type: skill
5
+ ---
6
+
7
+ # Team Validation
8
+
9
+ No agent should build and validate its own work. Separation of concerns applies to AI workflows.
10
+
11
+ ## Core Rule
12
+
13
+ **Builder implements. Validator verifies. They are never the same agent.**
14
+
15
+ ## Agent Roles
16
+
17
+ ### Builder
18
+ - Full tool access: Read, Write, Edit, Bash, Grep, Glob
19
+ - Implements the solution
20
+ - Reads CLAUDE.md and existing patterns before touching anything
21
+ - Self-reviews before handing off
22
+ - Fixes issues raised by validators
23
+
24
+ ### Validator
25
+ - Read-only access: Read, Grep, Glob, Bash (no Write, no Edit)
26
+ - Verifies correctness, not taste
27
+ - Returns a structured PASS or FAIL with file:line references
28
+ - Never modifies code
29
+
30
+ ### Security Specialist
31
+ - Read-only
32
+ - Focuses: injection, auth flaws, data exposure, misconfiguration, insecure deps
33
+ - Rates findings: Critical / High / Medium / Low
34
+ - References OWASP/CWE
35
+
36
+ ### Performance Specialist
37
+ - Read-only
38
+ - Focuses: algorithm complexity, query efficiency, memory patterns, bundle size, render cost
39
+ - Rates findings: High / Medium / Low with expected improvement estimate
40
+
41
+ ## Workflow
42
+
43
+ ```
44
+ Orchestrator receives task
45
+ -> Builder implements
46
+ -> Validator verifies
47
+ -> If FAIL: Builder fixes, re-validate
48
+ -> If PASS: done
49
+ ```
50
+
51
+ For security-critical work: add Security Specialist between Builder and Validator.
52
+ For performance-critical work: add Performance Specialist in parallel with Security.
53
+
54
+ ## Validation Checklist
55
+
56
+ Every validation pass must cover:
57
+ - [ ] Tests pass
58
+ - [ ] Types check (no TS errors)
59
+ - [ ] Linting clean
60
+ - [ ] No hardcoded secrets or credentials
61
+ - [ ] No SQL/XSS/command injection vectors
62
+ - [ ] Edge cases handled (empty, null, large input)
63
+ - [ ] Error handling appropriate (no silent swallows)
64
+ - [ ] Follows project conventions (CLAUDE.md)
65
+ - [ ] Accessible (semantic HTML, ARIA where needed)
66
+
67
+ ## Output Format
68
+
69
+ Validator returns exactly one of:
70
+
71
+ ```
72
+ PASS — All checks clear. Implementation approved.
73
+
74
+ FAIL — Issues found:
75
+ 1. [Security] SQL injection risk in user input (src/api/users.ts:42)
76
+ 2. [Types] Return type inferred as `any` (src/lib/parser.ts:17)
77
+ ```
78
+
79
+ ## Key Rules
80
+
81
+ 1. Builder never validates its own work.
82
+ 2. Validator never writes code — only reports.
83
+ 3. Specialists focus on their domain only — no scope creep.
84
+ 4. Issue references must include file and line number.
85
+ 5. Iterate until PASS. Track iteration count — high counts signal design problems.
86
+ 6. Give agents only the tools they need. Validators get no write access. Ever.