Add CLAUDE.md and comprehensive documentation

[sunapi386]

Summary

• Add CLAUDE.md with development commands, architecture overview, conventions, and project structure for AI-assisted development
• Add docs/ directory with 10 comprehensive documentation files covering architecture, authentication, components, database schema, development guide, edge functions, hooks, realtime subscriptions, and AI agents
• Total: 1,771 lines of documentation across 11 new files

Documentation Files

File	Description
CLAUDE.md	Top-level project guide for Claude Code
docs/README.md	Documentation index
docs/architecture.md	System architecture and provider hierarchy
docs/authentication.md	Auth flow, token-based RBAC, share tokens
docs/components.md	React component organization by domain
docs/database-schema.md	PostgreSQL tables, RPC functions, RLS policies
docs/development-guide.md	Setup, commands, conventions, deployment
docs/edge-functions.md	Supabase edge function patterns and catalog
docs/hooks.md	Custom React hooks reference
docs/realtime.md	Realtime subscription patterns
docs/ai-agents.md	AI agent configuration and JSON specs

Test plan

• Verify all markdown files render correctly
• Verify no existing files were modified
• Confirm documentation accurately reflects codebase structure

🤖 Generated with Claude Code