diff --git a/CLAUDE.md b/CLAUDE.md index 954b4be..2d873f0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,8 +4,9 @@ **Sistema:** SIMCO v4.0.0 + NEXUS v4.0 **Proyecto:** local-llm-agent **Tipo:** INFRASTRUCTURE -**Versión:** 0.1.0 -**Actualizado:** 2026-02-02 +**Versión:** 1.0.0 +**Actualizado:** 2026-02-06 +**ADR Vinculante:** ADR-0011 (Estructura Canonica apps/) --- @@ -16,13 +17,13 @@ Para reglas base, ver: `../../CLAUDE.md` --- -## DESCRIPCIÓN DEL PROYECTO +## DESCRIPCION DEL PROYECTO Agente LLM local para procesamiento de lenguaje natural. Sirve como infraestructura para todos los proyectos del workspace. --- -## STACK TECNOLÓGICO +## STACK TECNOLOGICO - Runtime: Python 3.11+ - LLM: Ollama / Local Models @@ -30,9 +31,30 @@ Agente LLM local para procesamiento de lenguaje natural. Sirve como infraestruct --- +## ESTRUCTURA CANONICA (ADR-0011) + +``` +local-llm-agent/ +├── apps/ # Contenedor canonico de aplicaciones +│ ├── gateway/ # API Gateway +│ ├── inference-engine/ # Motor de inferencia LLM +│ └── _MAP.md # Indice de aplicaciones +├── config/ # Configuracion +├── monitoring/ # Monitoring +├── lora-adapters/ # LoRA adapters +├── orchestration/ # Sistema SIMCO local +├── docs/ # Documentacion +├── scripts/ # Utilidades +└── .claude/ # Instrucciones Claude Code +``` + +**IMPORTANTE:** Todo desarrollo nuevo DEBE ir dentro de `apps/`. No crear archivos en raiz. + +--- + ## SERVICIOS QUE PROVEE -Este proyecto provee servicios de LLM a todos los demás proyectos (*). +Este proyecto provee servicios de LLM a todos los demas proyectos (*). --- @@ -41,7 +63,11 @@ Este proyecto provee servicios de LLM a todos los demás proyectos (*). | Alias | Ruta | |-------|------| | @LOCAL-ORCHESTRATION | orchestration/ | +| @GATEWAY | apps/gateway/ | +| @INFERENCE | apps/inference-engine/ | +| @APPS-MAP | apps/_MAP.md | --- -**Sistema:** SIMCO v4.0.0 | **Tipo:** Instrucciones de Proyecto +*Local LLM Agent v1.0.0 - Sistema SIMCO v4.0.0* +*Estructura canonica apps/ verificada: 2026-02-06* diff --git a/apps/_MAP.md b/apps/_MAP.md new file mode 100644 index 0000000..5d00b10 --- /dev/null +++ b/apps/_MAP.md @@ -0,0 +1,26 @@ +# _MAP: Aplicaciones de local-llm-agent + +**Carpeta:** apps/ +**Proposito:** Contenedor canonico de todas las aplicaciones del proyecto (ADR-0011) +**Estado:** Activo +**Ultima actualizacion:** 2026-02-06 + +--- + +## Aplicaciones + +| App | Ruta | Tipo | Stack | Estado | Git | +|-----|------|------|-------|--------|-----| +| **Gateway** | `apps/gateway/` | API Gateway | FastAPI + Python 3.11 | Activo | Tracked | +| **Inference Engine** | `apps/inference-engine/` | LLM Engine | Python + Ollama/vLLM | Activo | Tracked | + +--- + +## Notas + +- No tiene submodulos - todas las aplicaciones son directorios tracked +- Estructura apps/ ya existia antes de ADR-0011 (verificada como compatible) + +--- + +*Generado por TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS (Sprint 4)*