[TASK-2026-02-06-ESTANDARIZACION-ESTRUCTURA-PROYECTOS] docs: Add ADR-0011 governance (apps/ already canonical)

- Updated CLAUDE.md v1.0.0 with canonical structure
- Added apps/_MAP.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-02-06 10:37:41 -06:00
parent 0740f21c6c
commit 82f4dbb9d6
2 changed files with 58 additions and 6 deletions

View File

@ -4,8 +4,9 @@
**Sistema:** SIMCO v4.0.0 + NEXUS v4.0 **Sistema:** SIMCO v4.0.0 + NEXUS v4.0
**Proyecto:** local-llm-agent **Proyecto:** local-llm-agent
**Tipo:** INFRASTRUCTURE **Tipo:** INFRASTRUCTURE
**Versión:** 0.1.0 **Versión:** 1.0.0
**Actualizado:** 2026-02-02 **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. 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+ - Runtime: Python 3.11+
- LLM: Ollama / Local Models - 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 ## 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 | | Alias | Ruta |
|-------|------| |-------|------|
| @LOCAL-ORCHESTRATION | orchestration/ | | @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*

26
apps/_MAP.md Normal file
View File

@ -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)*