aiblueprint-cli 1.4.104 → 1.4.106

package/README.md

@@ -144,22 +144,15 @@ npx skills add Melvynx/aiblueprint --skill skill-manager
 | `appstore-connect` | Manage App Store Connect workflows |
 | `audit-memories` | Manually audit and clean project agent documentation |
 | `audit-skills` | Manually audit skill usage, invocation controls, duplicates, and scope |
-| `commit` | Quick commit and push with clean messages |
-| `create-pr` | Auto-generated pull requests |
 | `fix-pr-comments` | Resolve PR review comments |
 | `grill-me` | Stress-test a plan with focused questions |
 | `hooks-manager` | Create and debug Claude Code hooks |
 | `merge` | Context-aware branch merging |
 | `environments-manager` | Set up per-worktree agent environments |
-| `oneshot` | Implement one focused change quickly |
 | `prompt` | Create minimalist SVG logo variations |
 | `rules-manager` | Create and maintain agent rule files |
 | `skill-manager` | Manage skills and rules across Claude Code, Codex, and Cursor |
-| `tools` | AIBlueprint tools and libraries reference |
 | `use-style` | Apply named UI style guides before implementation |
-| `use-artifacts` | Create polished local HTML plans, prototypes, and visualizations |
-| `use-delegate` | Delegate heavy work to cheap executors |
-| `use-goal` | Create evidence-based agent goals |
 | `ultrathink` | Deep thinking mode for elegant solutions |
 
 ## 🤖 Assistant Pro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiblueprint-cli",
-  "version": "1.4.104",
+  "version": "1.4.106",
   "description": "AIBlueprint CLI for setting up AI coding configurations",
   "author": "AIBlueprint",
   "license": "MIT",

package/agents-config/skills/audit/SKILL.md

@@ -1,126 +0,0 @@
----
-name: audit
-description: Perform comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates detailed report of issues with severity ratings and recommendations.
-user-invocable: true
-argument-hint: "[area]"
-disable-model-invocation: true
----
-
-Run systematic quality checks and generate a comprehensive audit report with prioritized issues and actionable recommendations. Don't fix issues - document them for other commands to address.
-
-**First**: Use the frontend-design skill for design principles and anti-patterns.
-
-## Diagnostic Scan
-
-Run comprehensive checks across multiple dimensions:
-
-1. **Accessibility (A11y)** - Check for:
-   - **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
-   - **Missing ARIA**: Interactive elements without proper roles, labels, or states
-   - **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
-   - **Semantic HTML**: Improper heading hierarchy, missing landmarks, divs instead of buttons
-   - **Alt text**: Missing or poor image descriptions
-   - **Form issues**: Inputs without labels, poor error messaging, missing required indicators
-
-2. **Performance** - Check for:
-   - **Layout thrashing**: Reading/writing layout properties in loops
-   - **Expensive animations**: Animating layout properties (width, height, top, left) instead of transform/opacity
-   - **Missing optimization**: Images without lazy loading, unoptimized assets, missing will-change
-   - **Bundle size**: Unnecessary imports, unused dependencies
-   - **Render performance**: Unnecessary re-renders, missing memoization
-
-3. **Theming** - Check for:
-   - **Hard-coded colors**: Colors not using design tokens
-   - **Broken dark mode**: Missing dark mode variants, poor contrast in dark theme
-   - **Inconsistent tokens**: Using wrong tokens, mixing token types
-   - **Theme switching issues**: Values that don't update on theme change
-
-4. **Responsive Design** - Check for:
-   - **Fixed widths**: Hard-coded widths that break on mobile
-   - **Touch targets**: Interactive elements < 44x44px
-   - **Horizontal scroll**: Content overflow on narrow viewports
-   - **Text scaling**: Layouts that break when text size increases
-   - **Missing breakpoints**: No mobile/tablet variants
-
-5. **Anti-Patterns (CRITICAL)** - Check against ALL the **DON'T** guidelines in the frontend-design skill. Look for AI slop tells (AI color palette, gradient text, glassmorphism, hero metrics, card grids, generic fonts) and general design anti-patterns (gray on color, nested cards, bounce easing, redundant copy).
-
-**CRITICAL**: This is an audit, not a fix. Document issues thoroughly with clear explanations of impact. Use other commands (normalize, optimize, harden, etc.) to fix issues after audit.
-
-## Generate Comprehensive Report
-
-Create a detailed audit report with the following structure:
-
-### Anti-Patterns Verdict
-**Start here.** Pass/fail: Does this look AI-generated? List specific tells from the skill's Anti-Patterns section. Be brutally honest.
-
-### Executive Summary
-- Total issues found (count by severity)
-- Most critical issues (top 3-5)
-- Overall quality score (if applicable)
-- Recommended next steps
-
-### Detailed Findings by Severity
-
-For each issue, document:
-- **Location**: Where the issue occurs (component, file, line)
-- **Severity**: Critical / High / Medium / Low
-- **Category**: Accessibility / Performance / Theming / Responsive
-- **Description**: What the issue is
-- **Impact**: How it affects users
-- **WCAG/Standard**: Which standard it violates (if applicable)
-- **Recommendation**: How to fix it
-- **Suggested command**: Which command to use (prefer: /animate, /quieter, /optimize, /adapt, /clarify, /distill, /delight, /onboard, /normalize, /audit, /harden, /polish, /extract, /bolder, /critique, /colorize — or other installed skills you're sure exist)
-
-#### Critical Issues
-[Issues that block core functionality or violate WCAG A]
-
-#### High-Severity Issues
-[Significant usability/accessibility impact, WCAG AA violations]
-
-#### Medium-Severity Issues
-[Quality issues, WCAG AAA violations, performance concerns]
-
-#### Low-Severity Issues
-[Minor inconsistencies, optimization opportunities]
-
-### Patterns & Systemic Issues
-
-Identify recurring problems:
-- "Hard-coded colors appear in 15+ components, should use design tokens"
-- "Touch targets consistently too small (<44px) throughout mobile experience"
-- "Missing focus indicators on all custom interactive components"
-
-### Positive Findings
-
-Note what's working well:
-- Good practices to maintain
-- Exemplary implementations to replicate elsewhere
-
-### Recommendations by Priority
-
-Create actionable plan:
-1. **Immediate**: Critical blockers to fix first
-2. **Short-term**: High-severity issues (this sprint)
-3. **Medium-term**: Quality improvements (next sprint)
-4. **Long-term**: Nice-to-haves and optimizations
-
-### Suggested Commands for Fixes
-
-Map issues to available commands. Prefer these: /animate, /quieter, /optimize, /adapt, /clarify, /distill, /delight, /onboard, /normalize, /audit, /harden, /polish, /extract, /bolder, /critique, /colorize. You may also suggest other installed skills you're sure exist, but never invent commands.
-
-Examples:
-- "Use `/normalize` to align with design system (addresses N theming issues)"
-- "Use `/optimize` to improve performance (addresses N performance issues)"
-- "Use `/harden` to improve resilience (addresses N edge cases)"
-
-**IMPORTANT**: Be thorough but actionable. Too many low-priority issues creates noise. Focus on what actually matters.
-
-**NEVER**:
-- Report issues without explaining impact (why does this matter?)
-- Mix severity levels inconsistently
-- Skip positive findings (celebrate what works)
-- Provide generic recommendations (be specific and actionable)
-- Forget to prioritize (everything can't be critical)
-- Report false positives without verification
-
-Remember: You're a quality auditor with exceptional attention to detail. Document systematically, prioritize ruthlessly, and provide clear paths to improvement. A good audit makes fixing easy.

package/agents-config/skills/audit/agents/openai.yaml

@@ -1,10 +0,0 @@
-interface:
-  display_name: "Audit"
-  short_description: "Perform comprehensive audit of interface quality across..."
-  icon_small: "./assets/codex-icon.svg"
-  icon_large: "./assets/codex-icon.svg"
-  brand_color: "#615AA8"
-  default_prompt: "Use $audit to help with this task."
-
-policy:
-  allow_implicit_invocation: false

package/agents-config/skills/audit/assets/codex-icon.svg

@@ -1,20 +0,0 @@
-<!-- @license lucide-static v1.24.0 - ISC -->
-<svg role="img" aria-label="audit skill icon"
-  class="lucide lucide-scan-search"
-  xmlns="http://www.w3.org/2000/svg"
-  width="128"
-  height="128"
-  viewBox="0 0 24 24"
-  fill="none"
-  stroke="#F5F5F5"
-  stroke-width="2"
-  stroke-linecap="round"
-  stroke-linejoin="round"
->
-  <path d="M3 7V5a2 2 0 0 1 2-2h2" />
-  <path d="M17 3h2a2 2 0 0 1 2 2v2" />
-  <path d="M21 17v2a2 2 0 0 1-2 2h-2" />
-  <path d="M7 21H5a2 2 0 0 1-2-2v-2" />
-  <circle cx="12" cy="12" r="3" />
-  <path d="m16 16-1.9-1.9" />
-</svg>

package/agents-config/skills/commit/SKILL.md

@@ -1,44 +0,0 @@
----
-name: commit
-description: Quick commit and push with minimal, clean messages
-model: haiku
-allowed-tools: Bash(git :*), Bash(npm :*), Bash(pnpm :*)
-disable-model-invocation: true
-allow_implicit_invocation: false
----
-
-# Commit
-
-Quick commit with conventional message format, then push.
-
-## Context
-
-- Git state: !`git status`
-- Staged changes: !`git diff --cached --stat`
-- Unstaged changes: !`git diff --stat`
-- Recent commits: !`git log --oneline -5`
-- Current branch: !`git branch --show-current`
-
-## Workflow
-
-1. **Analyze**: Review git status
-   - Nothing staged but unstaged changes exist: `git add .`
-   - Nothing to commit: inform user and exit
-
-2. **Generate commit message**:
-   - Format: `type(scope): brief description`
-   - Types: `feat`, `fix`, `update`, `docs`, `chore`, `refactor`, `test`, `perf`, `revert`
-   - Under 72 chars, imperative mood, lowercase after colon
-   - Example: `update(statusline): refresh spend data`
-
-3. **Commit**: `git commit -m "message"`
-
-4. **Push**: `git push`
-
-## Rules
-
-- SPEED OVER PERFECTION: Generate one good message and commit
-- NO INTERACTION: Never ask questions - analyze and commit
-- AUTO-STAGE: If nothing staged, stage everything
-- AUTO-PUSH: Always push after committing
-- IMPERATIVE MOOD: "add", "update", "fix" not past tense

package/agents-config/skills/commit/agents/openai.yaml

@@ -1,10 +0,0 @@
-interface:
-  display_name: "Commit"
-  short_description: "Quick commit and push with minimal, clean messages"
-  icon_small: "./assets/codex-icon.svg"
-  icon_large: "./assets/codex-icon.svg"
-  brand_color: "#4BD0FC"
-  default_prompt: "Use $commit to help with this task."
-
-policy:
-  allow_implicit_invocation: false

package/agents-config/skills/commit/assets/codex-icon.svg

@@ -1,17 +0,0 @@
-<!-- @license lucide-static v1.24.0 - ISC -->
-<svg role="img" aria-label="commit skill icon"
-  class="lucide lucide-git-commit-horizontal"
-  xmlns="http://www.w3.org/2000/svg"
-  width="128"
-  height="128"
-  viewBox="0 0 24 24"
-  fill="none"
-  stroke="#F5F5F5"
-  stroke-width="2"
-  stroke-linecap="round"
-  stroke-linejoin="round"
->
-  <circle cx="12" cy="12" r="3" />
-  <line x1="3" x2="9" y1="12" y2="12" />
-  <line x1="15" x2="21" y1="12" y2="12" />
-</svg>

package/agents-config/skills/create-pr/SKILL.md

@@ -1,55 +0,0 @@
----
-name: create-pr
-description: Create and push PR with auto-generated title and description
-model: haiku
-allowed-tools: Bash(git :*), Bash(gh :*)
-disable-model-invocation: true
-allow_implicit_invocation: false
----
-
-# Create PR
-
-Create pull request with concise, meaningful description.
-
-## Context
-
-- Current branch: !`git branch --show-current`
-- Working tree status: !`git status --short`
-- Recent commits: !`git log --oneline -5`
-- Remote tracking: !`git rev-parse --abbrev-ref @{upstream} 2>/dev/null || echo "none"`
-
-## Workflow
-
-1. **Verify**: Check `git status` and current branch
-2. **Branch Safety**: **CRITICAL** - If on main/master, create descriptive branch from changes
-3. **Push**: `git push -u origin HEAD`
-4. **Analyze**: `git diff origin/main...HEAD --stat`
-5. **Generate PR**:
-   - Title: One-line summary (max 72 chars)
-   - Body: Bullet points of key changes
-6. **Submit**: `gh pr create --title "..." --body "..."`
-7. **Return**: Display PR URL
-
-## PR Format
-
-```markdown
-## Summary
-
-• [Main change or feature]
-• [Secondary changes]
-• [Any fixes included]
-
-## Type
-
-[feat/fix/refactor/docs/chore]
-```
-
-## Rules
-
-- NO verbose descriptions
-- NO "Generated with" signatures
-- Auto-detect base branch (main/master/develop)
-- Use HEREDOC for multi-line body
-- If PR exists, return existing URL
-
-User: $ARGUMENTS

package/agents-config/skills/create-pr/agents/openai.yaml

@@ -1,10 +0,0 @@
-interface:
-  display_name: "Create Pr"
-  short_description: "Create and push PR with auto-generated title and description"
-  icon_small: "./assets/codex-icon.svg"
-  icon_large: "./assets/codex-icon.svg"
-  brand_color: "#951556"
-  default_prompt: "Use $create-pr to help with this task."
-
-policy:
-  allow_implicit_invocation: false

package/agents-config/skills/create-pr/assets/codex-icon.svg

@@ -1,17 +0,0 @@
-<!-- @license lucide-static v1.24.0 - ISC -->
-<svg role="img" aria-label="create-pr skill icon"
-  class="lucide lucide-git-merge"
-  xmlns="http://www.w3.org/2000/svg"
-  width="128"
-  height="128"
-  viewBox="0 0 24 24"
-  fill="none"
-  stroke="#F5F5F5"
-  stroke-width="2"
-  stroke-linecap="round"
-  stroke-linejoin="round"
->
-  <circle cx="18" cy="18" r="3" />
-  <circle cx="6" cy="6" r="3" />
-  <path d="M6 21V9a9 9 0 0 0 9 9" />
-</svg>

package/agents-config/skills/oneshot/SKILL.md

@@ -1,44 +0,0 @@
----
-name: oneshot
-description: Implement one focused code change quickly with minimal exploration and targeted validation. Use for small bug fixes, single feature edits, config updates, or explicit "$oneshot" requests.
-disable-model-invocation: true
-metadata:
-  opencode/autoinvoke: "false"
-  opencode/slash: "true"
-argument-hint: <feature-description>
----
-
-# OneShot
-
-Use this for one narrow implementation task. Optimize for the shortest reliable path to a working, verified change.
-
-## Workflow
-
-### 1. Scope
-
-- Identify the exact target and likely files with `rg` / `rg --files`.
-- Read only the files needed to edit safely, usually 2-5 plus nearby examples.
-- Look up docs only when API, version, or current behavior may be stale.
-
-### 2. Implement
-
-- Edit as soon as the existing pattern is clear.
-- Keep the diff minimal and local to the request.
-- Do not refactor, rename, redesign, rewrite docs, or clean adjacent code unless required.
-- Prefer existing helpers, conventions, and package scripts.
-
-### 3. Validate
-
-- Run the smallest meaningful checks: targeted tests, touched-package lint/typecheck, and formatter when expected.
-- If a check fails, fix only failures caused by this change and rerun.
-- Run broader checks only for shared/high-risk code or when the user asks.
-
-## Stop Rules
-
-- Do not expand into adjacent improvements.
-- Ask only when a missing decision blocks safe implementation.
-- If blocked after two concrete attempts, report the blocker, evidence, and the next exact option.
-
-## Final Response
-
-Report changed files, validation commands/results, and any skipped checks with reason.

package/agents-config/skills/oneshot/agents/openai.yaml

@@ -1,10 +0,0 @@
-interface:
-  display_name: "Oneshot"
-  short_description: "Implement one focused code change quickly with minimal..."
-  icon_small: "./assets/codex-icon.svg"
-  icon_large: "./assets/codex-icon.svg"
-  brand_color: "#CF80EF"
-  default_prompt: "Use $oneshot to help with this task."
-
-policy:
-  allow_implicit_invocation: false

package/agents-config/skills/oneshot/assets/codex-icon.svg

@@ -1,18 +0,0 @@
-<!-- @license lucide-static v1.24.0 - ISC -->
-<svg role="img" aria-label="oneshot skill icon"
-  class="lucide lucide-sparkles"
-  xmlns="http://www.w3.org/2000/svg"
-  width="128"
-  height="128"
-  viewBox="0 0 24 24"
-  fill="none"
-  stroke="#F5F5F5"
-  stroke-width="2"
-  stroke-linecap="round"
-  stroke-linejoin="round"
->
-  <path d="M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z" />
-  <path d="M20 2v4" />
-  <path d="M22 4h-4" />
-  <circle cx="4" cy="20" r="2" />
-</svg>

package/agents-config/skills/tools/SKILL.md

@@ -1,149 +0,0 @@
----
-name: tools
-description: Reference document listing all recommended tools and libraries for AIBlueprint development
----
-
-# AIBlueprint Tools & Libraries Reference
-
-This document lists all recommended tools and libraries for development with the AIBlueprint stack. Use this as a reference when making architecture decisions.
-
-## Quick Reference Table
-
-| Name | Description | Tags |
-|------|-------------|------|
-| [Next.js](https://nextjs.org/) | Main React framework with App Router | `framework`, `frontend`, `backend` |
-| [TanStack Query](https://tanstack.com/query) | Data fetching & caching for API routes | `frontend`, `library` |
-| [Zustand](https://zustand.docs.pmnd.rs/) | Client-side state management | `frontend`, `library` |
-| [nuqs](https://nuqs.47ng.com/) | URL state management | `frontend`, `library` |
-| [shadcn/ui](https://ui.shadcn.com/) | Customizable React components | `frontend`, `library` |
-| [Convex](https://www.convex.dev/) | Realtime database & backend | `backend`, `database`, `realtime` |
-| [Liveblocks](https://liveblocks.io/) | Multiplayer collaboration features | `frontend`, `backend`, `realtime` |
-| [Neon](https://neon.tech/) | Serverless PostgreSQL | `backend`, `database`, `sql` |
-| [Supabase](https://supabase.com/) | PostgreSQL + Backend as a Service | `backend`, `database`, `sql` |
-| [Prisma](https://prisma.io/) | Type-safe ORM (recommended for teams) | `backend`, `database`, `orm` |
-| [Drizzle ORM](https://orm.drizzle.team/) | Lightweight type-safe ORM | `backend`, `database`, `orm` |
-| [Better Auth](https://www.better-auth.com/) | Complete authentication solution | `backend`, `library` |
-| [Inngest](https://www.inngest.com/) | Background jobs & workflows | `backend`, `service` |
-| [Next Safe Action](https://next-safe-action.dev/) | Secure Server Actions | `backend`, `library` |
-| [next-zod-route](https://github.com/Melvynx/next-zod-route) | Secure API Routes | `backend`, `library` |
-| [Zod](https://zod.dev/) | Runtime validation (v4) | `library`, `validation` |
-| [AI SDK](https://ai-sdk.dev/) | LLM integration wrapper | `backend`, `frontend`, `library` |
-| [up-fetch](https://github.com/L-Blondy/up-fetch) | Modern fetch wrapper | `backend`, `frontend`, `library` |
-| [Vitest](https://vitest.dev/) | Fast unit testing | `testing`, `library` |
-| [Playwright](https://playwright.dev/) | E2E testing | `testing`, `library` |
-| [Sentry](https://sentry.io/) | Error tracking & monitoring | `monitoring`, `service` |
-| [Resend](https://resend.com/) | Developer email service | `email`, `service` |
-| [React Email](https://react.email/) | Email templates in React | `email`, `library` |
-| [AWS SES](https://aws.amazon.com/ses/) | High-volume email | `email`, `service` |
-| [Stripe](https://stripe.com/) | Complete payment solution | `payment`, `service` |
-| [Lemon Squeezy](https://lemonsqueezy.com/) | Payments with tax handling | `payment`, `service` |
-| [PostHog](https://posthog.com/) | Product analytics | `analytics`, `service` |
-| [Plausible](https://plausible.io/) | Simple web analytics | `analytics`, `service` |
-| [React Hook Form](https://react-hook-form.com/) | Form management (recommended) | `frontend`, `library`, `forms` |
-| [TanStack Form](https://tanstack.com/form) | Headless form management | `frontend`, `library`, `forms` |
-| [Uploadthing](https://uploadthing.com/) | Simple file uploads | `upload`, `images`, `service` |
-| [Cloudflare R2](https://developers.cloudflare.com/r2/) | S3-compatible storage | `backend`, `images`, `storage` |
-| [AWS S3](https://aws.amazon.com/s3/) | Object storage standard | `storage`, `images`, `infra` |
-
-## Categories
-
-### Framework & Frontend
-- **Next.js** - Main framework
-- **TanStack Query** - Data fetching & cache
-- **Zustand** - Client state management
-- **nuqs** - URL state
-- **shadcn/ui** - UI components
-
-### Backend & API
-- **Next Safe Action** - Secure Server Actions
-- **next-zod-route** - Secure API Routes
-- **Better Auth** - Authentication
-- **AI SDK** - LLM integration
-- **up-fetch** - HTTP client
-
-### Database & ORM
-- **Neon** - Serverless PostgreSQL (recommended)
-- **Supabase** - PostgreSQL + BaaS
-- **Prisma** - Type-safe ORM (recommended for teams)
-- **Drizzle ORM** - Lightweight ORM (recommended for performance)
-
-### Realtime & Collaboration
-- **Convex** - Realtime database + backend (recommended for realtime apps)
-- **Liveblocks** - Multiplayer collaboration (cursors, presence, comments)
-
-### Validation & Forms
-- **Zod** - Data validation (v4)
-- **React Hook Form** - Form management (recommended)
-- **TanStack Form** - Modern alternative
-
-### Testing
-- **Vitest** - Unit tests
-- **Playwright** - E2E tests
-
-### Monitoring & Analytics
-- **Sentry** - Error tracking & performance
-- **PostHog** - Product analytics (recommended)
-- **Plausible** - Simple web analytics
-
-### Payments
-- **Stripe** - Complete solution (recommended for flexibility)
-- **Lemon Squeezy** - Simple + handles taxes (recommended for solopreneurs)
-
-### Email
-- **Resend** - Transactional emails (recommended)
-- **React Email** - Email templates in React
-- **AWS SES** - High volume
-
-### Images & Upload
-- **Uploadthing** - Simple Next.js uploads (recommended)
-- **Cloudflare R2** - Cheap object storage
-- **AWS S3** - Standard object storage
-
-### Services & Infrastructure
-- **Inngest** - Async jobs & workflows
-- **Cloudflare Browser Rendering** - Serverless scraping
-
-## Recommended Stack
-
-### Frontend
-- Next.js + TanStack Query + Zustand + shadcn/ui
-- React Hook Form + Zod
-
-### Backend
-- Neon (DB) + Prisma or Drizzle (ORM)
-- Next Safe Action + Better Auth
-- Resend + React Email
-
-### Services
-- Stripe (payments)
-- Uploadthing (upload)
-- Cloudflare R2 (storage)
-- PostHog (analytics)
-- Sentry (monitoring)
-
-### Testing
-- Vitest + Playwright
-
-## Decision Guide
-
-| Decision | Recommendation |
-|----------|----------------|
-| Database | Neon + Prisma to start, Drizzle for performance |
-| Realtime | Convex for full realtime, Liveblocks for collaboration only |
-| Email | Resend to start, AWS SES for >100k/month |
-| Payments | Stripe for flexibility, Lemon Squeezy for tax simplicity |
-| Analytics | PostHog for product analytics, Plausible for simple web analytics |
-| Forms | React Hook Form (standard), TanStack Form (more control) |
-| ORM | Prisma (better DX), Drizzle (better perf, 2-3x faster) |
-| Upload | Uploadthing (simple), R2/S3 (more control) |
-| Testing | Vitest (unit), Playwright (E2E, more reliable than Cypress) |
-
-## Important Notes
-
-- **Zod**: Now v4, specify version to AI
-- **Supabase Auth**: Prefer Better-Auth for flexibility
-- **Convex vs Neon+Liveblocks**: Convex if entire app is realtime, Neon+Liveblocks if only some features need collaboration
-- **AWS S3**: Watch egress costs, prefer R2 for serving assets
-- **Stripe Tax**: Enable for automatic tax handling
-- **Sentry**: Configure source maps for real stack traces
-- **Prisma vs Drizzle**: Prisma = better DX, Drizzle = better perf