@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.
- package/LICENSE +228 -0
- package/README.md +714 -0
- package/README.pdf +0 -0
- package/bin/8gent-run.js +47 -0
- package/dist/cli.js +488918 -0
- package/dist/skills/billiondollarboardroom/SKILL.md +180 -0
- package/dist/skills/clone-react/SKILL.md +106 -0
- package/dist/skills/design-excellence/SKILL.md +97 -0
- package/dist/skills/dogfood-qa/SKILL.md +99 -0
- package/dist/skills/motion-design/SKILL.md +104 -0
- package/dist/skills/team-validation/SKILL.md +86 -0
- package/dist/skills/vercel-react/SKILL.md +81 -0
- package/package.json +114 -0
|
@@ -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.
|