Skip to content

Commit fad59ec

Browse files
committed
feat(ai): implementar estrategia IA basada en DORA Report 2025
Implementacion completa de AI Excellence basada en DORA Report 2025 - AI Capabilities Model. ESTRATEGIA_IA.md (500+ lineas): - Implementacion de 7 practicas DORA AI Capabilities - Score actual: 5/7 (71%), target Q1 2026: 7/7 (100%) - AI stance del proyecto (cuando usar/no usar IA) - 3 Platform Imperatives, 3 Leadership Principles - Roadmap Q4 2025 - Q2 2026 para AI Excellence - Metricas: Adoption (90%), Productivity (70%), DORA classics AI_CAPABILITIES.md (300+ lineas): - Checklist diario para Developers - Checklist semanal para Tech Leads - Checklist mensual para Arquitectos - Checklist por feature para QA - Metricas rapidas y red flags 7 Practicas DORA implementadas: 1. User-centric Focus - Templates, vision, trazabilidad (OK) 2. Strong Version Control - Git, CODEOWNERS, CI/CD (OK) 3. AI-accessible Data - Docs OK, metrics pendientes (80%) 4. Small Batches - Metodologia establecida (OK) 5. AI Stance - ESTRATEGIA_IA.md (OK) 6. Quality Platform - Django + 8 workflows + 13 scripts (OK) 7. Data Ecosystems - PostgreSQL+MySQL OK, metrics pendientes (80%) ROADMAP.md: - EPICA-006: AI Excellence (60 SP, 70% completado) - Hito 4: AI Excellence DORA Compliant (2026-03-31) TAREAS_ACTIVAS.md: - [x] ESTRATEGIA_IA.md (5 SP) - [x] AI_CAPABILITIES.md (2 SP) - [ ] Comunicar AI stance al equipo (1 SP, P1) - [ ] Agregar AI guidelines a onboarding (2 SP, P2) INDICE.md v1.3.0 -> v1.4.0: - 118 -> 120 archivos (+2) - ~35,000 -> ~35,800 lineas (+800) - Nueva seccion 1.4: IA y Excelencia con IA (DORA 2025) - Estructura: BABOK v3 + PMBOK 7 + ISO/IEC/IEEE 29148:2018 + DORA 2025 CHANGELOG.md: - Version 1.4.0 documentada - 7 SP completados en esta version - Impacto: Estrategia IA formal con guidelines claras Fuente: DORA Report 2025 - AI Capabilities Model https://dora.dev/dora-report-2025 Story Points: 7 SP
1 parent 41e3d8e commit fad59ec

6 files changed

Lines changed: 1066 additions & 15 deletions

File tree

docs/INDICE.md

Lines changed: 48 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,24 +2,24 @@
22
id: DOC-INDICE-GENERAL
33
tipo: indice
44
categoria: documentacion
5-
version: 1.3.0
5+
version: 1.4.0
66
fecha_creacion: 2025-11-06
77
fecha_migracion: 2025-11-06
88
fecha_actualizacion: 2025-11-06
99
propietario: equipo-gobernanza
10-
archivos_totales: 118
11-
lineas_totales: 35000
12-
relacionados: ["docs_legacy/README.md", "gobernanza/procesos/MAPEO_PROCESOS_TEMPLATES.md", ".claude/workflow_template_mapping.json"]
10+
archivos_totales: 120
11+
lineas_totales: 35800
12+
relacionados: ["docs_legacy/README.md", "gobernanza/procesos/MAPEO_PROCESOS_TEMPLATES.md", ".claude/workflow_template_mapping.json", "gobernanza/ai/ESTRATEGIA_IA.md"]
1313
---
1414

1515
# INDICE GENERAL - Documentacion IACT
1616

17-
**VERSION:** 1.3.0
17+
**VERSION:** 1.4.0
1818
**FECHA MIGRACION:** 2025-11-06
1919
**FECHA ACTUALIZACION:** 2025-11-06
20-
**ARCHIVOS MIGRADOS:** 118
21-
**LINEAS MIGRADAS:** ~35,000
22-
**ESTRUCTURA:** BABOK v3 + PMBOK 7 + ISO/IEC/IEEE 29148:2018
20+
**ARCHIVOS MIGRADOS:** 120
21+
**LINEAS MIGRADAS:** ~35,800
22+
**ESTRUCTURA:** BABOK v3 + PMBOK 7 + ISO/IEC/IEEE 29148:2018 + DORA 2025
2323

2424
---
2525

@@ -33,13 +33,13 @@ Este indice documenta la estructura completa de documentacion del proyecto IACT
3333

3434
| Seccion | Descripcion | Archivos |
3535
|---------|-------------|----------|
36-
| [1. Gobernanza](#1-gobernanza) | Estilos, procesos, procedimientos, lineamientos, mapeos | 35 |
37-
| [2. Requisitos](#2-requisitos) | Analisis de negocio, Business Needs | 8 |
38-
| [3. Implementacion](#3-implementacion) | Infrastructure, agentes, runbooks | 13 |
39-
| [4. Plantillas](#4-plantillas) | Templates reutilizables | 34 |
40-
| [5. Vision y Alcance](#5-vision-y-alcance) | Glossary, vision del proyecto | 2 |
36+
| [1. Gobernanza](#1-gobernanza) | Estilos, procesos, procedimientos, lineamientos, mapeos, AI | 37 |
37+
| [2. Proyecto](#2-proyecto) | Vision, tracking, planificacion, roadmap | 5 |
38+
| [3. Requisitos](#3-requisitos) | Analisis de negocio, Business Needs | 8 |
39+
| [4. Implementacion](#4-implementacion) | Infrastructure, agentes, runbooks | 13 |
40+
| [5. Plantillas](#5-plantillas) | Templates reutilizables | 34 |
4141

42-
**Total:** 92 archivos de documentacion
42+
**Total:** 97 archivos de documentacion
4343

4444
---
4545

@@ -247,6 +247,40 @@ Historico de ejecuciones de pytest y validaciones QA.
247247

248248
---
249249

250+
### 1.4 IA y Excelencia con IA (DORA 2025)
251+
252+
**Ubicacion:** `docs/gobernanza/ai/`
253+
254+
**Fuente:** [DORA Report 2025 - AI Capabilities Model](https://dora.dev/dora-report-2025)
255+
256+
| Archivo | Descripcion | Prioridad |
257+
|---------|-------------|-----------|
258+
| [ESTRATEGIA_IA.md](gobernanza/ai/ESTRATEGIA_IA.md) | Estrategia completa de IA basada en DORA 2025 - 7 practicas AI Capabilities, AI stance del proyecto, roadmap Q4 2025-Q2 2026 | CRITICA |
259+
| [AI_CAPABILITIES.md](gobernanza/ai/AI_CAPABILITIES.md) | Checklist diario de 7 practicas DORA - Para Developers (diario), Tech Leads (semanal), Arquitectos (mensual), QA (por feature) | ALTA |
260+
261+
**Practicas DORA AI Capabilities (7):**
262+
1. **User-centric Focus** - Templates, vision, trazabilidad (Implementado)
263+
2. **Strong Version Control** - Git, CODEOWNERS, CI/CD (Implementado)
264+
3. **AI-accessible Internal Data** - Docs OK, metrics pendientes (Parcial)
265+
4. **Working in Small Batches** - Metodologia por lotes (Implementado)
266+
5. **Clear + Communicated AI Stance** - ESTRATEGIA_IA.md (Implementado)
267+
6. **Quality Internal Platform** - Django + 8 workflows + 13 scripts (Implementado)
268+
7. **Healthy Data Ecosystems** - PostgreSQL+MySQL OK, metrics pendientes (Parcial)
269+
270+
**Score actual:** 5/7 (71%) | **Target Q1 2026:** 7/7 (100%)
271+
272+
**Uso:**
273+
- **ESTRATEGIA_IA.md**: Consultar al inicio de proyecto y mensualmente
274+
- **AI_CAPABILITIES.md**: Checklist diario para developers, semanal para tech leads
275+
- **AI stance**: Define cuando usar/no usar IA en el proyecto
276+
277+
**Ver tambien:**
278+
- [ROADMAP.md](proyecto/ROADMAP.md) - EPICA-006: AI Excellence
279+
- [TAREAS_ACTIVAS.md](proyecto/TAREAS_ACTIVAS.md) - Tareas AI pendientes
280+
- [AGENTES_SDLC.md](gobernanza/procesos/AGENTES_SDLC.md) - Agentes IA implementados
281+
282+
---
283+
250284
## 2. Proyecto
251285

252286
Documentacion de vision, alcance y planificacion del proyecto.
Lines changed: 290 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,290 @@
1+
---
2+
id: DOC-GOBERNANZA-AI-CAPABILITIES
3+
tipo: checklist
4+
categoria: ai
5+
version: 1.0.0
6+
fecha_creacion: 2025-11-06
7+
propietario: arquitecto-senior
8+
fuente: DORA Report 2025
9+
relacionados: ["ESTRATEGIA_IA.md"]
10+
---
11+
12+
# AI Capabilities Checklist - DORA 2025
13+
14+
Checklist diario de las 7 practicas clave del DORA AI Capabilities Model.
15+
16+
**Version:** 1.0.0
17+
**Fuente:** [DORA Report 2025](https://dora.dev/dora-report-2025)
18+
19+
---
20+
21+
## Para Developers - Checklist Diario
22+
23+
### Antes de Usar IA
24+
25+
- [ ] **Tengo clara la necesidad del usuario?** (Practica 1: User-centric Focus)
26+
- Consulte: `docs/proyecto/vision_y_alcance.md`
27+
- Template: `docs/plantillas/template_necesidad.md`
28+
29+
- [ ] **Mi branch esta actualizado?** (Practica 2: Version Control)
30+
- `git pull origin main`
31+
- Feature branch desde main
32+
33+
- [ ] **Tengo acceso a documentacion relevante?** (Practica 3: AI-accessible Data)
34+
- Consulte: `docs/INDICE.md`
35+
- Query tool: `python scripts/generate_workflow_from_template.py --interactive`
36+
37+
### Al Usar IA
38+
39+
- [ ] **Estoy trabajando en lote pequeno?** (Practica 4: Small Batches)
40+
- Task <= 13 story points
41+
- PR <= 300 lineas
42+
- Commit cada feature pequena
43+
44+
- [ ] **Uso IA segun stance del proyecto?** (Practica 5: AI Stance)
45+
- SI: Boilerplate, docs, code review, refactoring, tests
46+
- NO: Decisiones arquitectonicas criticas, security final, merge sin review
47+
- Ver: `docs/gobernanza/ai/ESTRATEGIA_IA.md` seccion "Stance de IA"
48+
49+
### Despues de Usar IA
50+
51+
- [ ] **Valide el codigo generado por IA?** (Practica 3: Effective Use)
52+
- Revise linea por linea
53+
- Valide contra restricciones (RNF-002: NO Redis, NO Email)
54+
- Tests escritos o actualizados
55+
56+
- [ ] **Ejecute validaciones locales?** (Practica 6: Quality Platform)
57+
- `./scripts/run_all_tests.sh`
58+
- `./scripts/validate_critical_restrictions.sh`
59+
- Pre-commit hooks (si instalados)
60+
61+
- [ ] **Documentacion actualizada?** (Practica 7: Data Ecosystems)
62+
- README actualizado si necesario
63+
- Docstrings agregados
64+
- CHANGELOG.md actualizado si feature mayor
65+
66+
---
67+
68+
## Para Tech Leads - Checklist Semanal
69+
70+
### Lunes (Planning)
71+
72+
- [ ] **Sprint planning con sistemas view** (Consejo 1: Systems View)
73+
- Consulte: `docs/proyecto/TAREAS_ACTIVAS.md`
74+
- Consulte: `docs/gobernanza/procesos/MAPEO_PROCESOS_TEMPLATES.md`
75+
- Priorice tareas P0-P1
76+
77+
- [ ] **Validar que equipo sigue AI stance** (Practica 5)
78+
- Review de PRs de semana anterior
79+
- AI usage apropiado?
80+
81+
### Miercoles (Mid-sprint)
82+
83+
- [ ] **Platform health check** (Practica 6: Quality Platform)
84+
- `./scripts/health_check.sh`
85+
- Session table < 50K rows? (`./scripts/cleanup_sessions.sh --dry-run`)
86+
87+
- [ ] **Data ecosystems saludables?** (Practica 7)
88+
- Backups recientes?
89+
- Logs no desbordados?
90+
91+
### Viernes (Review)
92+
93+
- [ ] **Metricas DORA actualizadas?**
94+
- `python scripts/dora_metrics.py --days 7`
95+
- Deployment frequency mejorando?
96+
- Lead time reduciendo?
97+
98+
- [ ] **Retrospective con lecciones IA**
99+
- Que funciono bien con IA esta semana?
100+
- Que no funciono?
101+
- Ajustar AI stance si necesario
102+
103+
---
104+
105+
## Para Arquitectos - Checklist Mensual
106+
107+
### Foundation Systems (Consejo 2)
108+
109+
- [ ] **Platform investment review**
110+
- Django platform estable?
111+
- Database performance OK?
112+
- CI/CD workflows funcionando?
113+
114+
- [ ] **AI infrastructure review**
115+
- 7 agentes SDLC operativos?
116+
- Scripts de automatizacion funcionando?
117+
- Documentacion actualizada?
118+
119+
### AI Capabilities Assessment
120+
121+
- [ ] **Score de 7 practicas actualizado**
122+
- Practica 1 (User-centric): [ ] OK / [ ] Needs work
123+
- Practica 2 (Version Control): [ ] OK / [ ] Needs work
124+
- Practica 3 (AI-accessible Data): [ ] OK / [ ] Needs work
125+
- Practica 4 (Small Batches): [ ] OK / [ ] Needs work
126+
- Practica 5 (AI Stance): [ ] OK / [ ] Needs work
127+
- Practica 6 (Quality Platform): [ ] OK / [ ] Needs work
128+
- Practica 7 (Data Ecosystems): [ ] OK / [ ] Needs work
129+
130+
- [ ] **Score actual: ___/7 (target: 7/7)**
131+
132+
### Risk Calibration (Imperativo 3)
133+
134+
- [ ] **Risk appetite revisado**
135+
- Incidents este mes: ___
136+
- Caused by AI misuse: ___
137+
- Security issues: ___
138+
- Restricciones violadas: ___ (debe ser 0)
139+
140+
- [ ] **Ajustes necesarios?**
141+
- Actualizar AI stance?
142+
- Agregar validaciones?
143+
- Training adicional?
144+
145+
---
146+
147+
## Para QA - Checklist por Feature
148+
149+
### Pre-Testing
150+
151+
- [ ] **Feature sigue user-centric focus?** (Practica 1)
152+
- User story clara?
153+
- Acceptance criteria definidos?
154+
155+
- [ ] **AI-generated code revisado?**
156+
- Developer hizo code review?
157+
- Tests incluidos?
158+
159+
### During Testing
160+
161+
- [ ] **Tests automatizados ejecutados?** (Practica 6)
162+
- `./scripts/run_all_tests.sh`
163+
- Coverage >= 80%?
164+
- Security scan passed?
165+
166+
- [ ] **Platform health OK?**
167+
- `./scripts/health_check.sh`
168+
- Todos los checks verdes?
169+
170+
### Post-Testing
171+
172+
- [ ] **Documentacion de tests actualizada?** (Practica 7)
173+
- Test results en `docs/testing/registros/`
174+
- Issues identificados documentados
175+
176+
- [ ] **Restricciones validadas?**
177+
- `./scripts/validate_critical_restrictions.sh`
178+
- RNF-002: NO Redis? ✓
179+
- NO Email? ✓
180+
181+
---
182+
183+
## Metricas Rapidas
184+
185+
### Adoption (Target: 90%)
186+
187+
**Pregunta:** Cuantos en el equipo usan IA diariamente?
188+
189+
- Team size: ___
190+
- Using AI daily: ___
191+
- Adoption rate: ___% (target: >= 90%)
192+
193+
### Productivity (Target: 70%)
194+
195+
**Pregunta:** Cuantos perciben aumento de productividad con IA?
196+
197+
- Team size: ___
198+
- Perceive increase: ___
199+
- Rate: ___% (target: >= 70%)
200+
201+
### Code Quality
202+
203+
**Metricas:**
204+
- Coverage: ___% (target: >= 80%)
205+
- Security critical issues: ___ (target: 0)
206+
- Lint errors: ___ (target: 0)
207+
208+
### DORA Metrics
209+
210+
**Deployment Frequency:**
211+
- Ultimo mes: ___ deploys
212+
- Frequency: ___ per week
213+
- Target Q4 2025: >= 1/week
214+
215+
**Lead Time:**
216+
- Promedio commits: ___ dias
217+
- Target Q4 2025: < 7 dias
218+
219+
**Change Failure Rate:**
220+
- Total changes: ___
221+
- Failed: ___
222+
- Rate: ___% (target: < 20%)
223+
224+
**MTTR:**
225+
- Incidents: ___
226+
- Average recovery: ___ horas
227+
- Target Q4 2025: < 24 horas
228+
229+
---
230+
231+
## Red Flags - Cuando Algo Esta Mal
232+
233+
### AI Misuse Indicators
234+
235+
- [ ] **Pull requests > 500 lineas** - No small batches
236+
- [ ] **AI-generated code sin review** - Missing validation
237+
- [ ] **Restricciones violadas** (Redis, Email) - Critical failure
238+
- [ ] **Tests < 80% coverage** - Quality issue
239+
- [ ] **Security scan failures** - Security risk
240+
- [ ] **Commit sin conventional format** - Version control issue
241+
- [ ] **Documentacion desactualizada** - Data ecosystem problem
242+
243+
**Accion:** Si cualquier red flag: STOP, revisar ESTRATEGIA_IA.md, corregir
244+
245+
---
246+
247+
## Quick Commands
248+
249+
```bash
250+
# Baseline DORA metrics
251+
python scripts/dora_metrics.py --days 30 --format markdown > DORA_baseline.md
252+
253+
# Health check
254+
./scripts/health_check.sh
255+
256+
# Run all tests
257+
./scripts/run_all_tests.sh
258+
259+
# Validate restrictions
260+
./scripts/validate_critical_restrictions.sh
261+
262+
# Query AI-accessible data
263+
python scripts/generate_workflow_from_template.py --interactive
264+
265+
# Session cleanup
266+
./scripts/cleanup_sessions.sh --dry-run
267+
```
268+
269+
---
270+
271+
## Referencias
272+
273+
- **ESTRATEGIA_IA.md**: Estrategia completa
274+
- **ROADMAP.md**: Roadmap de mejoras IA
275+
- **TAREAS_ACTIVAS.md**: Tareas IA en progreso
276+
- **AGENTES_SDLC.md**: Documentacion de agentes
277+
278+
---
279+
280+
## Actualizacion
281+
282+
Este checklist se actualiza cuando:
283+
- AI stance cambia
284+
- Nuevas herramientas IA se adoptan
285+
- Metricas DORA cambian significativamente
286+
- Team size cambia
287+
288+
**Ultima actualizacion:** 2025-11-06
289+
**Version:** 1.0.0
290+
**Mantenedor:** @arquitecto-senior

0 commit comments

Comments
 (0)