34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# 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.
|