CODEX_ADK/BACKEND/.claude-docs/README.md
jean-philippe 3fae2fcbe1 Initial commit: CODEX_ADK (Svrnty Console) MVP v1.0.0
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>
2025-10-26 18:32:38 -04:00

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