add SKILL

docs/examples/RECOMMENDATIONS-example.md

@@ -0,0 +1,67 @@
+# Project-Specific Recommendations & Overrides (EXAMPLE)
+
+> This is a **filled-in example** for a compliance document classifier (Archetype C).
+> Copy `RECOMMENDATIONS.md` from the repo root and replace placeholders with your values.
+
+---
+
+## 1. Project Context
+- **Domain / product type:** Compliance document classifier for financial institutions
+- **Chosen archetype:** C — Classification / Decision Support Pipeline
+- **Modules in scope:** core AI, integrations, pipeline, human feedback, events, reporting, multi-tenancy, billing
+- **Primary users:** compliance officers, team leads, auditors
+- **Key success metrics:** classification accuracy > 95%, p95 latency < 3s, < 5% manual reviews
+- **Current phase:** Phase 1
+- **Repos/services in scope:** monorepo (`apps/web`, `apps/api`, `packages/shared`)
+
+## 2. Locked Stack Decisions
+
+**Frontend**
+- **Framework:** Next.js 15 (App Router)
+- **Language:** TypeScript 5.7
+- **Styling:** Tailwind CSS 4.x + shadcn/ui
+- **Server/Client data layer:** React Query v5
+- **Forms & validation:** React Hook Form + Zod
+- **Auth client:** Clerk
+
+**Backend**
+- **Runtime/language:** Node.js 22 LTS + TypeScript 5.7
+- **Framework:** Fastify
+- **Database:** PostgreSQL 16 (vector search: pgvector)
+- **ORM:** Drizzle
+- **Queues/workers:** BullMQ (Redis 7)
+- **LLM provider & helper:** Single `callLLM()` abstraction, provider: Anthropic (Claude Sonnet)
+- **File/storage:** Cloudflare R2
+
+**Infra / DevOps**
+- **Hosting/deploy:** Vercel (web) + Railway (api + workers)
+- **CI/CD:** GitHub Actions
+- **Observability:** Sentry (errors) + Axiom (logs)
+- **Environments:** dev / staging / prod
+
+## 3. Non-Negotiable Constraints
+- **Compliance/regulation:** SOC2, GDPR (EU data residency)
+- **Data residency/retention:** EU-only, 7-year retention for audit logs
+- **Performance/SLOs:** p95 classification < 3s, API p99 < 500ms
+- **Cost limits:** LLM budget $2000/month, infra cap $500/month
+- **Target platforms:** Chrome/Firefox/Safari latest 2 versions, desktop-first
+- **Repository constraints:** no `npm run dev` in CI; all merges via PR with at least 1 approval
+
+## 4. Deviations From Template
+- Using Fastify instead of Express → better async performance and schema validation built-in → no migration plan needed (greenfield)
+- Using Drizzle instead of Prisma → lighter, better SQL control for complex queries → can migrate via schema dump if needed
+- Skipping i18n in Phase 2 → single-locale MVP (English), will add next-intl in Phase 3
+
+## 5. Open Questions / To Confirm
+- Vector embedding model choice (OpenAI ada-002 vs Cohere) → backend lead → Phase 1
+- Exact Clerk plan and SSO requirements → product owner → Phase 1
+
+## 6. Change Log
+- 2025-01-15: Locked Fastify + Drizzle (ADR-0001)
+- 2025-01-20: Chose Cloudflare R2 over S3 (cost + EU edge)
+- 2025-02-01: Set LLM budget cap at $2000/month
+
+## 7. Architecture Decision Records (ADRs)
+- `docs/adr/0001-fastify-over-express.md` — accepted
+- `docs/adr/0002-drizzle-over-prisma.md` — accepted
+- `docs/adr/0003-cloudflare-r2-storage.md` — accepted