CLAUDE.md

Development Guidelines for Vibe Coding RAG

Commands

• Build/Install: poetry install
• Run: poetry run python -m app.main (once app is created)
• Lint: poetry run ruff check .
• Format: poetry run ruff format .
• Test: poetry run pytest
• Run single test: poetry run pytest path/to/test.py::test_function_name -v

Code Style

• Imports: Group standard library, third-party, and local imports
• Formatting: Use Black/Ruff compatible formatting
• Types: Use type annotations for function parameters and return values
• Naming:
  • Variables/functions: snake_case
  • Classes: PascalCase
  • Constants: UPPER_SNAKE_CASE
• Error Handling: Use try/except with specific exceptions
• Documentation: Docstrings for all public functions and classes

Technologies

• Vector DB: Qdrant
• Embeddings: SentenceTransformers with sentence-transformers/static-retrieval-mrl-en-v1
• API: FastAPI (when implemented)
• Frontend: HTML/CSS/JavaScript with DaisyUI components

MCP Integration

• Always call qdrant-code-search find tool when you are about to generate frontend code (HTML/CSS/JS)
• Store generated code snippets in qdrant-code-search store tool for future reference

Qdrant

• Point IDs have to be string-like UUIDs