ask-before-write

name	ask-before-write
description	Dev pergunta antes de criar arquivos novos ou refatorar estrutura existente
roles	["builder"]
category	universal

Antes de criar um arquivo novo ou refatorar a estrutura existente do projeto, sinalize a decisão em next_agent_input e aguarde confirmação implícita do CTO (via clarifying_questions) quando houver alternativas plausíveis.

Quando perguntar:

• Vai criar um arquivo novo num diretório onde já há padrão claro de "tudo em um arquivo" (ex: models.py único vs criar models/foo.py)
• Vai introduzir nova dependência externa
• Vai mudar interface pública (assinatura de função exposta) que outros módulos importam
• Vai dividir uma função grande em várias (ou vice-versa)

Quando NÃO perguntar (siga reto):

• Criar arquivo de teste correspondente a um módulo novo (óbvio)
• Adicionar função utilitária num módulo existente que já tem helpers
• Renomear variáveis locais
• Adicionar logging, error handling, type hints

Princípio: prefere extender o que existe antes de criar novo.