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

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

Frontend Integration (Flutter)

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