[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure
- Move 6 non-standard folders to _archive/ - Update _MAP.md with standardized structure Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0 Level: SUB-CONSUMER Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
294ea9595b
commit
8bb46e4d08
2
backend
2
backend
@ -1 +1 @@
|
||||
Subproject commit 25d59cd031f9577af1a3e3fd7870887ca6db74be
|
||||
Subproject commit fd9f7004bc8b02a01aba03addcdbf881fdc9ca9b
|
||||
2
database
2
database
@ -1 +1 @@
|
||||
Subproject commit 6235880380d02c25ddca9e4f10cc79090c1d72e1
|
||||
Subproject commit 8ed6366b3006457a5a16dfa58fb3ad0c09eb7ac5
|
||||
2
frontend
2
frontend
@ -1 +1 @@
|
||||
Subproject commit 35f98c825860ee86b4de996385f7f3d22e50e7cc
|
||||
Subproject commit 36a84875a4367a91b303c8159454594f84d7aeb9
|
||||
@ -1,48 +1,102 @@
|
||||
# MAPA DE ORQUESTACION: clinica-veterinaria
|
||||
|
||||
**Proyecto:** clinica-veterinaria
|
||||
**Nivel:** NIVEL_2B.2
|
||||
**Sistema:** NEXUS v4.0 + SIMCO + SAAD
|
||||
**Ultima actualizacion:** 2026-01-10
|
||||
**Nivel:** SUB-CONSUMER (hereda de erp-clinicas)
|
||||
**Sistema:** SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
|
||||
**Ultima actualizacion:** 2026-01-24
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
## Estructura Estandarizada
|
||||
|
||||
```
|
||||
orchestration/
|
||||
├── 00-guidelines/
|
||||
│ └── CONTEXTO-PROYECTO.md
|
||||
├── environment/
|
||||
├── inventarios/
|
||||
├── trazas/
|
||||
├── CONTEXT-MAP.yml
|
||||
├── PROJECT-STATUS.md
|
||||
├── PROXIMA-ACCION.md
|
||||
└── _MAP.md
|
||||
├── 00-guidelines/ # Guidelines locales del proyecto
|
||||
│ ├── CONTEXTO-PROYECTO.md
|
||||
│ ├── HERENCIA-ERP-CLINICAS.md
|
||||
│ ├── HERENCIA-ERP-CORE.md
|
||||
│ └── HERENCIA-SIMCO.md
|
||||
├── inventarios/ # Inventarios del proyecto
|
||||
│ ├── BACKEND_INVENTORY.yml
|
||||
│ ├── DATABASE_INVENTORY.yml
|
||||
│ ├── FRONTEND_INVENTORY.yml
|
||||
│ └── MASTER_INVENTORY.yml
|
||||
├── trazas/ # Trazas de ejecucion
|
||||
│ ├── REPORTE-EJECUCION-SPRINT7-2026-01-07.md
|
||||
│ └── TRAZA-TAREAS-DATABASE.md
|
||||
├── _archive/ # Contenido archivado (no estandar)
|
||||
│ ├── _definitions/
|
||||
│ ├── _refs/
|
||||
│ ├── agents/
|
||||
│ ├── directivas/
|
||||
│ ├── environment/
|
||||
│ └── referencias/
|
||||
├── _inheritance.yml # Modelo de herencia
|
||||
├── _MAP.md # Este archivo
|
||||
├── BOOTLOADER.md # Arranque del proyecto
|
||||
├── CONTEXT-MAP.yml # Mapa de contexto NEXUS
|
||||
├── DEPENDENCY-GRAPH.yml # Grafo de dependencias
|
||||
├── MAPA-DOCUMENTACION.yml # Mapa de documentacion
|
||||
├── PROJECT-PROFILE.yml # Perfil del proyecto
|
||||
├── PROJECT-STATUS.md # Estado actual
|
||||
├── PROXIMA-ACCION.md # Siguiente accion
|
||||
└── TRACEABILITY.yml # Trazabilidad
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Archivos Obligatorios (10/10)
|
||||
|
||||
| # | Archivo | Estado |
|
||||
|---|---------|--------|
|
||||
| 1 | _inheritance.yml | OK |
|
||||
| 2 | _MAP.md | OK |
|
||||
| 3 | BOOTLOADER.md | OK |
|
||||
| 4 | CONTEXT-MAP.yml | OK |
|
||||
| 5 | DEPENDENCY-GRAPH.yml | OK |
|
||||
| 6 | MAPA-DOCUMENTACION.yml | OK |
|
||||
| 7 | PROJECT-PROFILE.yml | OK |
|
||||
| 8 | PROJECT-STATUS.md | OK |
|
||||
| 9 | PROXIMA-ACCION.md | OK |
|
||||
| 10 | TRACEABILITY.yml | OK |
|
||||
|
||||
---
|
||||
|
||||
## Carpetas Obligatorias (4/4)
|
||||
|
||||
| Carpeta | Estado | Contenido |
|
||||
|---------|--------|-----------|
|
||||
| 00-guidelines/ | OK | 4 archivos |
|
||||
| inventarios/ | OK | 4 archivos |
|
||||
| trazas/ | OK | 2 archivos |
|
||||
| _archive/ | OK | Contenido no estandar archivado |
|
||||
|
||||
---
|
||||
|
||||
## Navegacion
|
||||
|
||||
| Destino | Enlace |
|
||||
|---------|--------|
|
||||
| Documentacion | [../docs/_MAP.md](../docs/_MAP.md) |
|
||||
| Orchestration Central | [../../orchestration/_MAP.md](../../orchestration/_MAP.md) |
|
||||
| Directivas SIMCO | [../../orchestration/directivas/simco/_INDEX.md](../../orchestration/directivas/simco/_INDEX.md) |
|
||||
| Padre: erp-clinicas | [../../erp-clinicas/orchestration/_MAP.md](../../erp-clinicas/orchestration/_MAP.md) |
|
||||
| Orchestration Central | [../../../orchestration/_MAP.md](../../../orchestration/_MAP.md) |
|
||||
| Documentacion Proyecto | [../docs/_MAP.md](../docs/_MAP.md) |
|
||||
|
||||
---
|
||||
|
||||
## Archivos Principales
|
||||
## Nota sobre _archive/
|
||||
|
||||
| Archivo | Proposito |
|
||||
|---------|-----------|
|
||||
| CONTEXT-MAP.yml | Configuracion contexto |
|
||||
| CONTEXTO-PROYECTO.md | Descripcion proyecto |
|
||||
| PROJECT-STATUS.md | Estado actual |
|
||||
| PROXIMA-ACCION.md | Siguiente tarea |
|
||||
El contenido en `_archive/` fue movido durante la reestructuracion a SIMCO-ESTANDAR-ORCHESTRATION v1.0.0.
|
||||
Este contenido era duplicacion de directivas heredadas del workspace padre.
|
||||
Los proyectos SUB-CONSUMER heredan directivas automaticamente y no requieren copias locales.
|
||||
|
||||
**Contenido archivado:**
|
||||
- `_definitions/` - Checklists, protocolos, validaciones (heredar de workspace)
|
||||
- `_refs/` - Referencias (heredar de workspace)
|
||||
- `agents/` - Perfiles de agentes (heredar de erp-clinicas)
|
||||
- `directivas/` - Principios, SIMCO, triggers (heredar de workspace)
|
||||
- `environment/` - Inventario de ambiente (mover a inventarios/ si necesario)
|
||||
- `referencias/` - Dependencias ERP (mover a inventarios/ si necesario)
|
||||
|
||||
---
|
||||
|
||||
**Actualizado:** 2026-01-10
|
||||
**Reestructurado:** 2026-01-24 segun SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
|
||||
|
||||
@ -1,361 +1,361 @@
|
||||
# PRINCIPIO: NO ASUMIR
|
||||
|
||||
**Version:** 1.0.0
|
||||
**Fecha:** 2025-12-12
|
||||
**Tipo:** Principio Fundamental - HERENCIA OBLIGATORIA
|
||||
**Aplica a:** TODOS los agentes sin excepcion
|
||||
|
||||
---
|
||||
|
||||
## DECLARACION DEL PRINCIPIO
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════════════╗
|
||||
║ ║
|
||||
║ "Si no esta documentado, NO asumir. PREGUNTAR." ║
|
||||
║ ║
|
||||
║ Nunca implementar basado en suposiciones. ║
|
||||
║ Nunca inventar requisitos. ║
|
||||
║ Nunca tomar decisiones de negocio sin autorizacion. ║
|
||||
║ ║
|
||||
╚══════════════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## REGLA INQUEBRANTABLE
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────┐
|
||||
│ │
|
||||
│ PROHIBIDO: │
|
||||
│ - Asumir valores/comportamientos no documentados │
|
||||
│ - Inventar requisitos o especificaciones │
|
||||
│ - Tomar decisiones de negocio sin consultar │
|
||||
│ - Implementar "lo que parece logico" sin confirmacion │
|
||||
│ - Interpretar ambiguedad a favor de una opcion │
|
||||
│ - Completar huecos de documentacion con suposiciones │
|
||||
│ │
|
||||
│ OBLIGATORIO: │
|
||||
│ - Detener trabajo cuando falta informacion critica │
|
||||
│ - Documentar la pregunta claramente │
|
||||
│ - Escalar al Product Owner │
|
||||
│ - Esperar respuesta antes de continuar │
|
||||
│ - Documentar la decision antes de implementar │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## POR QUE ESTE PRINCIPIO
|
||||
|
||||
```yaml
|
||||
problema:
|
||||
- Implementaciones basadas en suposiciones causan retrabajo
|
||||
- Asunciones incorrectas generan bugs de negocio
|
||||
- Decisiones no autorizadas crean deuda tecnica
|
||||
- Interpretaciones personales divergen del objetivo real
|
||||
|
||||
consecuencias_de_asumir:
|
||||
- Codigo que no cumple requisitos reales
|
||||
- Retrabajo costoso cuando se descubre la asuncion incorrecta
|
||||
- Perdida de confianza del cliente/PO
|
||||
- Documentacion desalineada con implementacion
|
||||
- Bugs dificiles de rastrear (parecen funcionar pero no son correctos)
|
||||
|
||||
beneficios_de_preguntar:
|
||||
- Implementacion correcta desde el inicio
|
||||
- Documentacion completa y precisa
|
||||
- Menos retrabajo
|
||||
- Mayor confianza del equipo
|
||||
- Decisiones respaldadas por autoridad correcta
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CUANDO APLICA ESTE PRINCIPIO
|
||||
|
||||
### Casos que REQUIEREN Escalamiento
|
||||
|
||||
```yaml
|
||||
informacion_faltante:
|
||||
- Tabla mencionada sin definicion de columnas
|
||||
- Endpoint sin especificacion de payload
|
||||
- Pagina sin definicion de componentes
|
||||
- Regla de negocio incompleta
|
||||
- Valores de enum no especificados
|
||||
- Validaciones no documentadas
|
||||
- Comportamiento de error no definido
|
||||
- Limites/umbrales no especificados
|
||||
|
||||
ambiguedad:
|
||||
- Requisito interpretable de multiples formas
|
||||
- Contradiccion entre documentos
|
||||
- Alcance no claramente definido
|
||||
- Criterios de aceptacion vagos
|
||||
- Casos edge no cubiertos
|
||||
|
||||
decisiones_de_negocio:
|
||||
- Cambio que afecta UX
|
||||
- Modificacion de flujos existentes
|
||||
- Nuevas restricciones
|
||||
- Priorizacion entre alternativas
|
||||
- Trade-offs con impacto en usuario
|
||||
```
|
||||
|
||||
### Casos que NO Requieren Escalamiento
|
||||
|
||||
```yaml
|
||||
decisiones_tecnicas_puras:
|
||||
- Nombre de variable interna
|
||||
- Estructura de codigo (si no afecta API)
|
||||
- Optimizaciones de rendimiento
|
||||
- Refactorizaciones internas
|
||||
→ Consultar Architecture-Analyst si hay duda
|
||||
|
||||
implementacion_clara:
|
||||
- Documentacion existe y es clara
|
||||
- No hay ambiguedad
|
||||
- Comportamiento esta especificado
|
||||
→ Proceder con implementacion
|
||||
|
||||
estandares_definidos:
|
||||
- Nomenclatura definida en directivas
|
||||
- Patrones definidos en SIMCO
|
||||
- Convenciones del proyecto
|
||||
→ Seguir lo establecido
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## COMO APLICAR ESTE PRINCIPIO
|
||||
|
||||
### Paso 1: Buscar Exhaustivamente
|
||||
|
||||
```yaml
|
||||
ANTES_de_escalar:
|
||||
buscar_en:
|
||||
- docs/01-requerimientos/
|
||||
- docs/02-especificaciones-tecnicas/
|
||||
- docs/97-adr/
|
||||
- orchestration/inventarios/
|
||||
- Codigo existente relacionado
|
||||
- Historial de trazas
|
||||
|
||||
tiempo_minimo: "10-15 minutos de busqueda activa"
|
||||
```
|
||||
|
||||
### Paso 2: Si No se Encuentra, Documentar
|
||||
|
||||
```markdown
|
||||
## INFORMACION NO ENCONTRADA
|
||||
|
||||
**Busqueda realizada:**
|
||||
- [X] docs/01-requerimientos/ - No encontrado
|
||||
- [X] docs/02-especificaciones-tecnicas/ - Mencionado pero incompleto
|
||||
- [X] ADRs - No hay ADR relacionado
|
||||
- [X] Inventarios - N/A
|
||||
|
||||
**Conclusion:** Informacion no disponible, requiere escalamiento
|
||||
```
|
||||
|
||||
### Paso 3: Escalar Correctamente
|
||||
|
||||
```markdown
|
||||
## CONSULTA AL PRODUCT OWNER
|
||||
|
||||
**Fecha:** {fecha}
|
||||
**Agente:** {agente}
|
||||
**Tarea:** [{ID}] {titulo}
|
||||
|
||||
### Contexto
|
||||
{que estoy haciendo}
|
||||
|
||||
### Lo que encontre
|
||||
{informacion parcial disponible}
|
||||
|
||||
### Lo que falta / es ambiguo
|
||||
{descripcion clara del gap}
|
||||
|
||||
### Pregunta especifica
|
||||
{pregunta concreta}
|
||||
|
||||
### Opciones (si las identifique)
|
||||
1. {opcion A}
|
||||
2. {opcion B}
|
||||
|
||||
### Impacto
|
||||
{que pasa si no se resuelve}
|
||||
```
|
||||
|
||||
### Paso 4: Esperar y Documentar Respuesta
|
||||
|
||||
```yaml
|
||||
MIENTRAS_espero:
|
||||
- NO implementar esa parte
|
||||
- Continuar con otras tareas si es posible
|
||||
- Marcar tarea como BLOQUEADA si es critico
|
||||
|
||||
CUANDO_recibo_respuesta:
|
||||
- Documentar la decision
|
||||
- Actualizar documentacion correspondiente
|
||||
- Crear ADR si es decision significativa
|
||||
- Continuar implementacion
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## FLUJO DE DECISION
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ Encontrar informacion faltante │
|
||||
│ o ambiguedad │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────┐
|
||||
│ Buscar exhaustivamente en docs │
|
||||
│ (10-15 minutos minimo) │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌──────┴──────┐
|
||||
│ Encontrado? │
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌────────┴────────┐
|
||||
│ SI │ NO
|
||||
▼ ▼
|
||||
┌───────────┐ ┌─────────────────────┐
|
||||
│ Proceder │ │ DETENER │
|
||||
│ con │ │ Documentar pregunta │
|
||||
│ implement │ │ Escalar al PO │
|
||||
└───────────┘ └──────────┬──────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────┐
|
||||
│ ESPERAR respuesta │
|
||||
│ (NO asumir) │
|
||||
└──────────┬──────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────┐
|
||||
│ Documentar decision │
|
||||
│ Continuar │
|
||||
└─────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## EJEMPLOS
|
||||
|
||||
### Ejemplo CORRECTO
|
||||
|
||||
```yaml
|
||||
situacion: "DDL menciona campo 'status' pero no especifica valores"
|
||||
|
||||
proceso_correcto:
|
||||
1. Buscar en docs/: No encontrado
|
||||
2. Buscar en specs: Solo dice "tiene status"
|
||||
3. Buscar en ADRs: No hay ADR
|
||||
4. Conclusion: Escalar
|
||||
5. Documentar: "Cuales son los valores validos de status?"
|
||||
6. Esperar respuesta
|
||||
7. PO responde: "['draft', 'active', 'completed']"
|
||||
8. Documentar decision
|
||||
9. Implementar con valores correctos
|
||||
```
|
||||
|
||||
### Ejemplo INCORRECTO
|
||||
|
||||
```yaml
|
||||
situacion: "DDL menciona campo 'status' pero no especifica valores"
|
||||
|
||||
proceso_incorrecto:
|
||||
1. "Parece que deberian ser 'pending', 'done'"
|
||||
2. Implementar con esos valores
|
||||
3. PO revisa y dice: "No, son 'draft', 'active', 'completed'"
|
||||
4. Retrabajo: migration, seed update, tests, backend, frontend
|
||||
5. Tiempo perdido: 2-4 horas
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CONSECUENCIAS DE IGNORAR
|
||||
|
||||
```yaml
|
||||
ignorar_este_principio:
|
||||
retrabajo:
|
||||
- Implementacion incorrecta debe rehacerse
|
||||
- Tests basados en asuncion incorrecta
|
||||
- Documentacion desalineada
|
||||
|
||||
bugs_de_negocio:
|
||||
- Funcionalidad no cumple expectativas
|
||||
- Comportamiento inesperado para usuarios
|
||||
- Datos incorrectos en sistema
|
||||
|
||||
deuda_tecnica:
|
||||
- Codigo parche sobre asuncion incorrecta
|
||||
- Inconsistencias acumuladas
|
||||
- Complejidad innecesaria
|
||||
|
||||
perdida_de_confianza:
|
||||
- PO pierde confianza en implementaciones
|
||||
- Mas revision necesaria
|
||||
- Ciclos de feedback mas largos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CHECKLIST RAPIDO
|
||||
|
||||
```
|
||||
Antes de implementar algo no 100% claro:
|
||||
|
||||
[ ] Busque en documentacion? (10-15 min minimo)
|
||||
[ ] Revise specs, ADRs, inventarios?
|
||||
[ ] Sigue sin estar claro?
|
||||
[ ] Documente la pregunta?
|
||||
[ ] Escale al PO?
|
||||
[ ] Espere respuesta?
|
||||
[ ] Documente la decision?
|
||||
[ ] Actualice documentacion correspondiente?
|
||||
|
||||
Solo entonces: Proceder con implementacion
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## RELACION CON OTROS PRINCIPIOS
|
||||
|
||||
```yaml
|
||||
PRINCIPIO-DOC-PRIMERO:
|
||||
- Leer docs antes de implementar
|
||||
- Si docs estan incompletos -> NO-ASUMIR aplica
|
||||
|
||||
PRINCIPIO-CAPVED:
|
||||
- Fase A (Analisis): Identificar informacion faltante
|
||||
- Fase V (Validacion): NO aprobar sin informacion completa
|
||||
|
||||
PRINCIPIO-VALIDACION-OBLIGATORIA:
|
||||
- Validar que implementacion coincide con decision documentada
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## REFERENCIAS SIMCO
|
||||
|
||||
- **@ESCALAMIENTO** - Proceso completo de escalamiento
|
||||
- **@DOC_PRIMERO** - Consultar documentacion primero
|
||||
- **@TAREA** - Ciclo de vida de tareas
|
||||
|
||||
---
|
||||
|
||||
**Este principio es OBLIGATORIO y NO puede ser ignorado por ningun agente.**
|
||||
|
||||
---
|
||||
|
||||
**Version:** 1.0.0 | **Sistema:** SIMCO | **Tipo:** Principio Fundamental
|
||||
# PRINCIPIO: NO ASUMIR
|
||||
|
||||
**Version:** 1.0.0
|
||||
**Fecha:** 2025-12-12
|
||||
**Tipo:** Principio Fundamental - HERENCIA OBLIGATORIA
|
||||
**Aplica a:** TODOS los agentes sin excepcion
|
||||
|
||||
---
|
||||
|
||||
## DECLARACION DEL PRINCIPIO
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════════════╗
|
||||
║ ║
|
||||
║ "Si no esta documentado, NO asumir. PREGUNTAR." ║
|
||||
║ ║
|
||||
║ Nunca implementar basado en suposiciones. ║
|
||||
║ Nunca inventar requisitos. ║
|
||||
║ Nunca tomar decisiones de negocio sin autorizacion. ║
|
||||
║ ║
|
||||
╚══════════════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## REGLA INQUEBRANTABLE
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────┐
|
||||
│ │
|
||||
│ PROHIBIDO: │
|
||||
│ - Asumir valores/comportamientos no documentados │
|
||||
│ - Inventar requisitos o especificaciones │
|
||||
│ - Tomar decisiones de negocio sin consultar │
|
||||
│ - Implementar "lo que parece logico" sin confirmacion │
|
||||
│ - Interpretar ambiguedad a favor de una opcion │
|
||||
│ - Completar huecos de documentacion con suposiciones │
|
||||
│ │
|
||||
│ OBLIGATORIO: │
|
||||
│ - Detener trabajo cuando falta informacion critica │
|
||||
│ - Documentar la pregunta claramente │
|
||||
│ - Escalar al Product Owner │
|
||||
│ - Esperar respuesta antes de continuar │
|
||||
│ - Documentar la decision antes de implementar │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## POR QUE ESTE PRINCIPIO
|
||||
|
||||
```yaml
|
||||
problema:
|
||||
- Implementaciones basadas en suposiciones causan retrabajo
|
||||
- Asunciones incorrectas generan bugs de negocio
|
||||
- Decisiones no autorizadas crean deuda tecnica
|
||||
- Interpretaciones personales divergen del objetivo real
|
||||
|
||||
consecuencias_de_asumir:
|
||||
- Codigo que no cumple requisitos reales
|
||||
- Retrabajo costoso cuando se descubre la asuncion incorrecta
|
||||
- Perdida de confianza del cliente/PO
|
||||
- Documentacion desalineada con implementacion
|
||||
- Bugs dificiles de rastrear (parecen funcionar pero no son correctos)
|
||||
|
||||
beneficios_de_preguntar:
|
||||
- Implementacion correcta desde el inicio
|
||||
- Documentacion completa y precisa
|
||||
- Menos retrabajo
|
||||
- Mayor confianza del equipo
|
||||
- Decisiones respaldadas por autoridad correcta
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CUANDO APLICA ESTE PRINCIPIO
|
||||
|
||||
### Casos que REQUIEREN Escalamiento
|
||||
|
||||
```yaml
|
||||
informacion_faltante:
|
||||
- Tabla mencionada sin definicion de columnas
|
||||
- Endpoint sin especificacion de payload
|
||||
- Pagina sin definicion de componentes
|
||||
- Regla de negocio incompleta
|
||||
- Valores de enum no especificados
|
||||
- Validaciones no documentadas
|
||||
- Comportamiento de error no definido
|
||||
- Limites/umbrales no especificados
|
||||
|
||||
ambiguedad:
|
||||
- Requisito interpretable de multiples formas
|
||||
- Contradiccion entre documentos
|
||||
- Alcance no claramente definido
|
||||
- Criterios de aceptacion vagos
|
||||
- Casos edge no cubiertos
|
||||
|
||||
decisiones_de_negocio:
|
||||
- Cambio que afecta UX
|
||||
- Modificacion de flujos existentes
|
||||
- Nuevas restricciones
|
||||
- Priorizacion entre alternativas
|
||||
- Trade-offs con impacto en usuario
|
||||
```
|
||||
|
||||
### Casos que NO Requieren Escalamiento
|
||||
|
||||
```yaml
|
||||
decisiones_tecnicas_puras:
|
||||
- Nombre de variable interna
|
||||
- Estructura de codigo (si no afecta API)
|
||||
- Optimizaciones de rendimiento
|
||||
- Refactorizaciones internas
|
||||
→ Consultar Architecture-Analyst si hay duda
|
||||
|
||||
implementacion_clara:
|
||||
- Documentacion existe y es clara
|
||||
- No hay ambiguedad
|
||||
- Comportamiento esta especificado
|
||||
→ Proceder con implementacion
|
||||
|
||||
estandares_definidos:
|
||||
- Nomenclatura definida en directivas
|
||||
- Patrones definidos en SIMCO
|
||||
- Convenciones del proyecto
|
||||
→ Seguir lo establecido
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## COMO APLICAR ESTE PRINCIPIO
|
||||
|
||||
### Paso 1: Buscar Exhaustivamente
|
||||
|
||||
```yaml
|
||||
ANTES_de_escalar:
|
||||
buscar_en:
|
||||
- docs/01-requerimientos/
|
||||
- docs/02-especificaciones-tecnicas/
|
||||
- docs/97-adr/
|
||||
- orchestration/inventarios/
|
||||
- Codigo existente relacionado
|
||||
- Historial de trazas
|
||||
|
||||
tiempo_minimo: "10-15 minutos de busqueda activa"
|
||||
```
|
||||
|
||||
### Paso 2: Si No se Encuentra, Documentar
|
||||
|
||||
```markdown
|
||||
## INFORMACION NO ENCONTRADA
|
||||
|
||||
**Busqueda realizada:**
|
||||
- [X] docs/01-requerimientos/ - No encontrado
|
||||
- [X] docs/02-especificaciones-tecnicas/ - Mencionado pero incompleto
|
||||
- [X] ADRs - No hay ADR relacionado
|
||||
- [X] Inventarios - N/A
|
||||
|
||||
**Conclusion:** Informacion no disponible, requiere escalamiento
|
||||
```
|
||||
|
||||
### Paso 3: Escalar Correctamente
|
||||
|
||||
```markdown
|
||||
## CONSULTA AL PRODUCT OWNER
|
||||
|
||||
**Fecha:** {fecha}
|
||||
**Agente:** {agente}
|
||||
**Tarea:** [{ID}] {titulo}
|
||||
|
||||
### Contexto
|
||||
{que estoy haciendo}
|
||||
|
||||
### Lo que encontre
|
||||
{informacion parcial disponible}
|
||||
|
||||
### Lo que falta / es ambiguo
|
||||
{descripcion clara del gap}
|
||||
|
||||
### Pregunta especifica
|
||||
{pregunta concreta}
|
||||
|
||||
### Opciones (si las identifique)
|
||||
1. {opcion A}
|
||||
2. {opcion B}
|
||||
|
||||
### Impacto
|
||||
{que pasa si no se resuelve}
|
||||
```
|
||||
|
||||
### Paso 4: Esperar y Documentar Respuesta
|
||||
|
||||
```yaml
|
||||
MIENTRAS_espero:
|
||||
- NO implementar esa parte
|
||||
- Continuar con otras tareas si es posible
|
||||
- Marcar tarea como BLOQUEADA si es critico
|
||||
|
||||
CUANDO_recibo_respuesta:
|
||||
- Documentar la decision
|
||||
- Actualizar documentacion correspondiente
|
||||
- Crear ADR si es decision significativa
|
||||
- Continuar implementacion
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## FLUJO DE DECISION
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────┐
|
||||
│ Encontrar informacion faltante │
|
||||
│ o ambiguedad │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────┐
|
||||
│ Buscar exhaustivamente en docs │
|
||||
│ (10-15 minutos minimo) │
|
||||
└──────────────┬──────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌──────┴──────┐
|
||||
│ Encontrado? │
|
||||
└──────┬──────┘
|
||||
│
|
||||
┌────────┴────────┐
|
||||
│ SI │ NO
|
||||
▼ ▼
|
||||
┌───────────┐ ┌─────────────────────┐
|
||||
│ Proceder │ │ DETENER │
|
||||
│ con │ │ Documentar pregunta │
|
||||
│ implement │ │ Escalar al PO │
|
||||
└───────────┘ └──────────┬──────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────┐
|
||||
│ ESPERAR respuesta │
|
||||
│ (NO asumir) │
|
||||
└──────────┬──────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────┐
|
||||
│ Documentar decision │
|
||||
│ Continuar │
|
||||
└─────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## EJEMPLOS
|
||||
|
||||
### Ejemplo CORRECTO
|
||||
|
||||
```yaml
|
||||
situacion: "DDL menciona campo 'status' pero no especifica valores"
|
||||
|
||||
proceso_correcto:
|
||||
1. Buscar en docs/: No encontrado
|
||||
2. Buscar en specs: Solo dice "tiene status"
|
||||
3. Buscar en ADRs: No hay ADR
|
||||
4. Conclusion: Escalar
|
||||
5. Documentar: "Cuales son los valores validos de status?"
|
||||
6. Esperar respuesta
|
||||
7. PO responde: "['draft', 'active', 'completed']"
|
||||
8. Documentar decision
|
||||
9. Implementar con valores correctos
|
||||
```
|
||||
|
||||
### Ejemplo INCORRECTO
|
||||
|
||||
```yaml
|
||||
situacion: "DDL menciona campo 'status' pero no especifica valores"
|
||||
|
||||
proceso_incorrecto:
|
||||
1. "Parece que deberian ser 'pending', 'done'"
|
||||
2. Implementar con esos valores
|
||||
3. PO revisa y dice: "No, son 'draft', 'active', 'completed'"
|
||||
4. Retrabajo: migration, seed update, tests, backend, frontend
|
||||
5. Tiempo perdido: 2-4 horas
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CONSECUENCIAS DE IGNORAR
|
||||
|
||||
```yaml
|
||||
ignorar_este_principio:
|
||||
retrabajo:
|
||||
- Implementacion incorrecta debe rehacerse
|
||||
- Tests basados en asuncion incorrecta
|
||||
- Documentacion desalineada
|
||||
|
||||
bugs_de_negocio:
|
||||
- Funcionalidad no cumple expectativas
|
||||
- Comportamiento inesperado para usuarios
|
||||
- Datos incorrectos en sistema
|
||||
|
||||
deuda_tecnica:
|
||||
- Codigo parche sobre asuncion incorrecta
|
||||
- Inconsistencias acumuladas
|
||||
- Complejidad innecesaria
|
||||
|
||||
perdida_de_confianza:
|
||||
- PO pierde confianza en implementaciones
|
||||
- Mas revision necesaria
|
||||
- Ciclos de feedback mas largos
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CHECKLIST RAPIDO
|
||||
|
||||
```
|
||||
Antes de implementar algo no 100% claro:
|
||||
|
||||
[ ] Busque en documentacion? (10-15 min minimo)
|
||||
[ ] Revise specs, ADRs, inventarios?
|
||||
[ ] Sigue sin estar claro?
|
||||
[ ] Documente la pregunta?
|
||||
[ ] Escale al PO?
|
||||
[ ] Espere respuesta?
|
||||
[ ] Documente la decision?
|
||||
[ ] Actualice documentacion correspondiente?
|
||||
|
||||
Solo entonces: Proceder con implementacion
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## RELACION CON OTROS PRINCIPIOS
|
||||
|
||||
```yaml
|
||||
PRINCIPIO-DOC-PRIMERO:
|
||||
- Leer docs antes de implementar
|
||||
- Si docs estan incompletos -> NO-ASUMIR aplica
|
||||
|
||||
PRINCIPIO-CAPVED:
|
||||
- Fase A (Analisis): Identificar informacion faltante
|
||||
- Fase V (Validacion): NO aprobar sin informacion completa
|
||||
|
||||
PRINCIPIO-VALIDACION-OBLIGATORIA:
|
||||
- Validar que implementacion coincide con decision documentada
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## REFERENCIAS SIMCO
|
||||
|
||||
- **@ESCALAMIENTO** - Proceso completo de escalamiento
|
||||
- **@DOC_PRIMERO** - Consultar documentacion primero
|
||||
- **@TAREA** - Ciclo de vida de tareas
|
||||
|
||||
---
|
||||
|
||||
**Este principio es OBLIGATORIO y NO puede ser ignorado por ningun agente.**
|
||||
|
||||
---
|
||||
|
||||
**Version:** 1.0.0 | **Sistema:** SIMCO | **Tipo:** Principio Fundamental
|
||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user