freeze

Visão geral da skill freeze

O que a freeze faz

freeze é uma skill de guarda que restringe as edições de arquivos a um único diretório durante a sessão. Ela bloqueia Edit e Write fora do caminho permitido, então é útil quando você quer que um agente de automação de fluxo de trabalho fique dentro de um módulo, de uma pasta de feature ou de um sandbox de depuração. Se você precisa da skill freeze para evitar mudanças acidentais e amplas demais, este é o encaixe certo.

Quem deve instalar

Instale freeze se você costuma pedir a um agente para depurar, refatorar ou aplicar patches em um escopo estreito e não quer que ele “ajude” mexendo em arquivos sem relação. Ela é mais valiosa para mantenedores, revisores e qualquer pessoa trabalhando em uma base de código mista ou arriscada, em que limites de edição importam mais do que autonomia ampla.

Por que ela é diferente

O principal diferencial é a aplicação do limite, não a orientação. freeze usa um hook pré-ferramenta para negar edições fora do diretório escolhido, o que é mais forte do que um prompt que apenas pede para o modelo manter o foco. Isso torna o guia do freeze prático para contenção real, especialmente em sessões em que qualquer desvio acidental sairia caro.

Como usar a skill freeze

Instale e inicialize a fronteira

Para o freeze install, adicione a skill ao seu ambiente com o gerenciador de skills do repositório e, em seguida, escolha o diretório que você quer travar. O fluxo de configuração é interativo porque o caminho permitido é específico da sessão. Na prática, você precisa estar pronto para responder “Qual diretório deve ser congelado?” com um caminho preciso, não com uma área vaga como “o backend”.

Leia estes arquivos primeiro

Comece com SKILL.md para entender o fluxo de controle e depois inspecione bin/check-freeze.sh para ver como a fronteira é aplicada. Se você estiver adaptando a skill, revise também SKILL.md.tmpl para entender a estrutura gerada. Esses arquivos mostram o que o uso de freeze realmente permite, o que é bloqueado e onde o parsing de caminhos pode falhar ou ser permissivo demais.

Dê um prompt preciso para a skill

A melhor entrada é uma tarefa focada com uma fronteira clara. Por exemplo: “Congele as edições em apps/payments e corrija os testes unitários com falha lá, sem alterar bibliotecas compartilhadas.” Isso é melhor do que “depure este app”, porque freeze precisa de um diretório-alvo e de uma tarefa que caiba nele. Quanto mais exato for o escopo, menor a chance de o agente pedir exceções.

Dicas práticas de fluxo de trabalho

Use freeze quando a primeira passada precisar ser cirúrgica: localizar o bug, corrigir dentro de uma pasta e verificar sem ampliar o escopo. Se a tarefa realmente exigir mudanças entre diretórios, não force isso em freeze; ou amplie o caminho permitido, ou use outro fluxo de trabalho. A skill funciona melhor quando o conjunto de mudanças solicitado já nasce bem delimitado e a estrutura do repositório está clara.

FAQ da skill freeze

freeze é só para depuração?

Não. Depuração é um uso comum, mas a skill freeze também ajuda em refatorações restritas, isolamento de features e edições seguras para revisão. A pergunta principal é se você quer que o agente permaneça dentro de um único diretório enquanto trabalha.

Em que isso é diferente de um prompt normal?

Um prompt normal depende de o modelo seguir instruções. freeze adiciona enforcement por meio de hooks, então edições fora do escopo são bloqueadas mesmo que o modelo tente fazê-las. Isso a torna mais confiável para jobs de Workflow Automation em que guardrails importam.

freeze é amigável para iniciantes?

Sim, se a pessoa conseguir nomear um diretório com confiança. O erro mais comum de iniciantes é escolher uma fronteira ampla demais ou estreita demais. Se o diretório for ambíguo, a sessão pode travar enquanto você esclarece o escopo.

Quando eu não devo usar freeze?

Não use quando a tarefa for, por definição, atravessar vários módulos, configs compartilhadas ou formatação em todo o repositório. Nesses casos, a restrição pode atrasar o trabalho ou gerar ações bloqueadas sem necessidade. Freeze é melhor quando a fronteira é uma decisão real, e não apenas uma preferência.

Como melhorar a skill freeze

Torne a fronteira explícita

O maior ganho de qualidade vem de nomear o diretório exato e o resultado desejado ao mesmo tempo. Um bom input parece com: “Congele as edições em services/auth e atualize o fluxo de refresh de token sem tocar em shared/.” Um input fraco como “corrija auth” força suposições e aumenta a chance de edições bloqueadas ou incompletas.

Forneça arquivos, sintomas e limites

Para usar freeze melhor, inclua o arquivo com falha, o comportamento observado e quaisquer arquivos que estejam fora de limites. Exemplo: “Edite apenas apps/admin; o bug está em src/table.ts; não altere contratos de API.” Isso ajuda o agente a permanecer dentro da zona congelada sem deixar de resolver o problema real.

Fique atento ao descompasso de fronteira

O modo de falha mais comum é uma tarefa que, sem deixar claro, precisa de um escopo maior do que o diretório congelado permite. Se o agente continuar batendo em denied writes, a correção normalmente é ampliar a fronteira ou dividir a tarefa em etapas. Isso é uma feature, não um bug: freeze está dizendo que o plano e o escopo não combinam.

Itere depois da primeira passada

Depois da primeira saída, verifique se a solução dependeu de suposições fora do caminho congelado. Se depender, ajuste o prompt com uma ou duas restrições concretas: diretório-alvo, tipos de arquivo permitidos e o que não pode ser tocado. Para obter os melhores resultados com a skill freeze, itere esclarecendo o escopo, e não pedindo mais criatividade.