bytelyst/learning_ai_common_plat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
e310bd67ae
learning_ai_common_plat/CLAUDE.md
saravanakumardb1 5cd4bc69ea docs: add AGENTS.md and CLAUDE.md for AI coding agent onboarding 
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.
2026-02-12 12:51:39 -08:00

935 B
Raw Blame History

CLAUDE.md — Compact Agent Reference

Read 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

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