@c0x12c/ai-toolkit 1.15.0

package/skills/database-table-creator/validation-checklist.md

@@ -0,0 +1,337 @@
+# Database Table Creator - Validation Checklist
+
+Use this checklist to validate every database table implementation. **ALL items must pass before completion.**
+
+---
+
+## SQL Migration Validation
+
+### Required Columns
+- [ ] Has `id UUID PRIMARY KEY DEFAULT gen_random_uuid()`
+- [ ] Has `created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP`
+- [ ] Has `updated_at TIMESTAMP` (nullable, trigger will set it)
+- [ ] Has `deleted_at TIMESTAMP` (nullable, for soft deletes)
+
+### Data Types
+- [ ] ALL string columns use `TEXT` (NOT VARCHAR)
+- [ ] ALL id columns use `UUID` type
+- [ ] ALL timestamp columns use `TIMESTAMP` type
+- [ ] Boolean columns use `BOOLEAN` type
+- [ ] JSON data uses `JSONB` type
+
+### Constraints
+- [ ] NO `FOREIGN KEY` constraints anywhere
+- [ ] NO `REFERENCES` clauses anywhere
+- [ ] NO `ON DELETE CASCADE` anywhere
+- [ ] Primary key constraint exists on id column only
+
+### Indexes
+- [ ] ALL unique indexes include `WHERE deleted_at IS NULL`
+- [ ] ALL indexes on foreign key columns include `WHERE deleted_at IS NULL`
+- [ ] Soft delete index exists: `CREATE INDEX idx_{table}_deleted_at ON {table}(deleted_at) WHERE deleted_at IS NOT NULL`
+- [ ] Index naming follows pattern: `idx_{table}_{column}`
+- [ ] Unique index naming follows pattern: `idx_{table}_{column}_unique`
+
+### Triggers
+- [ ] Update trigger exists for `updated_at` column
+- [ ] Trigger format: `CREATE TRIGGER update_{table}_updated_at BEFORE UPDATE ON {table} FOR EACH ROW EXECUTE FUNCTION update_updated_at()`
+
+### Migration File
+- [ ] File name follows pattern: `{number}-{description}.sql`
+- [ ] Has descriptive header comment
+- [ ] Migration runs successfully without errors
+- [ ] `./gradlew :app:module-repository:flywayMigrate` succeeds
+- [ ] `./gradlew :app:module-repository:flywayInfo` shows "Success"
+
+---
+
+## Kotlin Table Object Validation
+
+### Inheritance
+- [ ] **CRITICAL**: Extends `UUIDTable` (NOT `Table`)
+- [ ] Table name in constructor matches SQL table name exactly
+- [ ] Object name follows pattern: `{TableName}Table` (e.g., `UserTable`)
+
+### Column Definitions
+- [ ] ALL string columns use `text()` (NOT `varchar()`)
+- [ ] UUID columns use `uuid()`
+- [ ] Timestamp columns use `timestamp()`
+- [ ] Boolean columns use `bool()`
+- [ ] Column names match SQL exactly (snake_case)
+
+### Nullability
+- [ ] Nullable columns have `.nullable()` modifier
+- [ ] Non-null columns do NOT have `.nullable()`
+- [ ] `createdAt` is NOT nullable
+- [ ] `updatedAt` IS nullable
+- [ ] `deletedAt` IS nullable
+
+### Standard Columns
+- [ ] Has `createdAt = timestamp("created_at").clientDefault { Instant.now() }`
+- [ ] Has `updatedAt = timestamp("updated_at").nullable()`
+- [ ] Has `deletedAt = timestamp("deleted_at").nullable()`
+
+### File Location
+- [ ] Located in `app/module-repository/src/main/kotlin/com/yourcompany/postgresql/table/`
+- [ ] File name is `{TableName}Table.kt`
+
+---
+
+## Entity Data Class Validation
+
+### Class Definition
+- [ ] Is a `data class`
+- [ ] **CRITICAL**: Implements `Entity<Instant>` interface
+- [ ] Name follows pattern: `{TableName}Entity` (e.g., `UserEntity`)
+
+### Required Overrides
+- [ ] Overrides `id: UUID` with default `= UUID.randomUUID()`
+- [ ] Overrides `createdAt: Instant` with default `= Instant.now()`
+- [ ] Overrides `updatedAt: Instant?` with default `= null`
+- [ ] Overrides `deletedAt: Instant?` with default `= null`
+
+### Property Types
+- [ ] String columns use `String` or `String?` type
+- [ ] UUID columns use `UUID` type
+- [ ] Timestamp columns use `Instant` or `Instant?` type
+- [ ] Boolean columns use `Boolean` type
+- [ ] Enum columns use appropriate enum type
+
+### Nullability
+- [ ] Nullable database columns have `?` in Kotlin
+- [ ] Nullable properties have `= null` default
+- [ ] Required database columns do NOT have `?` in Kotlin
+
+### File Location
+- [ ] Located in `app/module-repository/src/main/kotlin/com/yourcompany/postgresql/entity/`
+- [ ] File name is `{TableName}Entity.kt`
+
+---
+
+## Repository Interface Validation
+
+### Standard Methods
+- [ ] Has `insert(entity): Entity` method
+- [ ] Has `update(id, ...fields): Entity?` method
+- [ ] Has `byId(id): Entity?` method
+- [ ] Has `deleteById(id): Entity?` method (soft delete)
+- [ ] Has `restoreById(id): Entity?` method (restore soft deleted)
+
+### Method Signatures
+- [ ] Return types use entity or null (NOT Optional)
+- [ ] Update method parameters are nullable for partial updates
+- [ ] Custom query methods follow naming pattern: `by{Column}(value)`
+
+### File Location
+- [ ] Located in `app/module-repository/src/main/kotlin/com/yourcompany/postgresql/repository/`
+- [ ] File name is `{TableName}Repository.kt`
+
+---
+
+## Repository Implementation Validation
+
+### Class Definition
+- [ ] Name follows pattern: `Default{TableName}Repository`
+- [ ] Implements repository interface
+- [ ] Constructor accepts `DatabaseContext` parameter
+- [ ] Constructor uses dependency injection (parameter only)
+
+### Transaction Usage
+- [ ] **CRITICAL**: ALL write operations use `transaction(db.primary)`
+- [ ] **CRITICAL**: ALL read operations use `transaction(db.replica)`
+- [ ] Insert uses `db.primary`
+- [ ] Update uses `db.primary`
+- [ ] Delete (soft) uses `db.primary`
+- [ ] All by* query methods use `db.replica`
+
+### Soft Delete Implementation
+- [ ] **CRITICAL**: ALL queries include `.andWhere { deletedAt.isNull() }`
+- [ ] `deleteById` sets `deletedAt = Instant.now()` (does NOT hard delete)
+- [ ] `deleteById` filters `deletedAt.isNull()` to only delete active records
+- [ ] `restoreById` sets `deletedAt = null`
+- [ ] `restoreById` filters `deletedAt.isNotNull()` to only restore deleted records
+
+### Null Safety
+- [ ] **CRITICAL**: NO `!!` operators anywhere in code
+- [ ] Uses `.singleOrNull()` instead of `.single()`
+- [ ] Uses safe calls `?.` for nullable access
+- [ ] Uses `let` blocks for null-safe operations
+- [ ] Returns null when record not found (doesn't throw)
+
+### Helper Methods
+- [ ] Has private `convert(row: ResultRow): Entity` method
+- [ ] `convert` maps ALL columns from ResultRow to Entity
+- [ ] UUID columns access `.value` property: `row[Table.id].value`
+- [ ] Enum columns use safe `valueOf()` with null handling
+
+### Return Values
+- [ ] Insert returns the inserted entity
+- [ ] Update returns updated entity or null
+- [ ] Queries return entity or null (or list)
+- [ ] Delete/restore return affected entity or null
+
+### File Location
+- [ ] Located in `app/module-repository/src/main/kotlin/com/yourcompany/postgresql/repository/`
+- [ ] File name is `Default{TableName}Repository.kt`
+
+---
+
+## Repository Factory Bean Validation
+
+### Bean Definition
+- [ ] Factory class has `@Factory` annotation
+- [ ] Method has `@Singleton` annotation
+- [ ] Method name: `provide{TableName}Repository`
+- [ ] Returns interface type (not implementation)
+- [ ] Accepts `DatabaseContext` parameter
+- [ ] Returns new instance: `Default{TableName}Repository(db)`
+
+### File Location
+- [ ] Added to `app/module-repository/src/main/kotlin/com/yourcompany/runtime/factory/RepositoryFactory.kt`
+
+---
+
+## Repository Test Validation
+
+### Test Class Setup
+- [ ] Extends `AbstractRepositoryTest`
+- [ ] Has `@MicronautTest(environments = ["test"])` annotation
+- [ ] Name follows pattern: `Default{TableName}RepositoryTest`
+- [ ] Injects repository interface using `@Inject`
+
+### Test Coverage (Minimum 7 Tests)
+- [ ] Has `insert - creates entity successfully` test
+- [ ] Has `update - updates selected fields` test
+- [ ] Has `byId - returns entity when exists` test
+- [ ] Has `byId - returns null when not exists` test
+- [ ] **CRITICAL**: Has `byId - returns null when soft deleted` test
+- [ ] Has `deleteById - soft deletes entity` test
+- [ ] Has `restoreById - restores soft deleted entity` test
+
+### Test Implementation
+- [ ] Uses `@BeforeEach` to truncate tables
+- [ ] Has dummy entity helper method with randomized data
+- [ ] Uses AssertJ assertions (`assertk.assertThat`)
+- [ ] Tests verify soft delete behavior (deletedAt timestamp set)
+- [ ] Tests verify soft deleted records not returned in queries
+- [ ] Tests verify restore clears deletedAt timestamp
+
+### Test Execution
+- [ ] ALL tests pass: `./gradlew :app:module-repository:test --tests "Default{TableName}RepositoryTest"`
+- [ ] No compilation errors
+- [ ] No runtime errors
+- [ ] 100% success rate
+
+### File Location
+- [ ] Located in `app/module-repository/src/test/kotlin/com/yourcompany/postgresql/repository/`
+- [ ] File name is `Default{TableName}RepositoryTest.kt`
+
+---
+
+## Compilation & Build Validation
+
+- [ ] `./gradlew clean build -x test` succeeds
+- [ ] `./gradlew :app:module-repository:test` succeeds
+- [ ] `./gradlew ktlintCheck` passes (no style violations)
+- [ ] No `!!` operators detected (would fail pre-commit hook)
+- [ ] No compilation warnings related to new code
+- [ ] Application starts successfully
+
+---
+
+## Common Mistakes Checklist
+
+### SQL Mistakes
+- [ ] ❌ NOT using VARCHAR instead of TEXT
+- [ ] ❌ NOT using foreign key constraints
+- [ ] ❌ NOT forgetting WHERE clause in indexes
+- [ ] ❌ NOT using hard delete instead of soft delete
+- [ ] ❌ NOT forgetting update trigger
+
+### Kotlin Table Mistakes
+- [ ] ❌ NOT extending `Table` instead of `UUIDTable`
+- [ ] ❌ NOT using `varchar()` instead of `text()`
+- [ ] ❌ NOT mismatching column names with SQL
+- [ ] ❌ NOT forgetting `.nullable()` on optional columns
+
+### Entity Mistakes
+- [ ] ❌ NOT forgetting to implement `Entity<Instant>`
+- [ ] ❌ NOT missing override on id/timestamps
+- [ ] ❌ NOT using wrong types (Long instead of UUID, Date instead of Instant)
+
+### Repository Mistakes
+- [ ] ❌ NOT forgetting `deletedAt.isNull()` filter in queries
+- [ ] ❌ NOT using `!!` operator
+- [ ] ❌ NOT hard deleting instead of soft delete
+- [ ] ❌ NOT using wrong transaction type (primary vs replica)
+- [ ] ❌ NOT missing transaction wrapper
+- [ ] ❌ NOT throwing exceptions instead of returning null
+
+### Test Mistakes
+- [ ] ❌ NOT missing soft delete test
+- [ ] ❌ NOT not cleaning database between tests
+- [ ] ❌ NOT using hardcoded test data instead of random
+- [ ] ❌ NOT insufficient assertions
+- [ ] ❌ NOT tests not running or failing
+
+---
+
+## Final Validation Commands
+
+Run these commands in order to verify everything works:
+
+```bash
+# 1. Run migration
+./gradlew :app:module-repository:flywayMigrate
+
+# 2. Check migration status
+./gradlew :app:module-repository:flywayInfo
+
+# 3. Run code style check
+./gradlew ktlintCheck
+
+# 4. Build without tests
+./gradlew clean build -x test
+
+# 5. Run repository tests
+./gradlew :app:module-repository:test --tests "Default{TableName}RepositoryTest"
+
+# 6. Run all tests
+./gradlew test
+```
+
+**All commands must succeed with zero errors.**
+
+---
+
+## Success Criteria
+
+✅ **Implementation is complete when**:
+
+1. All checklist items above are checked ✓
+2. SQL migration runs successfully
+3. All Kotlin files compile without errors
+4. All tests pass (100% success rate)
+5. No `!!` operators in code
+6. All queries filter soft deletes
+7. ktlintCheck passes
+8. Build succeeds
+
+**If ANY item fails, the implementation is NOT complete.**
+
+---
+
+## Quick Reference: Most Critical Validations
+
+These are the most commonly missed items that MUST be verified:
+
+1. ✅ Table extends `UUIDTable` (not `Table`)
+2. ✅ Entity implements `Entity<Instant>`
+3. ✅ ALL queries include `deletedAt.isNull()` filter
+4. ✅ NO `!!` operators anywhere
+5. ✅ SQL uses TEXT (not VARCHAR)
+6. ✅ SQL has NO foreign key constraints
+7. ✅ ALL indexes have WHERE clause
+8. ✅ Soft delete test exists and passes
+
+**These 8 items catch 90% of mistakes. Double-check them carefully.**

package/skills/deep-research/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: deep-research
+description: Run deep research on a topic. Web searches, data collection, source checking, and a structured report. Use when the user needs more than a quick answer.
+allowed_tools:
+  - WebSearch
+  - WebFetch
+  - Read
+---
+
+# Deep Research
+
+Go deep on one topic. Come back with facts, not fluff.
+
+## When to Use
+
+- User needs real data on a topic
+- Writing a research report or blog post
+- Need to understand a new space
+- Preparing materials for investors or partners
+
+## Process
+
+### 1. Scope
+Ask or confirm:
+- What's the question?
+- How deep? (quick scan vs full report)
+- Any angle? (tech, business, user behavior, etc.)
+- Who's the audience? (self, team, investors, public)
+
+### 2. Research
+Run multiple web searches. Look for:
+- Industry reports and data
+- Academic papers or studies
+- News articles (last 12 months)
+- Expert opinions and blog posts
+- Reddit/HN/Twitter discussions
+- Company blogs and case studies
+
+### 3. Verify
+- Cross-check numbers across sources
+- Flag conflicting data
+- Note the source quality (press release vs research paper)
+- Check dates. Flag anything older than 2 years.
+
+### 4. Synthesize
+Don't just list what you found. Connect the dots:
+- What do the facts add up to?
+- What's the pattern?
+- What's missing from the data?
+- What surprised you?
+
+### 5. Write Report
+
+Structure:
+1. **TL;DR** - 3 sentences max
+2. **Background** - Context someone needs to understand
+3. **Key Findings** - The meat. Numbered, sourced.
+4. **Analysis** - What it means. Your take.
+5. **Open Questions** - What we still don't know
+6. **Sources** - Every link, with date and source name
+
+## Rules
+
+- Every claim needs a source
+- Say "I couldn't find data on X" instead of making stuff up
+- Include views that disagree with each other
+- Keep your opinion in the Analysis section, not the Findings
+- If the user asks for quick research, skip steps 3-4
+
+## Gotchas
+
+- **Old data kills credibility.** A 2021 market size report is useless in 2026. Always check the publish date. Flag anything older than 18 months.
+- **Press releases aren't research.** Company announcements are marketing. Cross-check with third-party sources, financial filings, or user data.
+- **Conflicting sources are a feature, not a bug.** When two reports disagree, that's where the interesting analysis lives. Don't just pick one.
+- **"I couldn't find data" is a valid finding.** Don't fill gaps with guesses. If the data doesn't exist, say so -- that's useful info for the user.
+- **Synthesis > summary.** Listing 10 findings isn't research. Connect the dots -- what patterns emerge? What's the "so what?"
+
+## Output
+
+Save to the project's `02-research/` folder.

package/skills/design-intelligence/SKILL.md

@@ -0,0 +1,268 @@
+---
+name: design-intelligence
+description: "Design system bootstrapping and token generation. Takes project context and outputs ready-to-use design tokens, Tailwind config, and CSS variables."
+allowed_tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - WebSearch
+---
+
+# Design Intelligence — Token Generation & Design System Bootstrapping
+
+This skill helps set up design systems from scratch. Give it your project context (industry, brand, users) and it generates ready-to-use design tokens with Tailwind config snippets and CSS variable files.
+
+## When to Use
+
+- Setting up a new project's design system (`/spartan:ux system`)
+- Choosing color palettes for a specific industry/brand
+- Generating typography scales
+- Creating spacing systems
+- Bootstrapping a component inventory
+
+## What This Skill Does
+
+1. Takes project context (what, who, industry, personality)
+2. Generates a complete design token set
+3. Outputs in 3 formats: token reference doc, Tailwind config, CSS variables
+4. Creates a component inventory based on the project type
+
+## How It Works
+
+### Step 1: Gather Context
+
+Ask these questions (skip any the user already answered):
+
+1. **What are you building?** (dashboard, SaaS, marketplace, mobile app, landing page, etc.)
+2. **Who uses it?** (developers, business users, consumers, admins)
+3. **What's the personality?** Pick 2-3:
+   - Clean / Professional / Corporate
+   - Bold / Playful / Creative
+   - Minimal / Technical / Developer-focused
+   - Warm / Friendly / Approachable
+   - Premium / Luxury / Refined
+   - Data-heavy / Dense / Information-rich
+4. **Light, dark, or both?**
+5. **Any brand colors already decided?** (if yes, use those as the foundation)
+6. **Reference apps?** (apps that have the quality you want)
+
+### Step 2: Generate Color Palette
+
+Based on the context, generate a complete palette:
+
+**For dark themes:**
+```
+Background:     #0F172A (slate-900 family)
+Surface:        rgba(30, 41, 59, 0.5) (glass effect)
+Primary:        [based on personality — blue for professional, green for growth, etc.]
+Primary Hover:  [10% darker]
+Accent:         [complementary or analogous — use sparingly, max 10-15%]
+Text:           #F8FAFC (near white)
+Text Secondary: #94A3B8 (slate-400)
+Text Muted:     #64748B (slate-500)
+Border:         rgba(148, 163, 184, 0.1)
+Success:        #22C55E
+Warning:        #F59E0B
+Error:          #EF4444
+```
+
+**For light themes:**
+```
+Background:     #FFFFFF or #F8FAFC
+Surface:        #FFFFFF
+Primary:        [based on personality]
+Primary Hover:  [10% darker]
+Accent:         [complementary]
+Text:           #0F172A (near black)
+Text Secondary: #475569 (slate-600)
+Text Muted:     #64748B (slate-500)
+Border:         #E2E8F0 (slate-200)
+Success:        #16A34A
+Warning:        #D97706
+Error:          #DC2626
+```
+
+**Color selection by personality:**
+
+| Personality | Primary range | Accent range |
+|-------------|--------------|-------------|
+| Professional / Corporate | Blue (#2563EB → #1E40AF) | Slate or Amber |
+| Bold / Creative | Purple (#7C3AED), Pink (#EC4899) | Yellow or Cyan |
+| Minimal / Technical | Gray (#374151), Black (#111827) | One bright accent |
+| Warm / Friendly | Orange (#EA580C), Teal (#0D9488) | Amber or Rose |
+| Premium / Luxury | Deep Blue (#1E3A5F), Gold (#B8860B) | Silver or Champagne |
+| Data-heavy | Neutral blue (#3B82F6) | Green for positive, Red for negative |
+
+### Step 3: Generate Typography Scale
+
+Pick a font pairing based on personality:
+
+| Personality | Font recommendation | Why |
+|-------------|-------------------|-----|
+| Professional | DM Sans, Plus Jakarta Sans | Clean geometric, good for UI |
+| Technical | JetBrains Mono (code) + Inter (UI) | Developer-friendly |
+| Creative | Outfit, Space Grotesk | Distinctive but readable |
+| Warm | Nunito, Quicksand | Rounded, friendly feel |
+| Premium | Playfair Display (headings) + Lato (body) | Elegant contrast |
+| Data-heavy | Inter, Roboto Mono (numbers) | Tabular nums, high readability |
+
+**Type scale (base 16px):**
+```
+h1: 36px / 700 / 1.2 line-height
+h2: 30px / 700 / 1.25
+h3: 24px / 600 / 1.3
+h4: 20px / 600 / 1.35
+h5: 18px / 600 / 1.4
+h6: 16px / 600 / 1.4
+body: 16px / 400 / 1.6
+body-sm: 14px / 400 / 1.5
+caption: 12px / 500 / 1.4
+```
+
+### Step 4: Generate Spacing & Radius
+
+**Spacing scale (8px base):**
+```
+xs:   4px   (0.25rem)
+sm:   8px   (0.5rem)
+md:   16px  (1rem)
+lg:   24px  (1.5rem)
+xl:   32px  (2rem)
+2xl:  48px  (3rem)
+3xl:  64px  (4rem)
+```
+
+**Radius by personality:**
+
+| Personality | Card | Button | Badge | Input |
+|-------------|------|--------|-------|-------|
+| Professional | 8px | 6px | 4px | 6px |
+| Minimal | 0-4px | 4px | 2px | 4px |
+| Friendly | 12-16px | 8px | 9999px | 8px |
+| Premium | 12px | 8px | 6px | 8px |
+
+**Shadow by personality:**
+
+| Personality | Style |
+|-------------|-------|
+| Professional | Subtle: `0 1px 3px rgba(0,0,0,0.1)` |
+| Minimal | None or very subtle borders |
+| Friendly | Soft: `0 4px 12px rgba(0,0,0,0.08)` |
+| Premium | Layered: `0 1px 2px rgba(0,0,0,0.06), 0 4px 12px rgba(0,0,0,0.08)` |
+| Dark theme | Glow: `0 0 20px rgba(primary, 0.15)` |
+
+### Step 5: Output in 3 Formats
+
+#### Format 1: Token Reference Doc (`.planning/design/system/tokens.md`)
+
+Human-readable markdown with all tokens, used by designers and all commands.
+
+#### Format 2: Tailwind Config Snippet
+
+```typescript
+// Paste into tailwind.config.ts → theme.extend
+{
+  colors: {
+    primary: '[value]',
+    'primary-hover': '[value]',
+    accent: '[value]',
+    background: '[value]',
+    surface: '[value]',
+    // ... all color tokens
+  },
+  fontFamily: {
+    sans: ['[font]', 'sans-serif'],
+  },
+  borderRadius: {
+    card: '[value]',
+    button: '[value]',
+  },
+  boxShadow: {
+    card: '[value]',
+  },
+}
+```
+
+#### Format 3: CSS Variables
+
+```css
+:root {
+  /* Colors */
+  --color-primary: [value];
+  --color-primary-hover: [value];
+  --color-accent: [value];
+  --color-bg: [value];
+  --color-surface: [value];
+  --color-text: [value];
+  --color-text-secondary: [value];
+  --color-text-muted: [value];
+  --color-border: [value];
+  --color-success: [value];
+  --color-warning: [value];
+  --color-error: [value];
+
+  /* Typography */
+  --font-family: '[font]', sans-serif;
+  --font-size-h1: 36px;
+  /* ... full scale */
+
+  /* Spacing */
+  --space-xs: 4px;
+  --space-sm: 8px;
+  --space-md: 16px;
+  --space-lg: 24px;
+  --space-xl: 32px;
+
+  /* Radius */
+  --radius-card: [value];
+  --radius-button: [value];
+  --radius-badge: [value];
+
+  /* Shadows */
+  --shadow-sm: [value];
+  --shadow-md: [value];
+  --shadow-lg: [value];
+}
+```
+
+### Step 6: Generate Component Inventory
+
+Based on the project type, list the components needed:
+
+**Dashboard / SaaS:**
+- Sidebar navigation, Top bar, Stat cards, Data tables, Charts, Modals, Forms, Toast notifications, Dropdown menus, Badges, Avatars, Breadcrumbs
+
+**Marketplace / E-commerce:**
+- Product cards, Search bar, Filters, Cart, Checkout form, Reviews, Ratings, Image galleries, Price displays, Category navigation
+
+**Mobile app:**
+- Bottom tab bar, Pull-to-refresh, Swipeable cards, Action sheets, Floating action button, List items, Empty states, Onboarding screens
+
+**Landing page:**
+- Hero section, Feature grid, Testimonials, Pricing table, CTA buttons, Footer, Navigation, Social proof
+
+Save component inventory to `.planning/design/system/components.md`.
+
+---
+
+## Design System Constraint for Code Generation
+
+**When generating UI code and design tokens already exist:**
+
+Read `.planning/design/system/tokens.md` or `.planning/design-config.md` FIRST. Your code MUST use these tokens. Do NOT use Tailwind defaults, generic colors, or made-up spacing.
+
+Think of it like a jazz musician: the chord progression is set (tokens). Your job is to build beautifully within it. Don't change the key.
+
+---
+
+## Checklist Before Delivering
+
+- [ ] All 3 output formats generated (token doc, Tailwind, CSS variables)
+- [ ] Colors have enough contrast (4.5:1 for text)
+- [ ] Typography scale is consistent and readable
+- [ ] Spacing uses the grid (no arbitrary values)
+- [ ] Component inventory matches project type
+- [ ] design-config.md updated (if it existed before)