Adaptação a atualizações do harness
O teste permanente do pacote: complementar e melhorar o harness, e nunca duplicar ou entrar em conflito com ele, a menos que isso seja declarado intencionalmente, com o recurso nativo nomeado. Uma versão do harness pode quebrar esse teste de três maneiras. Ela pode implementar nativamente o que uma regra ou mecanismo faz, tornando a regra uma duplicata. Ela pode alterar o comportamento que uma regra descreve, tornando a regra um conflito. Ou pode adicionar um recurso que uma regra deveria citar. Um novo modelo também pode tornar o estilo de prompt de uma regra desatualizado, mesmo que todos os fatos nela ainda sejam válidos. Esta skill encontra todos os quatro problemas e os corrige.
Caminho padrão
- Entre em uma worktree a partir de
origin/mainantes de qualquer outra coisa. Os fluxos de levantamento leem um checkout limpo, então aponte-os para uma segunda worktree que ninguém edita. - Encontre a linha de base. A última versão e data levantadas estão na seção datada final de
docs/handbook/sources/harness-survey.md. A seção de re-levantamento mais recente lá nomeia o diretório do banco de pesquisa. Os fatos do modelo registrados estão nos parágrafos "escada" dedocs/handbook/claude-code.md.npm run check:harnessimprime essa linha de base e cada versão do changelog desde ela, e a Actionharness-watchagendada cria uma issueharness-updatequando a lista não está vazia. Quando os segredosHARNESS_ROUTINE_URLeHARNESS_ROUTINE_TOKENestão configurados, a Action também dispara uma rotina na nuvem. A rotina executa o caminho de addendum delta e abre um PR rascunho emclaude/harness-addendum-<versão>. Quando esse PR existe, comece a partir dele em vez de re-triar. Compare também comclaude --version. - Execute o portão sob o novo CLI antes de ler qualquer coisa:
npm run verifyem um checkout limpo. O validador de plugins roda com--strict, então um aviso que uma versão adiciona falha no portão, e uma triagem de changelog pode ler essa entrada como ruído. - Colete o delta no scratchpad, uma fonte por agente:
- as seções do changelog do Claude Code desde a linha de base (https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md), a única fonte que data uma mudança;
- as páginas de visão geral de modelos e configurações de modelo, para novos modelos, padrões, preços e esforço;
- a auditoria de prompt do próprio harness neste repositório (
/doctor prompt-auditem uma sessão). Ela relata caminhos desatualizados, comandos mortos, instruções contraditórias e padrões de prompt escritos para modelos mais antigos.
- Escolha a profundidade. Use o julgamento abaixo. Diga qual você escolheu e por quê.
- Trie e classifique. Cada candidato recebe uma disposição: DUPLICADO, CONFLITO, COMPLEMENTO
ou ÚNICO (definições em references/dispositions.md). Pesquise os
arquivos de regras,
plugins/house/orchestration/ORCHESTRATION.md, os agentes, os hooks, as skills e as avaliações por qualquer texto que descreva o comportamento antigo. - Verifique. Um DUPLICADO ou CONFLITO conta apenas depois que dois céticos falham em refutá-lo.
Um lê para precisão da documentação e um para realidade de aplicação, e cada um assume refutado
quando está em dúvida. A sessão então lê a linha citada e o próprio texto da regra. Qualquer coisa
que você possa resolver executando (
--help, um hook com uma carga real, o verificador), execute. - Aja sobre a disposição. Resolva um conflito na regra ou hook. Aposente uma duplicata, ou mantenha-a como uma duplicata declarada que nomeia o recurso nativo. Reformule um complemento apenas onde a regra alega ou implica um recurso, e cite o fato. Registre um único e deixe-o. Uma descoberta da auditoria de prompt altera a redação, nunca a afirmação de uma regra, e deve se encaixar na forma que o verificador impõe. Antes de aceitar um desvio de um agente, uma nota "não bloqueadora" de um revisor ou um "limite conhecido", nomeie a regra interna ou recomendação de documento que o governa e siga a opção recomendada, a menos que você possa explicar por que não.
- Registre nos três lugares descritos em references/recording-and-release.md. Então siga o fluxo de release descrito lá.
Escolhendo a profundidade
Addendum delta (o padrão). Trie apenas as seções do changelog e mudanças de modelo desde a linha
de base, com um pesquisador por fonte. Classifique os acertos contra a superfície das regras, depois
escreva uma seção ## Addendum datada. Isso é adequado para uma ou duas versões de correções e
pequenas funcionalidades, e uma mudança de modelo cujo efeito está em níveis e esforço.
Re-levantamento completo. Re-pesquise cada área do harness a partir da documentação, classifique cada cabeçalho de regra e mecanismo, verifique, sintetize e execute um crítico de completude. Depois execute uma passagem de lacunas sobre o que o crítico nomear. Execute a triagem do changelog do caminho delta junto: páginas de documentação não carregam datas, então sem o changelog uma execução completa não pode diferenciar uma página atual de uma desatualizada. Sinais de que o addendum não é suficiente:
- o delta toca várias áreas ao mesmo tempo;
- uma nova família de modelos ou padrão chega;
- a auditoria de prompt sinaliza padrões em muitos arquivos;
- um addendum revela um conflito em uma área cujos fatos registrados são anteriores à mudança;
- o crítico do último re-levantamento listou áreas que ninguém pesquisou desde então.
Os scripts são scripts/house-vs-harness-audit.js (principal) e scripts/house-vs-harness-gap-audit.js
(lacunas). Cada um recebe args.repo (um caminho absoluto para a worktree limpa) e args.date. A
execução de lacunas também recebe args.areas e args.targets das descobertas do crítico, além de
uma args.context opcional com uma frase declarando o resultado da execução principal para seu
addendum. Eles executam através da ferramenta Workflow, que precisa da aceitação explícita do
usuário. Antes de perguntar, informe a contagem de agentes: a execução principal é um pesquisador
por área, um classificador Opus por módulo mais um para mecanismos, dois céticos por alegação de
duplicado-ou-conflito, e dois agentes de síntese.
Perigos
- A maioria das descobertas é atribuição, não substância. O maior re-levantamento até agora não encontrou duplicatas nem conflitos, mas encontrou 27 reformulações onde uma regra alegava um recurso nativo que a documentação não afirma. Antes de qualquer regra dizer que o harness faz algo, o fato precisa existir no banco ou em uma página buscada.
- Os céticos veem apenas duplicatas e conflitos. A reformulação proposta de um complemento chega ao relatório sem ser verificada, e pode exagerar o harness tão facilmente quanto o texto antigo. Envie um refutador para verificar cada reformulação contra os fatos registrados antes de enviá-la.
- Uma contagem ingênua de cabeçalhos pula uma regra. Todo arquivo de regra termina em
## Don't, e algumas regras reais começam com "Don't". Conte cabeçalhos por correspondência exata, não por prefixo. - Páginas de documentação não carregam datas. Registre a data de busca junto a cada citação. Se o changelog e uma página discordarem, confie no changelog sobre quando e na página sobre o quê.
- Configurações de modelo ficam fora do repositório. O nível de subagente e o esforço por modelo são configurações do usuário. Quando uma mudança de modelo os move, diga ao usuário o que definir; nunca edite as configurações deles daqui. Um modelo recém-lançado roda com seu esforço padrão até que um nível por modelo seja aplicado.
- Uma descoberta da auditoria de prompt pode colidir com a forma da casa. Uma sinalização de
auditoria em uma lista de proibições ou um número fixo é um sinal de estilo. As seções
## Don'te os tetos de comprimento são forma verificada e catracas, então alterá-los é uma decisão do pacote sob os ADRs, não uma reformulação. - A proteção de branch lê texto de comando. Escreva corpos de PR e mensagens de commit que
mencionem verbos git próximos a nomes de branch com a ferramenta Write, depois passe-os com
--body-fileou-F. - Subagentes não fazem commit. A sessão commita e envia o que um agente preparou.
Quando uma edição aqui entra em vigor
Esta skill é local ao repositório. Uma edição alcança a próxima sessão que a invocar pelo nome, e
nada é enviado para os adotantes. O que chega aos adotantes são as mudanças de regras e mecanismos
que ela produz, através de um release e do render --apply de cada adotante.