Skip to content

Conversation

@gwho
Copy link

@gwho gwho commented Dec 30, 2025

Summary

  • Add comprehensive CLAUDE.md documentation for future Claude Code instances
  • Add detailed query flow diagram with Mermaid visualizations

Changes

CLAUDE.md

  • Development commands and package management guidelines (emphasizes using uv)
  • Complete architecture overview of all 7 core backend components
  • Data models and configuration details
  • RAG query flow explanation
  • Vector store two-collection design pattern

docs/query-flow-diagram.md

  • Mermaid sequence diagram showing complete query flow from frontend to backend
  • Architecture flowchart with all system components
  • Component architecture diagram with dependencies
  • Data flow breakdown by processing stage
  • Performance characteristics and latency analysis
  • Error handling flow diagram
  • Configuration values and optimization notes

Purpose

These documentation files will help future developers and Claude Code instances quickly understand:

  • How to work with this codebase effectively
  • The complete architecture and data flow
  • Best practices for dependency management
  • Performance characteristics and bottlenecks

🤖 Generated with Claude Code

- Add CLAUDE.md with comprehensive project documentation
  - Development commands and package management guidelines
  - Architecture overview of all core components
  - Data models and configuration details
  - RAG query flow explanation
  - Vector store two-collection design
  - Emphasizes using uv for all dependency management

- Add docs/query-flow-diagram.md with visual diagrams
  - Mermaid sequence diagram showing complete query flow
  - Architecture flowchart with all system components
  - Component architecture diagram
  - Data flow breakdown by stage
  - Performance characteristics and latency analysis
  - Error handling flow
  - Configuration values and optimization notes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant