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