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

Read AGENTS.md first — it has coding conventions, file ownership, and tech stack rules.
Every Cosmos document must have a productId: "bytelyst-notes" field.
Commit messages: type(scope): description (feat, fix, docs, refactor, test, chore).
Fix source, not tests — unless the test itself is wrong.
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

pnpm --filter @notelett/backend run test
pnpm --filter @notelett/backend run typecheck
pnpm --filter @notelett/backend run build

Cross-Repo Automation

See ../learning_ai_common_plat/docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md for periodic maintenance tasks: test audits, coverage gaps, dependency checks, secret scans, typecheck sweeps.

1.6 KiB Raw Blame History