Operações
Registre e limite atalhos técnicos deliberados
Um registro limitado para atalhos deliberados que vincula cada concessão a um responsável, gatilho, contenção, expiração e verificação, em vez de escondê-la como limpeza geral.
O processo
Faça nesta ordem.
- Capture o atalho, a decisão que ele possibilitou, a data, o limite do sistema, as pessoas que o aceitaram e as evidências disponíveis na época.
- Classifique a dívida como segurança, confiabilidade, manutenibilidade, conformidade, custo ou pressão de entrega e descreva a falha ou o custo concreto que ela cria.
- Defina contenção, monitoramento, solução alternativa, limite de dados ou serviço e um sinal observável que tornaria o atalho inseguro.
- Atribua um responsável, data de revisão, condição de aposentadoria, dependências e um caminho de aceitação para o risco que ainda não pode ser eliminado.
- Rastreie como o atalho afeta mudanças futuras, resposta a incidentes, onboarding e conformidade e então priorize-o diante do risco ativo, não da limpeza geral.
- Agende pagamento, substituição ou aceitação explícita e registre a decisão e as evidências sem converter silenciosamente o compromisso em requisito.
- Revise o registro, sinalize itens atrasados ou que se acumulam e devolva ao responsável o estado atual, as evidências, o risco aceito e os riscos não resolvidos.
Traga isto
Entradas que o gato vai pedir.
- descrição e justificativa do atalho
- serviço ou repositório afetado
- responsável pelo risco e autoridade de aceitação
- evidências de monitoramento e 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:
minimal-code-pack skills/minimal-code-pack/technical-shortcut-debt-ledger/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.
O registro dá a cada atalho deliberado um risco limitado, contenção, responsável, condição de expiração ou aceitação, sinal de verificação e estado atual respaldado por evidências.
Fontes
De onde veio este processo.
- github.com/DietrichGebert/ponytail/tree/e3ba2aa6f1e6f0bc4d69eb09c9f0d0a93af56156/
- martinfowler.com/bliki/TechnicalDebt.html
- sre.google/sre-book/release-engineering/
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.
