Engenharia de software
Planeje uma decisão de arquitetura de software
Uma decisão de arquitetura registrada que compara opções com restrições explícitas, registra consequências e atribui um ponto de verificação antes da implementação.
O processo
Faça nesta ordem.
- Declare a decisão, o contexto, os usuários afetados, os requisitos arquiteturalmente significativos, o horizonte de tempo e quem pode aprovar a escolha.
- Reúna as restrições relevantes de produto, repositório, confiabilidade, segurança, custo e conformidade, separando fatos verificados de premissas e desconhecimentos.
- Defina pelo menos duas opções viáveis, além de não fazer nada, e compare-as com critérios explícitos em vez de escolher por familiaridade.
- Teste cada opção sob estresse quanto a modos de falha, esforço de migração, carga operacional, reversibilidade, exposição de segurança e custo de mudança no longo prazo.
- Escolha uma recomendação ou registre um adiamento deliberado, com justificativa, dissenso, alternativas rejeitadas e as condições que mudariam a decisão.
- Escreva o registro da decisão com status, contexto, decisão, consequências, links de evidências, responsáveis e gatilhos de revisão antes de iniciar a implementação.
- Revise o registro com os responsáveis, registre aprovação ou condições necessárias e devolva o artefato, as evidências e os riscos não resolvidos ao solicitante.
Traga isto
Entradas que o gato vai pedir.
- decisão de arquitetura e responsável pela decisão
- requisitos e restrições
- sistema atual e revisão
- evidências disponíveis e partes interessadas na revisão
Roteador + um playbook
Roteie primeiro. Escolha um.
O Cat Paw carrega um playbook por tarefa, sem misturar vários. Comece por este roteador; os outros caminhos são candidatos específicos do workflow.
- Roteador:
software-delivery-pack skills/software-delivery-pack/software-architecture-decision-gate/SKILL.md
Limites
As fronteiras viajam com o prompt.
- Verifique as ferramentas, contas, permissões e o espaço de trabalho reais antes de começar; nunca afirme que uma ferramenta, conta, fonte ou capacidade indisponível existe.
- Use Latch/target-workspace para código privado, artefatos, sondagens ao vivo ou dados não públicos; se esse acesso estiver indisponível, pare no limite e relate o bloqueio em vez de substituir por uma suposição.
- Pause para aprovação explícita antes de ações externas consequentes; retorne evidências, riscos não resolvidos, premissas e qualquer ação que ainda esteja aguardando aprovação.
Pronto significa
Um fim que dá para checar.
Um registro de decisão de arquitetura aprovado ou explicitamente adiado contém o contexto, as opções, a justificativa, as consequências, os responsáveis, as evidências e os gatilhos de revisão.
Fontes
De onde veio este processo.
As fontes estabelecem o padrão do workflow. Posts de Reddit e da comunidade, quando aparecem, valem como anedota de quem pratica — não como fato universal.
