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>
48 lines
1.6 KiB
Markdown
48 lines
1.6 KiB
Markdown
# 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.md)** - Strict typing requirements (NO dynamic, NO var, NO object)
|
|
- **[response-protocol.md](response-protocol.md)** - Claude Code response format standards
|
|
- **[api-quick-reference.md](api-quick-reference.md)** - Quick API reference
|
|
|
|
### Frontend Integration (Flutter)
|
|
- **[FLUTTER-QUICK-START.md](FLUTTER-QUICK-START.md)** - Flutter 5-minute quick start guide
|
|
- **[FLUTTER-INTEGRATION.md](FLUTTER-INTEGRATION.md)** - Complete Flutter integration documentation
|
|
|
|
## Quick Reference
|
|
|
|
### For Claude Code
|
|
When working on this project, always refer to:
|
|
1. `/CLAUDE.md` - Main project standards and CQRS patterns
|
|
2. `.claude-docs/strict-typing.md` - Type safety requirements
|
|
3. `.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
|