Curso 10 · Unidad 6

Documento de diseño y defensa

4 hrs · Design doc · revisión · decisión — UAI

Tesis

El design doc es el contrato del sistema

Escribe para un tercero que debe poder construir y auditar.
Cada claim de valor lleva métrica, línea base y umbral.
La defensa oral no inventa: solo aclara trade-offs ya escritos.
Si no cabe en el doc, no está diseñado.

Al finalizar

Resultados de aprendizaje

Redactar un design doc completo y revisable.
Exponer riesgos, mitigaciones y plan de evaluación.
Defender decisiones de arquitectura ante revisión crítica.

Bloque 1 · 60 min

Estructura

Teoría

El design doc como contrato

Huyen (2022): producción exige especificación revisable — no slides sueltas.
Amershi et al. (2019): workflows SE+ML; el doc fija datos, modelos y fronteras.
Cada claim de valor lleva métrica, línea base y umbral (viz claim-evidence).

Plantilla

Secciones no negociables

Contexto y decisión organizacional.
Requisitos (funcionales + NFR medibles).
Arquitectura y fronteras de confianza.
Datos, evaluación, operación y riesgos.

Definiciones

Léxico del design doc

Design doc — especificación revisable del sistema: contexto, NFR, arquitectura, datos, eval y riesgos.
Claim con evidencia — afirmación de valor con métrica, línea base y umbral; sin eso es riesgo.
Revisión adversaria — leer el doc buscando ambigüedad, Goodhart y rollback ausente.
Listo para construir — criterio explícito de que un tercero puede implementar y auditar.

Contrato

Secciones que no se omiten

La defensa oral solo aclara lo ya escrito — no inventa.

Bloque 2 · 60 min

Evidencia

Claims

Afirmar con prueba

Sin métrica / umbral, el claim es riesgo — no diseño.

Evidencia

Qué contar en el doc

Línea base vs propuesta: delta esperado.
Experimentos / canarias / sets de dominio.
Lo que no se midió queda como riesgo explícito.

Bloque 3 · 60 min

Revisión

Peer review

Leer como adversario

Buscar ambigüedad, métricas Goodhart y rollback ausente.
Marcar supuestos no validados.
Checklist de superficie de riesgo (Unidad 5).

Make/buy

Trade-offs que deben estar escritos

La defensa solo aclara lo ya justificado en el design doc.

Bloque 4 · 60 min

Defensa

Oral

Defensa en 10 minutos

Problema → diseño → evidencia → riesgos → pregunta abierta.
Caso Chile/LATAM en el doc (minería, banca, SII o retail) — mismo template.
Criterio de “listo para construir”; no demos: trade-offs.
Entregable: DESIGN.md versionado + defensa 10 min (capstone).

Capstone

Puente 08 → 11

Lab: labs/capstone/ — README + plantilla DESIGN.md (make/buy, prompt/agente, design doc, operación).

Un problema, un repo, una defensa: no demos sueltos por unidad.

Lecturas

Para profundizar

Huyen (2022) — huyen2022designing (caps. design / production)
Amershi et al. (2019) — amershi2019se4ml

Cierre

Preguntas

Cierre del curso 10 · puente a AI.Ops (curso 11)