# ByteLyst Agentic Notes — Windsurf / Codeium Rules
# Read AGENTS.md for full context. These are the critical rules.

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

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

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

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