start-vibing 1.1.2 → 1.1.3

package/template/.claude/skills/quality-gate/SKILL.md

@@ -1,278 +1,71 @@
----
-name: quality-gate
-description: Automates quality checks (typecheck, lint, tests, build) and blocks commits that don't pass. Use before any commit to validate code quality.
-allowed-tools: Bash, Read, Grep
----
-
-# Quality Gate - Quality Verification System
-
-## Purpose
-
-This skill automates quality checks:
-
-- **Typecheck** - TypeScript errors
-- **Lint** - Code patterns (ESLint)
-- **Build** - Build verification
-- **Tests** - Unit and E2E tests
-- **Blocks** commits that don't pass
-
----
-
-## Commands
-
-### 1. TypeScript Check
-
-```bash
-bun run typecheck
-# or
-bunx tsc --noEmit
-```
-
-### 2. ESLint Check
-
-```bash
-bun run lint
-# or
-bunx eslint . --ext .ts,.tsx
-```
-
-### 3. Build Check
-
-```bash
-bun run build
-```
-
-### 4. Unit Tests
-
-```bash
-bun run test
-# or
-bunx vitest run
-```
-
-### 5. E2E Tests
-
-```bash
-bun run test:e2e
-# or
-bunx playwright test
-```
-
-### 6. All Checks (RECOMMENDED)
-
-```bash
-bun run typecheck && bun run lint && bun run test && bun run test:e2e && bun run build
-```
-
----
-
-## Execution Flow
-
-```
-1. TYPECHECK → If fail: STOP and list errors
-        ↓
-2. LINT → If fail: STOP and list errors
-        ↓
-3. UNIT TESTS → If fail: STOP and list failures
-        ↓
-4. E2E TESTS → If fail: STOP and list failures
-        ↓
-5. BUILD → If fail: STOP and list errors
-        ↓
-RESULT: ✅ APPROVED or ❌ REJECTED
-```
-
----
-
-## Common TypeScript Errors
-
-### Type 'X' is not assignable to type 'Y'
-
-```typescript
-// ERROR
-const value: string = 123;
-
-// FIX
-const value: number = 123;
-```
-
-### Object is possibly 'undefined'
-
-```typescript
-// ERROR
-const name = user.name.toUpperCase();
-
-// FIX
-const name = user?.name?.toUpperCase() ?? '';
-```
-
-### Property 'X' does not exist on type 'Y'
-
-```typescript
-// ERROR
-const age = user.age; // age doesn't exist
-
-// FIX
-interface User {
-	name: string;
-	age?: number;
-}
-```
-
----
-
-## Common ESLint Errors
-
-### @typescript-eslint/no-explicit-any
-
-```typescript
-// ERROR
-function parse(data: any) {}
-
-// FIX
-function parse(data: unknown) {}
-```
-
-### @typescript-eslint/no-unused-vars
-
-```typescript
-// ERROR
-const unused = 'value';
-
-// FIX - remove or prefix with _
-const _unused = 'value';
-```
-
-### react-hooks/exhaustive-deps
-
-```typescript
-// ERROR
-useEffect(() => {
-	fetchData(userId);
-}, []); // missing userId
-
-// FIX
-useEffect(() => {
-	fetchData(userId);
-}, [userId]);
-```
-
----
-
-## Output Format
-
-### Approved
-
-```markdown
-## QUALITY GATE - APPROVED
-
-### Checks Executed
-
-| Check      | Status        | Time  |
-| ---------- | ------------- | ----- |
-| TypeScript | ✅ Pass       | 3.2s  |
-| ESLint     | ✅ Pass       | 5.1s  |
-| Unit Tests | ✅ 42/42 Pass | 8.3s  |
-| E2E Tests  | ✅ 15/15 Pass | 45.2s |
-| Build      | ✅ Pass       | 32.1s |
-
-**STATUS: APPROVED** - Ready to commit
-```
-
-### Rejected
-
-```markdown
-## QUALITY GATE - REJECTED
-
-### Checks Executed
-
-| Check      | Status      |
-| ---------- | ----------- |
-| TypeScript | ❌ 3 errors |
-
-### TypeScript Errors
-
-#### Error 1: server/routers/example.ts:45
-```
-
-Type 'string | undefined' is not assignable to type 'string'.
-
-````
-
-**Suggested fix:**
-```typescript
-const name: string = input.name ?? "";
-````
-
-**STATUS: REJECTED** - Fix 3 errors before commit
-
-````
-
----
-
-## Quick Checks
-
-### Fast Check (typecheck + lint only)
-```bash
-bun run typecheck && bun run lint
-````
-
-### Full Check (everything)
-
-```bash
-bun run typecheck && bun run lint && bun run test && bun run test:e2e && bun run build
-```
-
-### Modified Files Only
-
-```bash
-git diff --name-only | grep -E "\.(ts|tsx)$" | xargs bunx eslint
-```
-
----
-
-## Pre-Commit Checklist
-
-- [ ] `bun run typecheck` passes?
-- [ ] `bun run lint` passes?
-- [ ] `bun run test` passes?
-- [ ] `bun run test:e2e` passes?
-- [ ] `bun run build` passes?
-- [ ] No `any` in code?
-- [ ] No unused variables?
-- [ ] No debug console.log?
-
----
-
-## Scripts (package.json)
-
-```json
-{
-	"scripts": {
-		"typecheck": "tsc --noEmit",
-		"lint": "eslint . --ext .ts,.tsx",
-		"lint:fix": "eslint . --ext .ts,.tsx --fix",
-		"test": "vitest run",
-		"test:watch": "vitest",
-		"test:e2e": "playwright test",
-		"test:e2e:ui": "playwright test --ui",
-		"test:all": "bun run typecheck && bun run lint && bun run test && bun run test:e2e",
-		"build": "next build"
-	}
-}
-```
-
----
-
-## Critical Rules
-
-1. **NEVER commit with errors** - All checks must pass
-2. **RUN IN ORDER** - typecheck → lint → test → e2e → build
-3. **FIX IMMEDIATELY** - Errors cannot accumulate
-4. **DON'T USE --force** - Solve problems, don't ignore
-
----
-
-## Version
-
-- **v2.0.0** - Generic template
+---
+name: quality-gate
+description: Runs code quality checks (typecheck, lint, tests, build). Activates when user says 'check quality', 'run tests', 'typecheck', 'lint', 'build', or before any commit to validate code passes all gates.
+allowed-tools: Bash, Read, Grep
+---
+
+# Quality Gate
+
+## When to Use
+
+- Before committing changes
+- After implementation
+- When user asks to "check", "validate", or "run tests"
+
+## Commands (Run in Order)
+
+```bash
+# 1. TypeScript
+bun run typecheck
+
+# 2. ESLint
+bun run lint
+
+# 3. Unit Tests
+bun run test
+
+# 4. E2E Tests
+bun run test:e2e
+
+# 5. Build
+bun run build
+```
+
+### All at Once
+
+```bash
+bun run typecheck && bun run lint && bun run test && bun run test:e2e && bun run build
+```
+
+## Execution Flow
+
+```
+TYPECHECK → LINT → TESTS → E2E → BUILD
+     ↓ fail    ↓ fail   ↓ fail  ↓ fail  ↓ fail
+   STOP      STOP      STOP    STOP    STOP
+```
+
+## Common Fixes
+
+### TypeScript: Object possibly undefined
+```typescript
+// Fix: use optional chaining
+const name = user?.name ?? '';
+```
+
+### ESLint: no-explicit-any
+```typescript
+// Fix: use unknown
+function parse(data: unknown) {}
+```
+
+## Output
+
+**APPROVED:** All checks pass → ready to commit
+**REJECTED:** Fix errors before proceeding
+
+## Rules
+
+1. **Never commit with errors**
+2. **Run in order** - stop at first failure
+3. **Don't use --force** - solve problems properly

package/template/.claude/skills/research-cache/SKILL.md

@@ -1,207 +1,73 @@
----
-name: research-cache
-description: Caches research findings to avoid redundant web searches. Stores best practices by topic with sources and dates. Use before researching to check existing knowledge.
-allowed-tools: Read, Write, Glob, Grep
----
-
-# Research Cache - Best Practices Storage
-
-## Purpose
-
-This skill caches research findings to avoid redundant web searches and maintain institutional knowledge about best practices.
-
----
-
-## Structure
-
-```
-.claude/skills/research-cache/
-├── SKILL.md          # This file
-├── TEMPLATE.md       # Template for research findings
-└── cache/            # Cached research by topic
-    ├── react-server-components.md
-    ├── typescript-strict.md
-    └── [topic].md
-```
-
----
-
-## How It Works
-
-### Before Research
-
-1. **Check cache first** - Look for existing research on the topic
-2. **Verify freshness** - Research older than 6 months may need updating
-3. **Reuse findings** - If recent research exists, use it directly
-
-### After Research
-
-1. **Create cache file** - Document findings in `cache/[topic].md`
-2. **Follow template** - Use consistent structure
-3. **Include sources** - Always cite URLs and dates
-4. **Tag relevance** - Mark which parts of stack it applies to
-
----
-
-## Cache File Template
-
-```markdown
-# Research: [Topic Name]
-
-## Metadata
-- **Date:** YYYY-MM-DD
-- **Researcher:** [agent/session]
-- **Freshness:** [fresh|stale|outdated]
-- **Stack:** [bun|typescript|mongodb|react|all]
-
-## Problem Statement
-[What problem were we trying to solve?]
-
-## Search Queries
-1. "[query 1]"
-2. "[query 2]"
-3. "[query 3]"
-
-## Key Findings
-
-### Finding 1: [Title]
-**Source:** [URL]
-**Date:** [publication date]
-**Relevance:** [high|medium|low]
-
-[Summary of finding]
-
-**Code Example:**
-```[language]
-[code]
-```
-
-**Applies When:**
-- [condition 1]
-- [condition 2]
-
-### Finding 2: [Title]
-...
-
-## Recommendations
-
-### DO
-1. [Best practice 1]
-2. [Best practice 2]
-
-### AVOID
-1. [Anti-pattern 1]
-2. [Anti-pattern 2]
-
-### CONSIDER
-1. [Alternative approach 1]
-2. [Alternative approach 2]
-
-## Implementation Notes
-
-### For This Project
-- [Specific note for your project]
-- [Integration point]
-
-### Gotchas
-- [Warning 1]
-- [Warning 2]
-
-## Sources
-
-| Title | URL | Date | Relevance |
-|-------|-----|------|-----------|
-| [Source 1] | [url] | [date] | [high/med/low] |
-| [Source 2] | [url] | [date] | [high/med/low] |
-
-## Related Topics
-- [[related-topic-1]]
-- [[related-topic-2]]
-```
-
----
-
-## Usage Patterns
-
-### Quick Lookup
-
-```bash
-# Check if research exists
-ls .claude/skills/research-cache/cache/
-
-# Read specific research
-cat .claude/skills/research-cache/cache/[topic].md
-```
-
-### Search Cached Research
-
-```bash
-# Find all research mentioning a term
-grep -r "websocket" .claude/skills/research-cache/cache/
-```
-
-### Check Freshness
-
-```bash
-# Find research older than 6 months
-find .claude/skills/research-cache/cache/ -mtime +180
-```
-
----
-
-## Integration with Research Agent
-
-The **research agent** uses this skill to:
-
-1. **Check existing research** before web searching
-2. **Store new findings** after web research
-3. **Update stale research** when patterns change
-4. **Cross-reference** findings across topics
-
----
-
-## Freshness Guidelines
-
-| Age | Status | Action |
-|-----|--------|--------|
-| < 3 months | Fresh | Use directly |
-| 3-6 months | Aging | Verify still valid |
-| 6-12 months | Stale | Update recommended |
-| > 12 months | Outdated | Full re-research needed |
-
----
-
-## Topic Naming Convention
-
-Use kebab-case descriptive names:
-
-```
-react-server-components.md # Technology + feature
-typescript-strict-mode.md  # Language + specific setting
-mongodb-indexes.md         # Database + concept
-bun-docker-deploy.md       # Runtime + deployment context
-error-handling-patterns.md # Generic pattern
-```
-
----
-
-## Rules
-
-### MANDATORY
-
-1. **Always check cache first** - Don't duplicate research
-2. **Always include sources** - No unsourced recommendations
-3. **Always date entries** - Freshness matters
-4. **Always follow template** - Consistency helps retrieval
-
-### FORBIDDEN
-
-1. **Cache without sources** - All findings need citations
-2. **Ignore freshness** - Old research may be wrong
-3. **Duplicate topics** - One file per topic, update existing
-
----
-
-## Version
-
-- **v1.0.0** - Initial implementation
+---
+name: research-cache
+description: Stores and retrieves research findings about best practices. Activates before web searching to check existing knowledge, or after researching to cache new findings. Use when user asks about patterns, best practices, or how to implement something.
+allowed-tools: Read, Write, Glob, Grep
+---
+
+# Research Cache
+
+## When to Use
+
+- Before web searching: check if research exists
+- After web searching: cache findings
+- When implementing: apply cached patterns
+
+## Structure
+
+```
+.claude/skills/research-cache/cache/
+└── [topic-name].md
+```
+
+## Workflow
+
+### Check Cache First
+
+```bash
+ls .claude/skills/research-cache/cache/
+grep -r "keyword" .claude/skills/research-cache/cache/
+```
+
+### After Research
+
+Create `cache/[topic].md`:
+
+```markdown
+# Research: [Topic]
+
+## Metadata
+- **Date:** YYYY-MM-DD
+- **Freshness:** fresh|stale|outdated
+
+## Key Findings
+
+### Finding 1
+**Source:** [URL]
+[Summary and code example]
+
+## Recommendations
+
+### DO
+- [Best practice]
+
+### AVOID
+- [Anti-pattern]
+
+## Sources
+| Title | URL | Date |
+|-------|-----|------|
+```
+
+## Freshness Guidelines
+
+| Age | Status | Action |
+|-----|--------|--------|
+| < 3 months | Fresh | Use directly |
+| 3-6 months | Stale | Verify still valid |
+| > 6 months | Outdated | Re-research |
+
+## Rules
+
+1. **Check cache first** - don't duplicate research
+2. **Include sources** - all findings need citations
+3. **Date entries** - freshness matters