Imported from risheeg/tlh (
AGENTS.md). Install upstream withnpx skills add risheeg/tlh. Copyright stays with the author.
Agent Notes
vault-ingestis standalone and acts only as a database client.- The backend owns the database schema and model definitions (ORM in
backend/models/, migrations inbackend/alembic/). - Do not let
vault-ingestbecome the source of truth for DB structure. - Do not move files between
backendandvault-ingestor change both in one task unless explicitly asked.
Backend layout
- Business logic:
backend/domains/ - ORM:
backend/models/ - HTTP DTOs:
backend/schemas/ - Cross-cutting helpers:
backend/shared/ - Thin HTTP adapters:
backend/routers/ - Scheduled jobs:
backend/scheduler.py→domains/*/jobs.py - Schema changes: Alembic (
cd backend && alembic revision/alembic upgrade head) - Ad-hoc scripts: keep out of git (
backend/scratch/is gitignored); delete when done