add SKILL

docs/adr/README.md

@@ -4,7 +4,6 @@ ADRs are short, versioned documents that capture **why** we made a major archite
 They prevent “tribal knowledge” and make reversals/migrations explicit.
 
 ---
-**Last Updated:** 2025-12-12  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — adopt in Phase 1  
 **Owner:** Tech Leads  

docs/archetypes.md

@@ -4,10 +4,9 @@ This template is intentionally **modular**. It contains a set of reusable buildi
 To keep it universal, **choose an archetype first**, then keep only the modules that apply to your product.
 
 ---
-**Last Updated:** 2025-12-11  
-**Phase:** Phase 0 (Planning)  
-**Status:** Draft  
-**Owner:** Product + Tech Leads  
+**Phase:** Phase 0 (Planning)
+**Status:** Draft
+**Owner:** Product + Tech Leads
 ---
 
 ## 1. Choose a Product Archetype

docs/backend/api-design.md

@@ -1,7 +1,6 @@
 # Backend: API Design
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** Backend Architect  

docs/backend/architecture.md

@@ -1,7 +1,6 @@
 # Backend: Architecture (Recommendations)
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** Backend Architect  

docs/backend/overview.md

@@ -1,7 +1,6 @@
 # Backend: Overview
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft  
 **Owner:** Backend Architect  

docs/backend/payment-flow.md

@@ -1,7 +1,6 @@
 # Payment & Billing Flow (Provider‑agnostic)
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** Backend Architect  

docs/backend/security.md

@@ -1,7 +1,6 @@
 # Backend: Security (Template)
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** Backend Architect, Security  

docs/content-structure.md

@@ -1,7 +1,6 @@
 # App & Content Structure (Template)
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft  
 **Owner:** Product, UX/UI  

docs/dev-setup.md

@@ -1,10 +1,9 @@
 # Development Setup (Starter Template)
 
 ---
-**Last Updated:** 2025-12-12  
-**Phase:** Phase 0 (Planning)  
-**Status:** Draft — finalize when code starts  
-**Owner:** Tech Leads  
+**Phase:** Phase 0 (Planning)
+**Status:** Draft — finalize when code starts
+**Owner:** Tech Leads
 **References:**
 - `/RECOMMENDATIONS.md`
 - `/RULES.md`

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

docs/frontend/architecture.md

@@ -1,7 +1,6 @@
 # Frontend: Architecture (Recommendations)
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** Frontend Architect  

docs/frontend/overview.md

@@ -1,7 +1,6 @@
 # Frontend: Overview
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft  
 **Owner:** Frontend Architect  

docs/frontend/seo-performance.md

@@ -1,7 +1,6 @@
 # Frontend: SEO & Performance
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft  
 **Owner:** Frontend Architect, SEO  

docs/frontend/ui-ux-guidelines.md

@@ -1,7 +1,6 @@
 # Frontend: UX/UI Guidelines
 
 ---
-**Last Updated:** 2025-01-17  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft  
 **Owner:** UX/UI Team  

docs/llm/caching-costs.md

@@ -1,7 +1,6 @@
 # LLM System: Caching & Cost Control (Starter Template)
 
 ---
-**Last Updated:** 2025-12-12  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** AI/LLM Lead + Backend Architect  

docs/llm/evals.md

@@ -1,7 +1,6 @@
 # LLM System: Evals & Quality (Starter Template)
 
 ---
-**Last Updated:** 2025-12-12  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** AI/LLM Lead + Test Engineer  

docs/llm/prompting.md

@@ -1,7 +1,6 @@
 # LLM System: Prompting (Starter Template)
 
 ---
-**Last Updated:** 2025-12-12  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** AI/LLM Lead  

docs/llm/rag-embeddings.md

@@ -1,7 +1,6 @@
 # LLM System: RAG & Embeddings (Starter Template)
 
 ---
-**Last Updated:** 2025-12-12  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** AI/LLM Lead + Backend Architect  

docs/llm/safety.md

@@ -1,7 +1,6 @@
 # LLM System: Safety, Privacy & Reasoning Traces (Starter Template)
 
 ---
-**Last Updated:** 2025-12-12  
 **Phase:** Phase 0 (Planning)  
 **Status:** Draft — finalize in Phase 1  
 **Owner:** Security + AI/LLM Lead  

docs/phases-plan.md

@@ -1,10 +1,9 @@
 # Phased Plan (Starter Template)
 
 ---
-**Last Updated:** 2025-01-17  
-**Phase:** Phase 0 (Planning)  
-**Status:** Draft — update as phases complete  
-**Owner:** Product Team  
+**Phase:** Phase 0 (Planning)
+**Status:** Draft — update as phases complete
+**Owner:** Product Team
 **References:**
 - `/docs/project-overview.md` (project goals and requirements)
 - `/docs/backend/architecture.md` (technical implementation plan)

docs/project-overview.md

@@ -1,10 +1,9 @@
 # Project Overview: Starter Template (Provider‑agnostic)
 
 ---
-**Last Updated:** 2025-01-17  
-**Phase:** Phase 0 (Planning)  
-**Status:** Draft  
-**Owner:** Product Team  
+**Phase:** Phase 0 (Planning)
+**Status:** Draft
+**Owner:** Product Team
 **References:**  
 - `/docs/phases-plan.md` (development roadmap)  
 - `/docs/content-structure.md` (app/screen structure)