5cd4bc69ea
AGENTS.md covers: - Project identity and scopes (@bytelyst/* packages, @lysnrai/* services) - Full monorepo layout with all 7 packages and 5 services - Tech stack rules (ESM, Fastify 5, Zod, Vitest, pnpm) - Coding conventions (MUST/MUST NOT rules) - File ownership map (27 domains) - Build/test/dev commands - Common patterns (new module, new package, token workflow) - Environment variables reference - Dependency graph and build order - 12 common pitfalls CLAUDE.md is a compact summary referencing AGENTS.md.
25 lines
935 B
Markdown
25 lines
935 B
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`
|