39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
# 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.
|