Entregables del proyecto
Las plantillas siguen la práctica francesa de proyectos de integración (DAT, DEX, ficha MEP, PV de receta) con encabezados en inglés y el nombre francés entre paréntesis. Son esqueletos: encabezados, tablas y breves guías en cursiva (_..._) que deben reemplazarse o eliminarse.
Cuándo usar cada plantilla
| Necesidad | Plantilla | Agente líder típico | Contribuyentes | Fase |
|---|---|---|---|---|
| Describir la solución técnica objetivo y justificar las elecciones | dat.md | enterprise-architect | infra, dba, devsecops, integración, erp, ibmi | Diseño, actualizado hasta la puesta en producción |
| Transferir un sistema a explotación | dex.md | infra-expert | planificación, dba, integración, ibmi, erp | Construcción → antes de la puesta en producción |
| Planificar y ejecutar un despliegue en producción | release-sheet.md | project-manager | todos los agentes técnicos involucrados | Cada liberación |
| Especificar una interfaz entre dos sistemas | interface-contract.md | integration-expert | erp, ibmi, dba, devsecops | Diseño, versionado por cambio |
| Solicitar y documentar flujos de red | flow-matrix.md | infra-expert | devsecops, integración | Diseño → solicitudes de cortafuegos |
| Aclarar quién hace qué | raci.md | project-manager | todos | Encuadre, revisado por fase |
| Rastrear riesgos, supuestos, problemas, dependencias | raid.md | project-manager | todos | Todo el proyecto, revisado semanalmente |
| Registrar la aceptación de una entrega | uat-signoff.md | project-manager | propietario del negocio, testers | Fin de cada campaña de aceptación |
| Registrar los hechos del entorno de la organización una vez, para que los lea cada experto | environment-sheet.md | project-manager (vía /tiger-team:discover) | todos | Inicio del compromiso, mantenido actualizado |
Cómo instanciar una plantilla
- Lea la plantilla en su ruta completa (índice más abajo).
- Escriba la instancia en el proyecto del usuario (pregunte dónde si no existe una convención), p. ej.,
docs/<entregable>/<ID>-<nombre-corto>.md; nunca modifique la plantilla original. - Rellene todos los
<marcadores>; deje un marcadorTBD (propietario, fecha)para cualquier cosa desconocida en lugar de inventarlo. - Elimine las líneas de guía en cursiva una vez que una sección esté completa; elimine las secciones opcionales que no apliquen, indicando "N/A: <razón>" donde un auditor las esperaría.
- Verifique la coherencia con otros entregables relacionados (mismos IDs, versiones, nombres de host, propietarios).
Reglas de redacción (todos los entregables)
- Control de documentos primero: bloque de identificación, tabla de versiones (versión, fecha, autor, cambios), revisores y aprobadores con fechas. Versiones:
0.xborradores,1.0primera aprobada,1.xactualizaciones menores,2.0cambio estructural. Estado: Borrador / En revisión / Aprobado / Obsoleto. - Audiencia: indíquela al principio (arquitectos, operadores, negocio, auditores, comité de homologación) y redacte para ella: los operadores necesitan comandos y umbrales, los patrocinadores necesitan decisiones y riesgos.
- Trazabilidad: enlace cada elemento de diseño, caso de prueba y reserva a IDs de requisito, ADRs, tickets o elementos RAID. Use IDs estables entre entregables — elementos:
REQ-,ADR-(cuatro dígitos,ADR-0001),INT-(interfaces),FLW-(flujos),JOB-,MON-(chequeos de monitorización),KE-(errores conocidos),RSK-,ASM-,ISS-,DEP-,TC-,DEF-,RES-(reservas),PRE-/GNG-/RB-(prerrequisitos de liberación, puntos de control go/no-go, pasos de reversión); documentos:DAT-,DEX-,FLM-(matriz de flujos),REL-(liberación),PVR-(PV de receta),RACI-,RAID-. - Sin datos reales: nombres de host ficticios, rangos IP de documentación (RFC 5737), marcadores de posición para secretos, ejemplos sintéticos, nombres de roles genéricos en lugar de datos de contacto personales. Aplique las reglas de confidencialidad de la habilidad
sector-compliance; un entregable que describa un sistema clasificado o de Difusión Restringida se escribe dentro del entorno protegido, no aquí. - Etiqueta de clasificación: ponga la etiqueta de sensibilidad del documento de la organización en el encabezado (p. ej., Interno, Confidencial); los entregables que describen seguridad de producción (matriz de flujos, secciones de seguridad del DAT) suelen ser al menos Confidencial.
- Precisión: fechas en ISO 8601 (
2026-10-22), horas con zona horaria (21:30 Europe/Paris), volúmenes con unidades y período (120 000 msg/día, pico 40 msg/s), duraciones explícitas (RTO 4 h). - Fuente única de verdad: referencie otros entregables en lugar de copiarlos (el DAT enlaza los contratos de interfaz y la matriz de flujos; el DEX enlaza el DAT).
- Decisiones y evidencias: registre quién decidió qué y cuándo; los entregables son evidencia de auditoría (DORA, ACPR, PCI DSS, HDS, homologación).
- Idioma: encabezados en inglés; mantenga los términos franceses entre paréntesis cuando sean el nombre contractual o reglamentario (MEP, PV de receta, réserves).
- Cada documento rellenado debe mantenerse revisable: tablas sobre prosa, un hecho por fila, sin lenguaje de marketing.
Índice de plantillas
templates/dat.md— Documento de Arquitectura Técnica (Dossier d'Architecture Technique) — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dat.mdtemplates/dex.md— Manual de Explotación (Dossier d'Exploitation): run book, monitorización, batch, copias de seguridad, reinicio, contactos, escalado — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/dex.mdtemplates/release-sheet.md— Ficha de puesta en producción (Fiche de mise en production, fiche MEP): hoja de ejecución temporizada, propietarios, go/no-go, reversión — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/release-sheet.mdtemplates/interface-contract.md— Contrato de interfaz (Contrat d'interface): partes, desencadenante, transporte, formato, mapeo, volumetría, SLAs, errores y reprocesamiento, seguridad, monitorización, pruebas — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/interface-contract.mdtemplates/flow-matrix.md— Matriz de flujos de red (Matrice des flux) con lista de verificación de revisión — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/flow-matrix.mdtemplates/raci.md— Matriz RACI (Matrice RACI) — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raci.mdtemplates/raid.md— Registro RAID (Registre des risques, hypothèses, problèmes et dépendances) — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/raid.mdtemplates/uat-signoff.md— Acta de aceptación UAT (Procès-verbal de recette): alcance, resumen de la campaña, defectos, reservas, decisión, firmas — ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/uat-signoff.mdtemplates/environment-sheet.md— Ficha de entorno (Fiche d'environnement): hechos sobre el entorno de la organización por dominio, con fuentes y puntos abiertos; vive endocs/tiger-team/environment.md— ruta completa${CLAUDE_PLUGIN_ROOT}/skills/deliverables/templates/environment-sheet.md