# .clinerules — Cline / Roo Code Rules for ByteLyst Agentic Notes
# Read AGENTS.md for the complete onboarding guide.

## Project: ByteLyst Agentic Notes — Agentic note-taking workspace for notes, tasks, relationships, and workspaces
Architecture: Docs + Fastify 5 backend scaffold with TypeScript ESM and @bytelyst/* shared packages

## Mandatory Rules
- Backend follows the ByteLyst product-backend pattern with Fastify 5 + TypeScript ESM
- Use @bytelyst/* shared packages instead of reimplementing common infrastructure
- Fastify modules follow types.ts → repository.ts → routes.ts
- Use req.log / app.log — never console.log
- Every Cosmos document MUST include productId: "bytelyst-notes"
- Keep docs aligned with implementation as the repo evolves from scaffold to product
- Commits: `type(scope): description`
- After changes, verify: `cd backend && npm test && npm run typecheck && npm run build`

## Key File Locations
- docs/ — PRD, roadmap, and planning docs
- backend/ — Fastify 5 + TypeScript ESM backend scaffold (port 4016)
- backend/src/modules/ — notes, workspaces, note-relationships, note-tasks
- backend/src/lib/ — shared backend wiring and utilities
- Full guide: `AGENTS.md`