Communitygithub.com

Adaptação às atualizações do harness (house-rules)

Adapta as regras internas (house-rules) a uma nova versão do Claude Code ou modelo Claude, garantindo que o pacote continue complementando o harness em vez de duplicá-lo ou contradizê-lo.

O que é Adaptação às atualizações do harness (house-rules)?

Esta skill automatiza a manutenção de um pacote de regras personalizadas (house-rules) que complementam o harness oficial do Claude Code, sem duplicá-lo ou contradizê-lo. Quando o harness é atualizado — seja por uma nova versão do Claude Code, um novo modelo, ou mudanças na documentação — esta skill identifica todas as regras e mecanismos afetados, classifica cada um como DUPLICADO, CONFLITO, COMPLEMENTO ou ÚNICO, verifica cada alegação adversarialmente, e aplica as correções necessárias. Ela suporta dois modos de operação: o addendum delta (padrão), para atualizações menores, e o re-levantamento completo, para mudanças grandes que afetam múltiplas áreas. O fluxo é executado em um worktree limpo separado e inclui etapas de triagem, classificação, verificação por pares céticos, registro em seções datadas e geração de release. Uma parte crítica do processo é garantir que toda alegação sobre o que o harness faz seja respaldada por fatos coletados do changelog ou de páginas oficiais, e que mudanças de prompt ou estilo sigam a forma que o validador do pacote impõe.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dubbl-a/house-rules/tree/HEAD/.claude/skills/adapting-to-harness-updates

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. Entre em uma worktree a partir de origin/main antes de qualquer outra coisa. Os fluxos de levantamento leem um checkout limpo, então aponte-os para uma segunda worktree que ninguém edita.
  2. 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" de docs/handbook/claude-code.md. npm run check:harness imprime essa linha de base e cada versão do changelog desde ela, e a Action harness-watch agendada cria uma issue harness-update quando a lista não está vazia. Quando os segredos HARNESS_ROUTINE_URL e HARNESS_ROUTINE_TOKEN estão configurados, a Action também dispara uma rotina na nuvem. A rotina executa o caminho de addendum delta e abre um PR rascunho em claude/harness-addendum-<versão>. Quando esse PR existe, comece a partir dele em vez de re-triar. Compare também com claude --version.
  3. Execute o portão sob o novo CLI antes de ler qualquer coisa: npm run verify em 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.
  4. 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-audit em uma sessão). Ela relata caminhos desatualizados, comandos mortos, instruções contraditórias e padrões de prompt escritos para modelos mais antigos.
  5. Escolha a profundidade. Use o julgamento abaixo. Diga qual você escolheu e por quê.
  6. 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.
  7. 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.
  8. 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.
  9. 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't e 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-file ou -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.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Habilidades Relacionadas