learning_ai_notes/CLAUDE.md
2026-03-10 22:56:39 -07:00

1.2 KiB

ByteLyst Agentic Notes — Claude Code Instructions

This file is read automatically by Claude Code. For full agent instructions shared across all AI tools, see AGENTS.md.

Quick Context

Product: 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

Rules

  1. Read AGENTS.md first — it has coding conventions, file ownership, and tech stack rules.
  2. Every Cosmos document must have a productId: "bytelyst-notes" field.
  3. Commit messages: type(scope): description (feat, fix, docs, refactor, test, chore).
  4. Fix source, not tests — unless the test itself is wrong.
  5. Never use console.log, print(), or hardcoded colors/secrets/URLs.

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

Build Verification

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