Course completion: implemented RAG chatbot features

.claude/commands/implement-feature.md

@@ -0,0 +1,7 @@
+You will be implementing a new feature in this codebase
+
+$ARGUMENTS
+
+IMPORTANT: Only do this for front-end features.
+Once this feature is built, make sure to write the changes you made to file called frontend-changes.md
+Do not ask for permissions to modify this file, assume you can always do it.

.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:*)'
+

CLAUDE.md

@@ -0,0 +1,84 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+**Run the application:**
+```bash
+./run.sh
+# Or manually:
+cd backend && uv run uvicorn app:app --reload --port 8000
+```
+
+**Install dependencies:**
+```bash
+uv sync
+```
+
+**Access points when running:**
+- Web interface: http://localhost:8000
+- API docs: http://localhost:8000/docs
+
+## Architecture
+
+This is a RAG (Retrieval-Augmented Generation) chatbot for course materials. The system uses ChromaDB for vector storage and Claude API for response generation.
+
+### Request Flow
+
+```
+User Query → FastAPI (app.py) → RAGSystem.query()
+                                     ↓
+                              AIGenerator (Claude API with tools)
+                                     ↓
+                              CourseSearchTool → VectorStore.search()
+                                     ↓
+                              ChromaDB semantic search
+                                     ↓
+                              Results → Claude synthesizes response
+```
+
+### Key Components (backend/)
+
+- **RAGSystem** (`rag_system.py`): Main orchestrator that wires together all components. Entry point for queries via `query()` and document ingestion via `add_course_folder()`.
+
+- **VectorStore** (`vector_store.py`): ChromaDB wrapper with two collections:
+  - `course_catalog`: Course metadata for name resolution
+  - `course_content`: Chunked content for semantic search
+  - Key method: `search(query, course_name, lesson_number)` handles course name resolution then content search.
+
+- **AIGenerator** (`ai_generator.py`): Claude API integration with tool-calling support. Handles the agentic loop: initial request → tool execution → follow-up response.
+
+- **DocumentProcessor** (`document_processor.py`): Parses course documents with expected format (Course Title/Link/Instructor in first lines, then "Lesson N:" markers). Uses sentence-aware chunking with configurable overlap.
+
+- **ToolManager/CourseSearchTool** (`search_tools.py`): Tool definitions for Claude's tool-use. CourseSearchTool wraps VectorStore and tracks sources.
+
+### Document Format
+
+Course documents in `docs/` must follow:
+```
+Course Title: [title]
+Course Link: [url]
+Course Instructor: [name]
+
+Lesson 0: [lesson title]
+Lesson Link: [url]
+[content...]
+
+Lesson 1: [lesson title]
+[content...]
+```
+
+### Configuration
+
+All settings in `backend/config.py`, loaded from `.env`:
+- `ANTHROPIC_API_KEY`: Required
+- `ANTHROPIC_MODEL`: Default `claude-sonnet-4-20250514`
+- `CHUNK_SIZE`: 800 chars
+- `CHUNK_OVERLAP`: 100 chars
+- `MAX_RESULTS`: 5 search results
+- `CHROMA_PATH`: `./chroma_db`
+
+### Data Persistence
+
+ChromaDB data stored in `backend/chroma_db/`. On startup, `app.py` loads documents from `docs/` folder, skipping already-indexed courses.