chore: Merge staging into main

.agent/rules/agents.md

@@ -0,0 +1 @@
+../../CLAUDE.md

.agent/workflows/check-layer-violations.md

@@ -45,14 +45,37 @@ Repeat until all changed files have been reviewed.
 | Layer | Location | Allowed | NOT Allowed |
 |-------|----------|---------|-------------|
 | **Presentation** | `app/`, `components/` | UI rendering, user interactions, `page.tsx` (Server Comp), calling server actions/API | Direct Prisma calls, business logic, `page.tsx` as Client Comp (avoid if possible) |
-| **API** | `app/api/`, `actions/` | Auth checks, input validation, calls to `lib/`, **Simple** Prisma operations (single table) | Transactions, aggregations, raw SQL, complex conditionally branching logic |
+| **API** | `app/api/`, `actions/` | Auth checks, input validation, calls to `lib/`, **Simple** Prisma operations (single table); new routes prefer package services | Transactions, aggregations, raw SQL, complex conditionally branching logic |
 | **Business Logic** | `lib/` (except `lib/hooks/`) | Data access, business rules, Prisma operations, universal utils (formatting) | JSX, React Components, React Hooks (`useState`, `useEffect`) |
 | **Client Hooks** | `lib/hooks/` | React hooks for client-side state | Direct Prisma calls, server-only code |
 | **Validation** | `lib/validations/` | Zod schemas, type exports | Database calls, async refinements with side effects |
 | **Schema** | `prisma/` | Model definitions, relations, indexes | Application logic, computed fields |
 
 ---
 
+## Additive Monorepo Note (New Features in packages/)
+
+This repo is transitioning to a monorepo without moving the legacy root app.
+
+- Legacy code remains in `app/`, `components/`, `actions/`, `lib/`, `prisma/`.
+- New features should prefer `packages/<featureOrDomain>/`.
+
+### Package boundary rules (enforced)
+
+- Code in `packages/**` must not import from legacy root folders (including the `@/` alias).
+- Feature packages must provide explicit entrypoints:
+  - `@simplifying/<feature>` (safe default)
+  - `@simplifying/<feature>/client` (React components/hooks)
+  - `@simplifying/<feature>/server` (repositories + server-only services)
+
+### Quick checks for package changes
+
+- Files under `packages/**` must not import `@/` (the legacy root alias).
+- Avoid imports of `@simplifying/*/server` from `packages/*/{components,hooks}/**` — client code cannot depend on server entrypoints.
+- If a file under `packages/*/{components,hooks}/**` imports `repositories/**` or `types.server.ts`, it's a violation.
+
+---
+
 ## Violation Patterns by Layer
 
 ### ❌ Presentation Layer Violations (`app/**/*.tsx`, `components/**/*.tsx`)