# AOS Copilot Instructions

## Project
AOS (Agency Operating System) — self-hosted platform for German software agencies.

## Tech Stack
- Next.js 16 (App Router), TypeScript 5, Prisma (SQLite dev), shadcn/ui, Tailwind CSS 4
- Monochrome design system (no colors, only grays)
- German UI default (i18n: DE/EN/TR)

## Rules
- Money: integer cents, tax in basis points (1900 = 19%). No floats for money.
- GoBD: immutable after Festschreibung, corrections via Storno
- Audit: hash-chain on all business operations
- No mocks — real implementations only
- All API routes: try/catch error handling
- All icon-only buttons: aria-label (WCAG 2.1 AA)
- Client Portal: no agency-internal details visible to clients

## MCP Server
- 24 tools (11 read + 13 write)
- Pre-seeded admin token: aos_admin_seed_token_for_claude_code_2026
- .mcp.json at repo root for auto-detection

## Commands
- bun run dev — start dev server (port 3000)
- bun run lint — ESLint
- bun run db:push — push Prisma schema
- bun run src/lib/seed.ts — seed database