[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:
parent
0740f21c6c
commit
82f4dbb9d6
38
CLAUDE.md
38
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*
|
||||
|
||||
26
apps/_MAP.md
Normal file
26
apps/_MAP.md
Normal 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)*
|
||||
Loading…
Reference in New Issue
Block a user