Pontos de Verificação de Contexto Estratégico

Condense o contexto após uma fase verificada, com informações duráveis suficientes para retomar a mesma tarefa. A contagem de chamadas de ferramenta é apenas um lembrete; ela não pode medir a qualidade do contexto nem decidir quando a compactação é segura.

Quando Usar

Use quando a exploração terminou, um marco testado foi alcançado ou uma longa conversa contém raciocínios repetidos ou obsoletos. Não compacte no meio de uma chamada de ferramenta não resolvida, uma decisão de aprovação não registrada ou uma falha cujas evidências exatas não foram capturadas.

Entradas e pré-requisitos

• O objetivo atual do usuário, as restrições aceitas e a definição de "feito".
• O branch atual e a revisão de origem, alterações locais, caminhos de artefatos relevantes e resultados de verificação reais.
• Processos em execução, chamadas de ferramenta pendentes, aprovações ou bloqueios externos.
• Um mecanismo de compactação de contexto suportado pelo host. Esta habilidade não assume que /compact existe em todos os clientes nem manipula arquivos de contexto internos.

Procedimento

1. Escolha um limite de fase: descoberta para implementação, implementação para verificação ou um lote concluído para o próximo. Preserve primeiro a reprodução de uma falha não resolvida.
2. Reconcilie o estado da tarefa com o sistema de arquivos e o Git. Distinga trabalho concluído, não confirmado, planejado e falho.
3. Produza o ponto de verificação abaixo. Inclua comandos exatos, resumos de resultados e caminhos necessários para retomar; omita logs copiados e hipóteses descartadas que não importam mais.
4. Verifique se a próxima ação é executável e se um novo contexto não repetiria uma mesclagem, enviaria uma mensagem duas vezes, perderia uma restrição ou sobrescreveria trabalho não relacionado.
5. Salve apenas em um artefato de projeto já autorizado ou retorne o ponto de verificação na conversa. Não reescreva a memória global ou a configuração do host automaticamente.
6. Use o comando de compactação suportado pelo cliente, se solicitado e disponível. Na retomada, leia o ponto de verificação e verifique o estado mutável antes de continuar.

Modelo de Ponto de Verificação

Objective and done condition:
User constraints and authorization boundaries:
Source revision, branch and local changes:
Completed outcomes with verification:
Outstanding work and known failures:
Running process/tool identifiers:
Artifacts and exact paths needed next:
Next action, expected result and fallback:

Exemplo Trabalhado

Para um recurso de pesquisa cujo PR de origem foi mesclado enquanto a sincronização canônica está pendente, preserve o SHA da mesclagem de origem, o número do PR canônico e os arquivos gerados esperados. Registre os testes como aprovados apenas para a revisão realmente testada. A próxima ação é verificar o PR canônico e o main atualizado; não é mesclar o PR de origem novamente. Se uma verificação no navegador ainda precisar de um desktop desbloqueado, mantenha essa condição visível enquanto continua a revisão de código independente.

Resultado esperado: o próximo contexto retoma a verificação pendente, preserva edições locais não relacionadas e não reivindica publicação de uma mesclagem de origem.

Lembrete Opcional Sem Estado

bash skills/cc-skill-strategic-compact/suggest-compact.sh 50

O helper aceita uma contagem de chamadas de ferramenta observada e um limite opcional (padrão 50), e imprime um lembrete no limite e a cada 25 chamadas após ele. COMPACT_TOOL_COUNT e COMPACT_THRESHOLD podem ser fornecidos por um adaptador de chamador explícito. Ele não armazena um contador, não estima o uso de tokens e nunca realiza compactação. Sem contagem, ele sai silenciosamente.

Versões anteriores incrementavam um contador de estado do usuário compartilhado entre sessões não relacionadas. Esse contador não é mais lido ou escrito; wrappers personalizados existentes devem passar uma contagem de sessão explicitamente. Arquivos de estado existentes são deixados intocados. Esta habilidade não instala nem edita um hook.

Limitações

• Um ponto de verificação preserva evidências registradas, não todo o detalhe da conversa. Mantenha artefatos primários quando bytes exatos importam.
• As contagens são fornecidas pelo chamador, inteiros decimais não negativos limitados; lembretes não são uma medida de capacidade de contexto.
• Branches, processos e verificações remotas podem mudar após um ponto de verificação. Revalide-os em vez de tratar um resumo como verdade atual.
• O gerenciamento de contexto do cliente difere. Não simule a compactação excluindo bancos de dados de chat, logs, caches ou arquivos de projeto.