# GitHub Copilot Instructions — ByteLyst Agentic Notes

> For full agent instructions, read [`AGENTS.md`](../AGENTS.md) at the repo root.

## Project Context

**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

## Code Generation Rules

### Always
- 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
- Include `productId: "bytelyst-notes"` in every Cosmos DB document
- Use `type(scope): description` commit message format
- Fix source code, not tests (unless the test itself is wrong)

### Never
- `console.log` or `print()` in production code
- Hardcoded secrets, API keys, colors, or URLs
- Delete existing comments or documentation unless explicitly asked
- Add emojis unless asked

## Key Paths
- 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

## Build Verification
```bash
cd backend && npm test && npm run typecheck && npm run build
```