Desenvolvimento Orientado a Restrições

Visão Geral

Outras habilidades neste pacote descrevem o que é bom. code-review-and-quality oferece cinco eixos. test-driven-development oferece um ciclo. security-and-hardening oferece uma lista de ameaças. Tudo isso vive em prosa que o agente lê e pode ou não seguir, e nada disso sobrevive ao fim da sessão.

Esta habilidade produz algo diferente: um registro escrito do padrão deste projeto, com números, que sobrevive à conversa e pode ser verificado mecanicamente.

A razão importa. Quando você escreveu o código, lê-lo dizia se ele era bom. Um agente escreve mais em uma tarde do que você lerá naquela semana, então o julgamento sai da sua cabeça e vai para verificações que rodam no ciclo. Essas verificações precisam existir, precisam de números que você realmente escolheu e precisam disparar perto o suficiente do trabalho para que o agente corrija sua própria saída.

O desenvolvimento orientado a especificações diz o que construir. O desenvolvimento orientado a testes prova que funciona. O desenvolvimento orientado a restrições define o que significa "bom o suficiente para lançar", antes que alguém discuta sobre isso em um pull request.

Quando Usar

Aplique esta habilidade quando:

• Iniciar um projeto ou um recurso significativo e nenhum padrão de qualidade estiver escrito
• O usuário pedir para "configurar restrições", "adicionar portões de qualidade", "definir nossos padrões" ou "impedir que o agente lance lixo"
• Um agente estiver produzindo um volume que ninguém está lendo linha por linha
• O CI tiver verificações, mas ninguém souber quais bloqueiam um merge e quais são decoração
• Números de cobertura, desempenho ou acessibilidade forem discutidos por PR em vez de decididos uma vez
• Você estiver prestes a executar /build auto ou qualquer loop autônomo, e a única coisa entre ele e o main for uma suíte de testes que o agente também escreveu

Quando NÃO usar:

• O projeto já tiver um CONSTRAINTS.md e o usuário não o estiver alterando — leia-o e siga-o em vez disso
• Scripts pontuais, spikes, protótipos descartáveis
• O usuário quiser uma revisão de código agora (code-review-and-quality) ou um pipeline de CI construído (ci-cd-and-automation)
• Código pré-produto-mercado com vida útil esperada de duas semanas — o piso abaixo ainda vale a pena, o resto não

Carregando Restrições

A entrevista precisa de um usuário ativo. Não a execute em contextos não interativos (CI, /loop, execuções autônomas). Se as restrições estiverem faltando e você estiver em um desses, aplique o Piso abaixo, anote que o fez e sinalize o restante para um humano.

O Processo

Passo 1: Detecte antes de perguntar

Nunca pergunte o que você pode ler. Antes da primeira pergunta, colete:

Relate o que você encontrou em duas linhas, depois pergunte apenas o que falta.

Passo 2: Quatro perguntas, cada uma com um padrão

Siga a disciplina de uma pergunta por vez de interview-me, com uma mudança: cada pergunta aqui tem um padrão, então "Não sei" é uma resposta completa que ainda produz uma configuração funcional.

Q1: Beyond the floor, which of these do you want enforced?
    (a) Test coverage on new code
    (b) Security scanning
    (c) Performance budgets
    (d) Accessibility
    (e) Architecture boundaries
GUESS: (a) and (b) — you have a test runner already and you're handling user input.
DEFAULT if unsure: (a) and (b).
Say what each pick costs: (c) and (d) need a running URL, (e) needs a rules file written.

Q2: When a check fails while the agent is mid-task, should it block or warn?
GUESS: Block. You're running agents unattended and a warning nobody reads is a warning.
DEFAULT if unsure: Block on the floor, warn on everything else for the first two weeks.

Q3: Do you have target numbers in mind, or should I measure where you are today and hold that line?
GUESS: Measure. Most teams don't have a number, and an invented one gets ignored.
DEFAULT if unsure: Measure and hold. See "Ratchets" below.

Q4: What's the slowest check you'll tolerate before the agent hands work back?
GUESS: About 90 seconds. Longer and you'll stop running it.
DEFAULT if unsure: 90 seconds at task end, unlimited in CI.

…