@codihaus/claude-skills 1.6.6 → 1.6.8

package/skills/dev-scout/references/stack-patterns.md

@@ -1,371 +0,0 @@
-# Stack Patterns Detection
-
-Detect HOW the project works, not just what frameworks are used.
-
-## BaaS / Headless CMS
-
-Projects using Backend-as-a-Service or Headless CMS have different patterns than custom backends.
-
-### Detection
-
-| Evidence | Service | SDK |
-|----------|---------|-----|
-| `DIRECTUS_URL` in .env | Directus | `@directus/sdk` |
-| `STRAPI_URL` in .env | Strapi | `@strapi/strapi` |
-| `SANITY_PROJECT_ID` in .env | Sanity | `@sanity/client` |
-| `CONTENTFUL_SPACE_ID` in .env | Contentful | `contentful` |
-| `SUPABASE_URL` in .env | Supabase | `@supabase/supabase-js` |
-| `FIREBASE_*` in .env | Firebase | `firebase` |
-| `APPWRITE_*` in .env | Appwrite | `appwrite` |
-| `POCKETBASE_URL` in .env | PocketBase | `pocketbase` |
-| `PAYLOAD_*` in .env | Payload CMS | `payload` |
-
-### Implications
-
-When BaaS detected:
-- **Don't suggest**: Custom REST endpoints, direct DB queries
-- **Do suggest**: Use SDK methods, follow BaaS patterns
-- **Data model**: Managed by BaaS (collections, content types)
-- **Auth**: Usually provider-managed
-
-## API Layer Type
-
-### REST (Custom)
-
-**Detection**:
-- `/api/**` routes with HTTP method handlers
-- `express`, `fastify`, `hono` in dependencies
-- `routes/`, `controllers/` folders
-
-**Pattern**: Custom endpoints, direct DB access
-
-### REST (BaaS)
-
-**Detection**:
-- BaaS SDK in dependencies
-- No `/api/` routes (or minimal proxy routes)
-- Env vars for BaaS URL
-
-**Pattern**: SDK calls, managed endpoints
-
-### GraphQL
-
-**Detection**:
-- `graphql`, `@apollo/client`, `urql` in dependencies
-- `.graphql` files, `gql` template literals
-- `/api/graphql` endpoint
-
-**Pattern**: Queries, mutations, fragments
-
-### tRPC
-
-**Detection**:
-- `@trpc/server`, `@trpc/client` in dependencies
-- `trpc/` folder with routers
-- Type-safe procedure calls
-
-**Pattern**: Procedures, type inference
-
-## Data Access Patterns
-
-### Direct Database
-
-**Detection**:
-- ORM/Query builder (Prisma, Drizzle, Knex)
-- `prisma/schema.prisma`, `drizzle/` folder
-- Direct SQL files
-
-**Implications**:
-- Can modify schema
-- Write migrations
-- Direct queries
-
-### Managed by BaaS
-
-**Detection**:
-- BaaS SDK, no ORM
-- No `prisma/`, no migrations
-- Content types managed in BaaS admin
-
-**Implications**:
-- Don't create tables, use BaaS admin
-- Query via SDK
-- Schema changes via BaaS dashboard
-
-### Hybrid
-
-**Detection**:
-- BaaS for content + local DB for app data
-- Multiple data sources
-
-**Implications**:
-- Identify which data goes where
-- Document boundary
-
-## API Client Patterns
-
-Where and how the project calls APIs.
-
-### React Patterns
-
-| Pattern | Location | Example |
-|---------|----------|---------|
-| Custom hooks | `hooks/use*.ts` | `useUsers()`, `useApi()` |
-| React Query | `hooks/` + `@tanstack/react-query` | `useQuery()` wrapper |
-| SWR | `hooks/` + `swr` | `useSWR()` wrapper |
-| Services | `services/*.ts` | `userService.getAll()` |
-| Direct fetch | In components | `fetch('/api/...')` |
-
-### Vue Patterns
-
-| Pattern | Location | Example |
-|---------|----------|---------|
-| Composables | `composables/use*.ts` | `useDirectus()`, `useApi()` |
-| Pinia stores | `stores/*.ts` | `useUserStore()` |
-| Services | `services/*.ts` | `userService.getAll()` |
-| Vue Query | `composables/` + `@tanstack/vue-query` | `useQuery()` |
-
-### Next.js Patterns
-
-| Pattern | Location | Example |
-|---------|----------|---------|
-| Server Actions | `actions/*.ts` or inline | `'use server'` functions |
-| API Routes | `app/api/**` | Route handlers |
-| Server Components | `app/**/page.tsx` | Direct DB/API calls |
-| Client hooks | `hooks/` | Client-side fetching |
-
-### Nuxt Patterns
-
-| Pattern | Location | Example |
-|---------|----------|---------|
-| Composables | `composables/use*.ts` | Auto-imported |
-| useFetch | In components | Built-in `useFetch()` |
-| useAsyncData | In components | SSR data fetching |
-| Server routes | `server/api/**` | Nitro API routes |
-
-### Detection Strategy
-
-1. Check for hooks/composables folder
-2. Search for `use` prefix functions
-3. Check for services folder
-4. Look at import patterns in components
-5. Identify the PRIMARY pattern (not all)
-
-## Validation Libraries
-
-| Dependency | Library | Usage |
-|------------|---------|-------|
-| `zod` | Zod | Schema-first, TypeScript inference |
-| `yup` | Yup | Schema builder, common with Formik |
-| `joi` | Joi | Enterprise, detailed validation |
-| `valibot` | Valibot | Lightweight Zod alternative |
-| `@sinclair/typebox` | TypeBox | JSON Schema compatible |
-
-**Pattern detection**:
-```
-Search for:
-- schemas/, validators/ folders
-- *.schema.ts, *.validator.ts files
-- z.object, yup.object, Joi.object imports
-```
-
-## Form Handling
-
-| Dependency | Library | Framework |
-|------------|---------|-----------|
-| `react-hook-form` | React Hook Form | React |
-| `formik` | Formik | React |
-| `vee-validate` | VeeValidate | Vue |
-| `@tanstack/react-form` | TanStack Form | React |
-| `formsnap` | Formsnap | Svelte |
-
-**Pattern detection**:
-```
-Search for:
-- useForm, useFormik imports
-- <Form>, <Field> components
-- form/, forms/ folders
-```
-
-## External Services
-
-### Payment
-
-| Env Var | Service | SDK |
-|---------|---------|-----|
-| `STRIPE_*` | Stripe | `stripe`, `@stripe/stripe-js` |
-| `PAYPAL_*` | PayPal | `@paypal/checkout-server-sdk` |
-| `LEMON_SQUEEZY_*` | Lemon Squeezy | `@lemonsqueezy/lemonsqueezy.js` |
-| `PADDLE_*` | Paddle | `@paddle/paddle-js` |
-
-### Email
-
-| Env Var | Service | SDK |
-|---------|---------|-----|
-| `RESEND_*` | Resend | `resend` |
-| `SENDGRID_*` | SendGrid | `@sendgrid/mail` |
-| `POSTMARK_*` | Postmark | `postmark` |
-| `MAILGUN_*` | Mailgun | `mailgun.js` |
-| `AWS_SES_*` | AWS SES | `@aws-sdk/client-ses` |
-
-### Storage
-
-| Env Var | Service | SDK |
-|---------|---------|-----|
-| `AWS_S3_*`, `S3_*` | AWS S3 | `@aws-sdk/client-s3` |
-| `CLOUDFLARE_R2_*` | Cloudflare R2 | `@aws-sdk/client-s3` (S3 compatible) |
-| `UPLOADTHING_*` | UploadThing | `uploadthing` |
-| `CLOUDINARY_*` | Cloudinary | `cloudinary` |
-
-### Search
-
-| Env Var | Service | SDK |
-|---------|---------|-----|
-| `ALGOLIA_*` | Algolia | `algoliasearch` |
-| `MEILISEARCH_*` | Meilisearch | `meilisearch` |
-| `TYPESENSE_*` | Typesense | `typesense` |
-
-### Analytics
-
-| Env Var | Service |
-|---------|---------|
-| `NEXT_PUBLIC_GA_*`, `GA_*` | Google Analytics |
-| `NEXT_PUBLIC_POSTHOG_*` | PostHog |
-| `MIXPANEL_*` | Mixpanel |
-| `SEGMENT_*` | Segment |
-
-### Monitoring
-
-| Env Var | Service |
-|---------|---------|
-| `SENTRY_*` | Sentry |
-| `DATADOG_*` | Datadog |
-| `LOGROCKET_*` | LogRocket |
-
-## Docker Compose Services
-
-Parse `docker-compose.yml` or `compose.yml`:
-
-| Service Image | Purpose |
-|---------------|---------|
-| `postgres:*` | PostgreSQL database |
-| `mysql:*` | MySQL database |
-| `mongo:*` | MongoDB |
-| `redis:*` | Redis cache/queue |
-| `minio:*` | S3-compatible storage |
-| `mailhog:*`, `mailpit:*` | Local email testing |
-| `directus:*` | Directus CMS |
-| `strapi:*` | Strapi CMS |
-
-## MCP Tools Detection
-
-Check `.claude/settings.local.json` or `mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "context7": { ... },
-    "playwright": { ... },
-    "shadcn": { ... }
-  }
-}
-```
-
-**Available MCPs provide capabilities:**
-
-| MCP | Capability |
-|-----|------------|
-| `context7` | Library documentation lookup |
-| `playwright` | Browser automation, screenshots |
-| `shadcn` | UI component source code |
-| Custom MCPs | Project-specific tools |
-
-## Output: stack.md
-
-```markdown
-# Project Stack
-
-> Auto-detected by /dev-scout. Verify and update as needed.
-
-## API Layer
-
-| Aspect | Value |
-|--------|-------|
-| Type | BaaS (Directus) |
-| SDK | @directus/sdk |
-| Pattern | composables/useDirectus.ts |
-
-## Data Access
-
-| Aspect | Value |
-|--------|-------|
-| Access | Managed by Directus |
-| Collections | users, posts, media |
-| Direct DB | No (use SDK) |
-
-## Auth
-
-| Aspect | Value |
-|--------|-------|
-| Provider | Directus Auth |
-| Pattern | middleware/auth.ts |
-| Storage | Directus handles sessions |
-
-## API Client
-
-| Aspect | Value |
-|--------|-------|
-| Pattern | Vue composables |
-| Location | composables/use*.ts |
-| Primary | useDirectus(), useApi() |
-
-## Validation & Forms
-
-| Aspect | Value |
-|--------|-------|
-| Validation | Zod (shared/schemas/) |
-| Forms | VeeValidate |
-
-## External Services
-
-| Service | Provider | Env Var |
-|---------|----------|---------|
-| Email | Resend | RESEND_API_KEY |
-| Storage | S3 via Directus | (managed) |
-| Payment | Stripe | STRIPE_SECRET_KEY |
-
-## Local Development
-
-| Service | Purpose | Port |
-|---------|---------|------|
-| postgres | Database | 5432 |
-| redis | Cache | 6379 |
-| directus | CMS | 8055 |
-
-## Available MCPs
-
-| MCP | Use For |
-|-----|---------|
-| context7 | Library docs |
-| playwright | UI testing |
-
-## Specs Guidelines
-
-Based on this stack, specs should:
-
-1. **API calls**: Use `useDirectus()` composable, not fetch
-2. **Data**: Use Directus collections, not raw SQL
-3. **Auth**: Use Directus auth middleware
-4. **Validation**: Add Zod schemas to shared/schemas/
-5. **Forms**: Use VeeValidate with Zod resolver
-6. **New features**: Follow composables pattern
-```
-
-## Detection Priority
-
-1. **Environment variables** - Most reliable for services
-2. **package.json** - SDKs and libraries
-3. **Config files** - Framework/tool configs
-4. **Code patterns** - How things are actually used
-5. **Docker compose** - Local services
-6. **MCP config** - Available tools

package/skills/dev-scout/references/tech-detection.md

@@ -1,211 +0,0 @@
-# Tech Stack Detection
-
-Detect frameworks, libraries, and tools from config files.
-
-## Frontend Frameworks
-
-### React
-
-**Detection**:
-- `package.json`: `"react"` in dependencies
-- Files: `*.jsx`, `*.tsx`
-- Imports: `import React from 'react'`
-
-**Variants**:
-| Config | Framework |
-|--------|-----------|
-| `next.config.*` | Next.js |
-| `remix.config.*` | Remix |
-| `gatsby-config.*` | Gatsby |
-| `vite.config.*` + react plugin | Vite + React |
-| `craco.config.*` | Create React App |
-
-### Vue
-
-**Detection**:
-- `package.json`: `"vue"` in dependencies
-- Files: `*.vue`
-- Config: `vue.config.*`
-
-**Variants**:
-| Config | Framework |
-|--------|-----------|
-| `nuxt.config.*` | Nuxt.js |
-| `vite.config.*` + vue plugin | Vite + Vue |
-| `quasar.config.*` | Quasar |
-
-### Svelte
-
-**Detection**:
-- `package.json`: `"svelte"` in dependencies
-- Files: `*.svelte`
-- Config: `svelte.config.*`
-
-**Variants**:
-| Config | Framework |
-|--------|-----------|
-| `svelte.config.*` + adapter | SvelteKit |
-
-### Angular
-
-**Detection**:
-- `package.json`: `"@angular/core"`
-- Files: `*.component.ts`
-- Config: `angular.json`
-
-## Backend Frameworks
-
-### Node.js
-
-| Dependency | Framework |
-|------------|-----------|
-| `express` | Express.js |
-| `fastify` | Fastify |
-| `koa` | Koa |
-| `hapi` | Hapi |
-| `@nestjs/core` | NestJS |
-| `hono` | Hono |
-
-### Python
-
-| File/Dependency | Framework |
-|-----------------|-----------|
-| `requirements.txt` + `django` | Django |
-| `requirements.txt` + `flask` | Flask |
-| `requirements.txt` + `fastapi` | FastAPI |
-| `pyproject.toml` | Modern Python |
-
-### Other
-
-| File | Language/Framework |
-|------|-------------------|
-| `go.mod` | Go |
-| `Cargo.toml` | Rust |
-| `Gemfile` | Ruby (Rails if rails gem) |
-| `composer.json` | PHP (Laravel if laravel/*) |
-
-## Databases
-
-### ORMs & Query Builders
-
-| Evidence | Technology |
-|----------|------------|
-| `prisma/schema.prisma` | Prisma |
-| `drizzle.config.*` | Drizzle |
-| `ormconfig.*`, `@Entity` | TypeORM |
-| `knexfile.*` | Knex.js |
-| `sequelize` in package.json | Sequelize |
-| `mongoose` in package.json | Mongoose (MongoDB) |
-
-### Database Type Detection
-
-| Dependency/Config | Database |
-|-------------------|----------|
-| `pg`, `postgres` | PostgreSQL |
-| `mysql`, `mysql2` | MySQL |
-| `better-sqlite3`, `sqlite3` | SQLite |
-| `mongodb`, `mongoose` | MongoDB |
-| `redis`, `ioredis` | Redis |
-| `@supabase/supabase-js` | Supabase (PostgreSQL) |
-| `@planetscale/database` | PlanetScale (MySQL) |
-
-## Authentication
-
-| Dependency | Provider |
-|------------|----------|
-| `next-auth` | NextAuth.js |
-| `@clerk/nextjs` | Clerk |
-| `@auth0/nextjs-auth0` | Auth0 |
-| `@supabase/auth-helpers-*` | Supabase Auth |
-| `firebase` + `firebase/auth` | Firebase Auth |
-| `passport` | Passport.js |
-| `lucia` | Lucia Auth |
-
-## Styling
-
-| Dependency/Config | Technology |
-|-------------------|------------|
-| `tailwindcss` | Tailwind CSS |
-| `styled-components` | Styled Components |
-| `@emotion/react` | Emotion |
-| `sass` | Sass/SCSS |
-| `@mui/material` | Material UI |
-| `@chakra-ui/react` | Chakra UI |
-| `@radix-ui/*` | Radix UI |
-| `shadcn` in components | shadcn/ui |
-
-## State Management
-
-| Dependency | Library |
-|------------|---------|
-| `redux`, `@reduxjs/toolkit` | Redux |
-| `zustand` | Zustand |
-| `jotai` | Jotai |
-| `recoil` | Recoil |
-| `mobx` | MobX |
-| `pinia` | Pinia (Vue) |
-| `vuex` | Vuex (Vue) |
-
-## API Patterns
-
-| Evidence | Pattern |
-|----------|---------|
-| `@trpc/*` | tRPC |
-| `graphql`, `@apollo/client` | GraphQL |
-| `/api/**` routes | REST API |
-| `openapi.*`, `swagger.*` | OpenAPI/Swagger |
-
-## Testing
-
-| Dependency | Framework |
-|------------|-----------|
-| `jest` | Jest |
-| `vitest` | Vitest |
-| `@testing-library/*` | Testing Library |
-| `cypress` | Cypress |
-| `playwright` | Playwright |
-| `mocha` | Mocha |
-
-## Deployment & Infrastructure
-
-| File/Config | Platform |
-|-------------|----------|
-| `vercel.json` | Vercel |
-| `netlify.toml` | Netlify |
-| `fly.toml` | Fly.io |
-| `railway.json` | Railway |
-| `Dockerfile` | Docker |
-| `.github/workflows/` | GitHub Actions |
-| `cloudflare.*` | Cloudflare |
-
-## Output Format
-
-```markdown
-## Tech Stack
-
-### Frontend
-- **Framework**: Next.js 14 (App Router)
-- **Language**: TypeScript
-- **Styling**: Tailwind CSS + shadcn/ui
-- **State**: Zustand
-
-### Backend
-- **Runtime**: Node.js
-- **API**: Next.js API Routes (REST)
-- **Auth**: NextAuth.js
-
-### Database
-- **ORM**: Prisma
-- **Database**: PostgreSQL (Supabase)
-
-### Infrastructure
-- **Hosting**: Vercel
-- **CI/CD**: GitHub Actions
-```
-
-## Detection Priority
-
-1. **Config files** (most reliable)
-2. **package.json dependencies**
-3. **File extensions & patterns**
-4. **Import statements** (when reading code)