# 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`](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

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


---

## Cross-Repo Automation

See [`../learning_ai_common_plat/docs/devops/CODING_AGENT_AUTOMATION_PLAYBOOK.md`](../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.