learning_ai_notes/.github/copilot-instructions.md

GitHub Copilot Instructions — ByteLyst Agentic Notes

For full agent instructions, read 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

cd backend && npm test && npm run typecheck && npm run build