# CLAUDE.md — Compact Agent Reference

Read [`AGENTS.md`](AGENTS.md) for full instructions. This file is a quick summary.

## Identity

- **Repo:** `learning_ai_common_plat` — shared `@bytelyst/*` packages + `@lysnrai/*` microservices
- **Consumers:** LysnrAI (voice dictation), MindLyst (multimodal memory)
- **Stack:** TypeScript, ESM, pnpm workspace, Fastify 5, Vitest, Azure Cosmos DB

## Key Commands

```bash
pnpm install && pnpm build && pnpm test   # full verify
pnpm --filter @lysnrai/platform-service dev  # run one service
pnpm --filter @bytelyst/design-tokens generate  # regen tokens
```

## Critical Rules

- Every Cosmos doc needs `productId`
- Every endpoint validates with Zod
- Services re-export `@bytelyst/*` in `src/lib/` files
- Services use self-contained Zod config (not from shared package)
- `@bytelyst/*` = packages, `@lysnrai/*` = services
- Use pnpm, never npm
- Commit format: `type(scope): description`

---

## Cross-Repo Automation

See [`docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md`](docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md) for periodic maintenance tasks: test audits, coverage gaps, dependency checks, secret scans, typecheck sweeps.
