Add CLAUDE.MD context file for AI development

[Alek99]

Summary

Adds a comprehensive CLAUDE.MD file that provides project context for AI development assistants, particularly Claude Code.

What's Included

• Project Overview: Purpose, tech stack, and repository information
• Project Structure: Detailed directory tree with explanations
• Key Files: Important configuration and application files with references
• Development Workflow: Setup, testing, code quality, and CI/CD processes
• Database Models: Schema and migration information
• Styling Architecture: Tailwind CSS v4 and component system details
• Common Tasks: Practical guides for adding pages, docs, blog posts, and making changes
• Architecture Notes: How Reflex works, rendering, and component patterns
• Testing Strategy: Unit and integration testing approaches

Why This Helps

This file will help AI assistants:

• Better understand the codebase structure
• Provide more accurate code suggestions
• Follow project conventions and patterns
• Know where to find key files and configurations
• Understand the development workflow

Test Plan

• File is properly formatted with markdown
• All paths are relative (no user-specific absolute paths)
• Information is accurate and up-to-date
• Covers all major aspects of the project

🤖 Generated with Claude Code

[greptile-apps]

Greptile Overview

Greptile Summary

Added a comprehensive CLAUDE.MD file providing project context for AI development assistants. The document covers project overview, tech stack, directory structure, key files, development workflow, and common tasks.

• Well-structured and comprehensive documentation for AI assistants
• Provides useful context about Reflex framework, tech stack, and project conventions
• Includes practical guides for common development tasks
• Minor inaccuracies found: component subdirectory count (claims 22, actual is 4), blog post count (claims 29+, actual is 27)
• Branch information section will become outdated and should be removed or made dynamic

Confidence Score: 4/5

• This PR is safe to merge with minimal risk - it's a documentation-only addition
• Score reflects that this is purely additive documentation with no code changes. Minor inaccuracies in directory/file counts should be corrected but don't pose any risk. The file provides valuable context for AI assistants working with the codebase.
• No files require special attention - only minor corrections needed for accuracy

Important Files Changed

Filename	Overview
CLAUDE.MD	Comprehensive AI context file for the project with generally accurate information. Minor discrepancies in component count (doc says 22 subdirectories, actual is 4) and blog post count (doc says 29+, actual is 27). Branch information section may become outdated.

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant AI as AI Assistant (Claude Code)
    participant Context as CLAUDE.MD
    participant Repo as Repository Files
    
    Dev->>AI: Request code change or question
    AI->>Context: Read project overview and structure
    Context-->>AI: Return tech stack, directories, key files
    AI->>Context: Check relevant sections (styling/db/testing)
    Context-->>AI: Return specific guidance and patterns
    AI->>Repo: Navigate to relevant files using paths from context
    Repo-->>AI: Return file contents
    AI->>AI: Apply project conventions from context
    AI->>Dev: Provide accurate suggestion following project patterns

Loading

[greptile-apps]

_{1 file reviewed, 4 comments}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

doc says 22 subdirectories but pcweb/components/ only has 4 subdirectories

Suggested change

	│ ├── components/ # Reusable UI components (22 subdirectories)
	│ ├── components/ # Reusable UI components (4 subdirectories)

[greptile-apps]

doc says 29+ markdown files but blog/ directory has 27 markdown files

Suggested change

	├── blog/ # Blog posts (29+ markdown files)
	├── blog/ # Blog posts (27 markdown files)

[greptile-apps]

doc says 29+ blog posts but there are 27 markdown files in the blog/ directory

Suggested change

	Blog posts (29+) cover technical topics and framework updates.
	Blog posts (27) cover technical topics and framework updates.

[greptile-apps]

hard-coding branch name will quickly become outdated - consider removing or making this dynamic