# Sistema de Agentes para Template-SaaS

**Version:** 1.0
**Tipo:** STANDALONE (Provider)
**Fecha:** 2026-01-24
**Estado:** Operativo

---

## Vision General

Template-SaaS es el template base para aplicaciones SaaS multi-tenant. Proporciona funcionalidades base que heredan proyectos como erp-core y las verticales ERP.

### Caracteristicas

- Hereda directivas de workspace-v2
- Proyecto STANDALONE: base provider para otros proyectos
- Directivas locales que extienden las globales
- Referencias de paths pre-resueltas

---

## Herencia

Este proyecto hereda de:

| Fuente | Que Hereda |
|--------|------------|
| workspace-v2/orchestration/ | Directivas globales, triggers, modos |
| workspace-v2/shared/catalog/ | Funcionalidades reutilizables |

Este proyecto exporta a:

| Destino | Que Exporta |
|---------|-------------|
| erp-core | Patrones base SaaS, auth, multi-tenancy |
| Verticales ERP | Via erp-core (herencia transitiva) |

---

## Directivas Criticas

### Heredadas del Workspace (OBLIGATORIAS)

1. **@DV-MASTER** - Validacion anti-alucinacion
   - Validar contra docs/ antes de implementar
   - Path: `workspace-v2/orchestration/directivas/triggers/TRIGGER-VALIDACION-DOCUMENTACION.md`

2. **@CAPVED** - Ciclo de 6 fases
   - C: Contexto -> A: Analisis -> P: Plan -> V: Validacion -> E: Ejecucion -> D: Documentacion
   - Path: `workspace-v2/orchestration/directivas/principios/PRINCIPIO-CAPVED.md`

3. **@FETCH-OBLIGATORIO** - Sincronizar antes de operar
   - Path: `workspace-v2/orchestration/directivas/triggers/TRIGGER-FETCH-OBLIGATORIO.md`

4. **@COMMIT-PUSH** - Persistir cambios
   - Path: `workspace-v2/orchestration/directivas/triggers/TRIGGER-COMMIT-PUSH-OBLIGATORIO.md`

### Locales (Especificas de este Proyecto)

Ver: `directivas/_MAP.md`

---

## Perfiles de Agentes

### Usar Perfiles del Workspace

Para tareas estandar, usar perfiles de:
```
workspace-v2/orchestration/agents/perfiles/
```

### Perfiles Locales (si existen)

Ver: `agents/_MAP.md`

---

## Referencias de Trabajo

### Paths del Proyecto

Ver: `referencias/PATHS-TRABAJO.md`

### Constantes

Ver: `constants/CONSTANTS-PROJECT.yml`

---

## Quick Start

### 1. Cargar Contexto

```
# Leer directivas criticas
@DV-MASTER
@CAPVED

# Leer contexto del proyecto
.claude/referencias/PATHS-TRABAJO.md
```

### 2. Antes de Implementar

```
1. Validar que existe en docs/ (DV-MASTER)
2. Si no existe -> DETENER y preguntar
3. Si existe -> Seguir specs
```

### 3. Despues de Implementar

```
1. Actualizar documentacion afectada
2. Actualizar inventarios si aplica
3. git add && git commit && git push
4. Evaluar propagacion a erp-core
```

---

## Estructura del Proyecto

```
template-saas/
├── .claude/                 # Este directorio
│   ├── agents/             # Perfiles locales
│   ├── directivas/         # Directivas locales
│   ├── referencias/        # Paths de trabajo
│   └── constants/          # Constantes del proyecto
├── apps/                    # Aplicaciones
│   ├── backend/            # Backend NestJS
│   ├── frontend/           # Frontend React
│   └── database/           # DDL y scripts BD
├── docs/                    # Documentacion del proyecto
└── orchestration/           # Orquestacion local
```

---

## Referencias

- Workspace: `/home/isem/workspace-v2`
- Proyecto: `/home/isem/workspace-v2/projects/template-saas`
- Directivas globales: `workspace-v2/orchestration/directivas/`

---

**Sistema:** SIMCO v4.0.0
**Implementado:** 2026-01-24