Definição curta

Entregável escrito que reúne, para uma oportunidade de produto específica, o que o time sabe do seu ambiente — negócio, produto, cliente, usuário, técnica, regras de negócio, normas, cultura de campo, concorrência, decisões já tomadas — e que qualifica cada elemento conforme ele seja sabido, acreditado, duvidoso ou silenciado.

Definição detalhada

O termo não tem definição estabelecida: na maioria dos times, "o contexto" é um parágrafo de introdução colocado no começo de uma especificação, escrito para situar o leitor antes de entrar na solução.

Nos artigos deste blog, o documento de contexto é um artefato autônomo, anterior à especificação e independente dela. Ele carrega um status (rascunho, em revisão, validado), um responsável e uma data da última atualização; suas seções estão ligadas aos riscos de produto que elas instruem, e não às disciplinas que as redigem.

Uma distinção de escala o separa do Contexto: o contexto é o espaço de trabalho durável ligado a um objetivo, o documento de contexto é um escrito datado que restitui o estado dele para uma oportunidade específica.

Uso no domínio

Usado para designar o entregável cujo valor sobe quando a capacidade de produzir software deixa de ser rara, e para opor à especificação e ao roadmap um artefato que enquadra o problema em vez de descrever a solução.

Sinônimos e variantes

"O 00-context", pelo nome do arquivo que o abriga no começo de uma pasta de oportunidade; "o contexto de uma oportunidade".

Não confundir com

• especificação — descrição do comportamento esperado do produto, escrita para ser construída. Ela pressupõe o enquadramento pronto; o documento de contexto é o que o produz.
• nota de enquadramento — síntese curta que fixa um escopo e um objetivo para lançar um trabalho. Ela decide; o documento de contexto expõe aquilo sobre o que se decide, dúvidas incluídas.
• roadmap — sequenciamento datado do que será construído. Ele ordena decisões já tomadas; o documento de contexto instrui as que ainda não foram.
• Contexto — espaço de trabalho durável que reúne, em torno de um objetivo, fontes, notas, decisões e rascunhos. O documento é uma restituição escrita e datada dele, não o espaço em si.

Exemplos

O modelo 00-context.md anotado pelos riscos que ele instrui — viabilidade de negócio, valor do lado de quem compra, valor e usabilidade, viabilidade técnica.

Os quatro registros de qualificação que ele impõe: o que eu sei, o que eu acredito, o que me faz duvidar, o que não se diz.

Ambiguidades / debates

O uso corrente — um capítulo de contexto dentro de uma especificação — e o uso adotado aqui não designam o mesmo objeto, embora levem o mesmo nome. A diferença está na autonomia: um capítulo existe para introduzir uma solução já cogitada, o documento existe antes que qualquer solução tenha sido escolhida.