docs: update CLAUDE.md with new features and architecture details

[pengelbrecht]

Summary

• Expanded CLAUDE.md with comprehensive project overview and updated architecture
• Documented new features including impersonation system, team invitations, middleware, and edge functions
• Added detailed database schema updates and CLI commands
• Included new components and design patterns for dialogs and forms
• Highlighted testing infrastructure and best practices

Changes

Documentation Enhancements

• Added project overview section with version, purpose, and key features
• Updated database architecture with teams and impersonation_sessions tables
• Detailed new authentication flows: OAuth, magic link, impersonation
• Expanded components list with new UI elements like TeamMembersDialog and ImpersonationBanner
• Introduced new middleware files for auth, role checks, and impersonation handling
• Described edge functions for team and user management operations
• Included testing strategies with Playwright, Vitest, and integration tests

Database and CLI

• Documented new tables: public.teams and public.impersonation_sessions
• Explained role-based access and session expiry for impersonation
• Added CLI commands for user and team management

UI and UX

• Clarified form/dialog design patterns for modals and responsive layouts
• Emphasized use of local loading states and consistent dialog components

Test plan

• Review documentation for clarity and completeness
• Verify database schema matches described tables
• Confirm middleware and edge functions align with documented behavior
• Test UI components for new features like impersonation and team invitations
• Validate CLI commands for expected outputs and functionality

This update ensures the CLAUDE.md reflects the current state of the project with all new features and architectural decisions clearly documented.

🌿 Generated by Terry

---

ℹ️ Tag @terragon-labs to ask questions and address PR feedback

📎 Task: https://www.terragonlabs.com/task/72f1347a-07f4-420f-b7f6-3dbd1235e498