# CLAUDE.md - Local LLM Agent

**Hereda de:** workspace-v2/CLAUDE.md
**Sistema:** SIMCO v4.0.0 + NEXUS v4.0
**Proyecto:** local-llm-agent
**Tipo:** INFRASTRUCTURE
**Versión:** 1.0.0
**Actualizado:** 2026-02-06
**ADR Vinculante:** ADR-0011 (Estructura Canonica apps/)

---

## EXTENSIONES LOCALES

Este archivo EXTIENDE (no reemplaza) las reglas del workspace.
Para reglas base, ver: `../../CLAUDE.md`

---

## DESCRIPCION DEL PROYECTO

Agente LLM local para procesamiento de lenguaje natural. Sirve como infraestructura para todos los proyectos del workspace.

---

## STACK TECNOLOGICO

- Runtime: Python 3.11+
- LLM: Ollama / Local Models
- API: FastAPI

---

## 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 demas proyectos (*).

---

## ALIAS LOCALES

| Alias | Ruta |
|-------|------|
| @LOCAL-ORCHESTRATION | orchestration/ |
| @GATEWAY | apps/gateway/ |
| @INFERENCE | apps/inference-engine/ |
| @APPS-MAP | apps/_MAP.md |

---

*Local LLM Agent v1.0.0 - Sistema SIMCO v4.0.0*
*Estructura canonica apps/ verificada: 2026-02-06*