chore(harness): make repository agent-ready

Add concise routed context, task-aware agent roles, focused skills, and structured learning promotion.\n\nUnify local development and workspace tooling, add layered test and E2E verification, harden MCP authentication, and gate deployment behind verification and explicit production promotion.

packages/shared/AGENTS.md

@@ -0,0 +1,9 @@
+# Shared contracts
+
+`@sauci/shared` contains cross-application TypeScript types and constants only.
+
+- No runtime services, state, or application-specific behavior.
+- Export public contracts through `src/index.ts`.
+- Prefer generated Supabase types over duplicated handwritten database shapes.
+- Update every consumer when a shared contract changes.
+- Do not add production dependencies without an explicit architecture decision.

packages/shared/agents.md

@@ -1,76 +0,0 @@
-# Shared Package - Agent Guidelines
-
-**STRICT RULES - DO NOT VIOLATE**
-
-## Architecture
-
-This is a shared TypeScript package (`@sauci/shared`) containing:
-- **Types**: Shared TypeScript type definitions
-- **Package Name**: `@sauci/shared`
-
-## Directory Structure
-
-```
-src/
-  index.ts              # Main export file
-  types/                # Type definitions
-package.json            # Package configuration
-tsconfig.json           # TypeScript config
-```
-
-## Critical Rules
-
-### Purpose
-
-This package exists ONLY for sharing types across apps. It should contain:
-- TypeScript interfaces
-- Type definitions
-- Enums
-- Constants (if truly shared)
-
-**NO runtime code** - types only.
-
-### Exports
-
-All exports must go through `src/index.ts`:
-```typescript
-export * from './types';
-```
-
-### Usage in Apps
-
-Import in consuming apps:
-```typescript
-import type { Profile, Couple, Match } from '@sauci/shared';
-```
-
-### Type Definitions
-
-Types should match database schema. Core entities:
-- `Profile` - User profile extending Supabase auth
-- `Couple` - Two users linked via invite code
-- `QuestionPack` - Collection of questions
-- `Question` - Individual question with intensity
-- `Response` - User's answer (yes/no/maybe)
-- `Match` - Created when both partners answer positively
-
-### Adding Types
-
-When adding new types:
-1. Add to appropriate file in `src/types/`
-2. Export from `src/types/index.ts`
-3. Re-export from `src/index.ts`
-4. Run `npm run build` from root to verify
-
-### Versioning
-
-Types are internal - no npm publishing. Changes propagate automatically via Turborepo workspace linking.
-
-## Forbidden Actions
-
-1. **DO NOT** add runtime code (functions, classes with logic)
-2. **DO NOT** add dependencies (except dev dependencies)
-3. **DO NOT** create circular dependencies between types
-4. **DO NOT** duplicate types that exist in Supabase generated types
-5. **DO NOT** break backwards compatibility without updating all consumers
-6. **DO NOT** add app-specific types (keep them generic/shared)

packages/shared/package.json

@@ -9,6 +9,8 @@
         "./types": "./src/types/index.ts"
     },
     "scripts": {
+        "build": "tsc --noEmit",
+        "test": "vitest run --passWithNoTests",
         "typecheck": "tsc --noEmit",
         "lint": "eslint \"src/**/*.{ts,tsx}\""
     },
@@ -16,4 +18,4 @@
     "devDependencies": {
         "typescript": "^5.3.3"
     }
-}
+}