Add header to the application

.github/workflows/claude-code-review.yml

@@ -0,0 +1,44 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+

.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

.python-version

@@ -1 +1 @@
-3.13
+3.11

CLAUDE.md

@@ -0,0 +1,94 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+**Always use `uv` to run Python commands and manage dependencies. Never use `pip` directly.**
+
+```bash
+# Install dependencies
+uv sync
+
+# Install dev dependencies (includes black)
+uv sync --extra dev
+
+# Run the application (starts on http://localhost:8000)
+./run.sh
+# Or manually:
+cd backend && uv run uvicorn app:app --reload --port 8000
+
+# Run a single Python file
+uv run python backend/<file>.py
+
+# Code quality commands
+./format.sh   # Format all Python files with black
+./check.sh    # Check formatting (exits with error if issues found)
+```
+
+**Environment Setup**: Copy `.env.example` to `.env` and set `ANTHROPIC_API_KEY`.
+
+## Architecture
+
+This is a RAG (Retrieval-Augmented Generation) chatbot for querying course materials. The system uses an agentic pattern where Claude decides when to search.
+
+### Query Flow
+
+```
+Frontend (script.js)
+    → POST /api/query
+    → RAGSystem.query()
+    → AIGenerator calls Claude with tools
+    → Claude invokes search_course_content tool
+    → CourseSearchTool.execute()
+    → VectorStore.search() (ChromaDB)
+    → Results returned to Claude
+    → Final response sent to frontend
+```
+
+### Backend Components (`backend/`)
+
+| File | Purpose |
+|------|---------|
+| `app.py` | FastAPI endpoints, serves frontend, loads docs on startup |
+| `rag_system.py` | Main orchestrator - coordinates all components |
+| `ai_generator.py` | Claude API integration with tool execution loop |
+| `search_tools.py` | Tool definitions for Claude (CourseSearchTool) |
+| `vector_store.py` | ChromaDB wrapper with two collections |
+| `document_processor.py` | Parses course files, chunks text with overlap |
+| `session_manager.py` | Conversation history per session |
+| `config.py` | Settings dataclass (chunk size, model, etc.) |
+| `models.py` | Pydantic models: Course, Lesson, CourseChunk |
+
+### ChromaDB Collections
+
+- **`course_catalog`**: Course metadata for fuzzy name resolution (title → exact match)
+- **`course_content`**: Text chunks with embeddings for semantic search
+
+### Document Format
+
+Course files in `/docs` follow this structure:
+```
+Course Title: [Name]
+Course Link: [URL]
+Course Instructor: [Name]
+
+Lesson 0: [Title]
+Lesson Link: [URL]
+[Content...]
+
+Lesson 1: [Title]
+[Content...]
+```
+
+### Key Configuration (`config.py`)
+
+- `CHUNK_SIZE`: 800 chars, `CHUNK_OVERLAP`: 100 chars
+- `MAX_RESULTS`: 5 search results returned
+- `MAX_HISTORY`: 2 conversation exchanges kept
+- Embedding model: `all-MiniLM-L6-v2`
+- LLM: `claude-sonnet-4-20250514`
+
+### Frontend (`frontend/`)
+
+Vanilla HTML/CSS/JS with Marked.js for markdown rendering. Communicates via `/api/query` and `/api/courses` endpoints.