Imported from garpanov/RAG-FTS-VECTORS-RRF (
AGENTS.md). Install upstream withnpx skills add garpanov/RAG-FTS-VECTORS-RRF. Copyright stays with the author.
Architecture
Use:
Router -> Service -> Repository -> Database
Routers contain no business logic.
Services contain business logic.
Repositories contain database access.
Database
- PostgreSQL + pgvector
- SQLAlchemy 2 async or psycopg
- Alembic migrations
- never use create_all in production
Code
- Python 3.14
- type hints required
- async where appropriate
- no unnecessary abstractions
Changes
Before implementing:
- inspect existing code
- propose a plan
- modify the minimum number of files
Never refactor unrelated code.
Verification
After changes run:
ruff check . mypy . pytest
Explain:
- what changed
- why
- possible risks