Definición corta

Entregable escrito que reúne, para una oportunidad de producto dada, lo que el equipo sabe de su entorno — negocio, producto, cliente, usuario, técnica, reglas de negocio, normas, cultura de terreno, competencia, decisiones ya tomadas — y que califica cada elemento según sea sabido, creído, dudoso o callado.

Definición detallada

El término no tiene definición establecida: en la mayoría de los equipos, "el contexto" es un párrafo de introducción colocado al inicio de una especificación, escrito para situar al lector antes de entrar en la solución.

En los artículos de este blog, el documento de contexto es un artefacto autónomo, anterior a la especificación e independiente de ella. Lleva un estado (borrador, en revisión, validado), un responsable y una fecha de última actualización; sus secciones se vinculan a los riesgos de producto que instruyen más que a las disciplinas que las redactan.

Una diferencia de escala lo separa del Contexto: el contexto es el espacio de trabajo duradero asociado a un objetivo, el documento de contexto es un escrito fechado que restituye su estado para una oportunidad concreta.

Uso en el ámbito

Se emplea para designar el entregable cuyo valor sube cuando la capacidad de producir software deja de ser escasa, y para oponer a la especificación y a la roadmap un artefacto que encuadra el problema en lugar de describir la solución.

Sinónimos y variantes

"El 00-context", por el nombre del archivo que lo aloja al inicio de un dosier de oportunidad; "el contexto de una oportunidad".

No confundir con

• especificación — descripción del comportamiento esperado del producto, escrita para ser construida. Da por hecho el encuadre; el documento de contexto lo produce.
• nota de encuadre — síntesis corta que fija un perímetro y un objetivo para lanzar un trabajo. Decide; el documento de contexto expone aquello sobre lo que se decide, dudas incluidas.
• roadmap — secuenciación fechada de lo que se construirá. Ordena decisiones ya tomadas; el documento de contexto instruye las que no lo están.
• Contexto — espacio de trabajo duradero que reúne en torno a un objetivo fuentes, notas, decisiones y borradores. El documento es una restitución escrita y fechada de él, no el espacio en sí.

Ejemplos

La plantilla 00-context.md anotada con los riesgos que instruye — viabilidad de negocio, valor del lado del comprador, valor y usabilidad, factibilidad.

Los cuatro registros de calificación que impone: lo que sé, lo que creo, lo que me hace dudar, lo que no se dice.

Ambigüedades / debates

El empleo corriente — un capítulo de contexto dentro de una especificación — y el empleo elegido aquí no designan el mismo objeto, aunque llevan el mismo nombre. La diferencia está en la autonomía: un capítulo existe para introducir una solución ya contemplada, el documento existe antes de que se haya elegido ninguna solución.