This is the initial commit for the CODEX_ADK project, a full-stack AI agent management platform featuring: BACKEND (ASP.NET Core 8.0): - CQRS architecture with 6 commands and 7 queries - 16 API endpoints (all working and tested) - PostgreSQL database with 5 entities - AES-256 encryption for API keys - FluentValidation on all commands - Rate limiting and CORS configured - OpenAPI/Swagger documentation - Docker Compose setup (PostgreSQL + Ollama) FRONTEND (Flutter 3.x): - Dark theme with Svrnty branding - Collapsible sidebar navigation - CQRS API client with Result<T> error handling - Type-safe endpoints from OpenAPI schema - Multi-platform support (Web, iOS, Android, macOS, Linux, Windows) DOCUMENTATION: - Comprehensive API reference - Architecture documentation - Development guidelines for Claude Code - API integration guides - context-claude.md project overview Status: Backend ready (Grade A-), Frontend integration pending 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1.6 KiB
1.6 KiB
Claude Code Context & Guidelines
This directory contains context and guidelines for Claude Code when working with this repository.
File Organization
Core Guidelines
- strict-typing.md - Strict typing requirements (NO dynamic, NO var, NO object)
- response-protocol.md - Claude Code response format standards
- api-quick-reference.md - Quick API reference
Frontend Integration (Flutter)
- FLUTTER-QUICK-START.md - Flutter 5-minute quick start guide
- FLUTTER-INTEGRATION.md - Complete Flutter integration documentation
Quick Reference
For Claude Code
When working on this project, always refer to:
/CLAUDE.md- Main project standards and CQRS patterns.claude-docs/strict-typing.md- Type safety requirements.claude-docs/response-protocol.md- Communication standards
For Developers
See project root:
/README.md- Main project documentation/CLAUDE.md- Claude Code instructions and CQRS patterns/docs/- API documentation, architecture, and OpenAPI spec
For Flutter Team
- Start:
.claude-docs/FLUTTER-QUICK-START.md - Complete guide:
.claude-docs/FLUTTER-INTEGRATION.md - API contract:
/docs/openapi.json
Document Purpose
These files provide context to Claude Code to ensure:
- Consistent code quality
- Proper typing and safety
- Clear communication
- Successful frontend integration with Flutter
Note: This directory is for Claude Code context. For general project documentation, see the root /docs directory.
Last Updated: 2025-01-26