# ByteLyst Agentic Notes — Cursor Rules
# Read AGENTS.md for full context.

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

## Architecture
- 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

## 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: feat(scope): description / fix(scope): description
- Never delete existing comments/documentation unless asked
- Never add emojis unless asked
- Never hardcode secrets, colors, or API URLs

## Build Verification
- cd backend && npm test && npm run typecheck && npm run build

## Key Documents
- AGENTS.md — Full AI agent instructions (read this first)