9e527da492
- Updated CONTEXT-MAP.yml: workspace-v1 -> workspace-v2 (all paths) - Created .claude/ directory structure for agent integration: - README.md: Agent system documentation - agents/_MAP.md: Agent profiles map - constants/CONSTANTS-PROJECT.yml: Project constants - directivas/DIRECTIVAS-LOCALES.md: Local directives - directivas/_MAP.md: Directives map - referencias/PATHS-TRABAJO.md: Work paths reference Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
153 lines
3.5 KiB
Markdown
153 lines
3.5 KiB
Markdown
# 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
|