Um skill do Claude que lê uma pasta de contratos assinados e deriva o playbook de negociação que eles sustentam: a posição padrão por cláusula com a aritmética por trás dela, a faixa completa de pontos onde você realmente fecha, o pior termo que você já assinou e um relatório de cobertura que nomeia cada campo que o corpus não consegue fornecer. O bundle fica em apps/web/public/artifacts/playbook-from-precedent-claude-skill/ e contém SKILL.md mais três arquivos de referência, um dos quais você preenche antes da primeira execução.
O skill é somente leitura. Ele propõe posições com evidência anexada e não aprova nenhuma, porque uma posição de playbook é uma delegação de poderes de assinatura e pertence a uma pessoa com nome e sobrenome.
A lacuna que ele fecha
Playbooks são escritos de memória. Alguém sênior lembra onde a empresa costuma fechar, escreve isso num documento do Word, e o documento vira o padrão — o que funciona até essa pessoa sair ou até a lembrança se revelar uma descrição de três negócios de 2023. A correção óbvia é derivar o playbook dos contratos, e a correção óbvia tem um defeito fácil de não perceber e caro de publicar.
Uma pasta de contratos assinados é uma amostra censurada. Ela contém toda negociação que terminou em assinatura e nenhuma que terminou em abandono. Essa propriedade não é um problema de qualidade de dados que dê para limpar; é o que a pasta é. E ela cai exatamente sobre o campo para o qual um playbook existe. O ponto de abandono é, por definição, a posição que não produz contrato assinado, então é a única coisa que o corpus tem garantia de não conter. Qualquer ferramenta que leia contratos assinados e emita uma linha vermelha com confiança inventou essa linha.
O que o corpus sustenta é o limite que corre no sentido contrário. O termo mais adverso do arquivo é um limite superior da sua tolerância demonstrada: você não abandonou ali, porque existe uma assinatura em cima. A fase 5 emite isso como worst_signed com um identificador de contrato e uma data, e se recusa a emitir walk_away de todo. A fase 7 então roda o teste ao contrário — se alguém afirma uma linha vermelha em 12 meses de honorários e o corpus contém uma indenização de PI sem teto já assinada, essa contradição é sinalizada com o contrato e a data. Isso importa comercialmente, não editorialmente: uma contraparte que tenha seu contrato anterior pode exibi-lo, e uma linha que você já cruzou não é uma linha.
Quando usar
Quando um playbook está sendo escrito ou reescrito e quem redige trabalha de memória. Quando um playbook existente está sendo auditado contra a prática e a pergunta é onde o padrão escrito e a realidade assinada divergiram. Quando poderes de assinatura estão migrando para um time de negócio e os limites de escalonamento precisam sobreviver ao questionamento. Quando uma implantação de CLM precisa de posições iniciais e a extração do fornecedor produziu frequências de cláusula sem nenhuma segmentação por trás.
Quando NÃO usar
- Menos de cerca de 25 contratos assinados no seu próprio papel para aquele tipo de acordo. Abaixo disso a aritmética da fase 4 não consegue separar uma posição de uma coincidência, e a execução devolve um relatório de cobertura quase vazio. Leia os contratos.
- Você precisa do ponto de abandono. O corpus não consegue produzir um, pelo motivo acima. Se esse é o entregável, esta é a ferramenta errada.
- O corpus é majoritariamente papel da contraparte e ninguém consegue rotular qual é qual. A fase 1 se recusa em vez de produzir uma resposta plausível.
- Você quer posições aprovadas, não redigidas. A saída é uma proposta com citações. Aprovar é uma decisão jurídica.
- Ninguém vai preencher o manifesto.
references/1-corpus-manifest.mdé o que torna qualquer segmentação possível. Sem ele a execução tem uma única pilha indiferenciada e reporta uma posição misturada de negociações sem relação entre si.
O que o skill realmente faz
Sete fases, ordem fixa, com recusas duras em duas delas.
A fase 1 liga cada contrato à sua linha no manifesto e se recusa se mais de 10% do corpus não tiver paper_of_origin. Ela não adivinha o campo a partir do documento. Essa recusa existe porque a falha característica aqui é silenciosa: um termo aparece em 78% dos contratos assinados, é anotado como padrão da empresa e é na verdade um artefato de 78% desses contratos terem sido assinados no formulário do outro lado. Uma frequência medida sobre papel misturado é uma medição das preferências de redação das suas contrapartes reportada sob o seu nome.
As fases 2 e 3 separam extração de normalização — primeiro a citação literal com ponteiro de página, depois o valor comparável numa unidade declarada. Uma passada única confunde “a cláusula diz X” com “X equivale a Y nas nossas unidades”, e uma vez que elas se fundem, os erros de normalização se escondem dentro de citações que ninguém relê. Um slot de cláusula sem correspondência é renderizado como absent, que é um valor participando da estatística e não uma falha de parsing que é descartada.
A fase 4 é onde mora o limiar. As células são (clause, paper_of_origin, agreement_type, counterparty_tier), e o valor modal é reportado com o intervalo de escore de Wilson sobre sua proporção, não com o percentual bruto. Um candidato ganha o rótulo standard só quando o limite inferior de 95% ultrapassa 0,60. Essa regra é o que faz amostras pequenas se comportarem, e vale ver a aritmética: um termo que aparece em 8 de 10 contratos é 80% por contagem e carrega um intervalo de 95% de aproximadamente 49% a 94%, que abrange “quase sempre” e “pouco mais da metade” e portanto não pode ser chamado de padrão. Os mesmos 80% em 20 de 25 têm limite inferior perto de 61% e passam. Cerca de 25 instâncias no mesmo papel por cláusula é o piso prático; células mais curtas são renderizadas como insufficient-evidence com o tamanho de amostra que precisariam, nunca como uma posição suavizada.
A fase 6 condiciona a escada de fallbacks a dois requisitos — histórico de redlines fornecido e uma distribuição genuinamente multimodal, não um único agrupamento com ruído. O texto assinado registra onde você fechou, não com o que abriu, então derivar uma escada fallback_1 / fallback_2 de PDFs finais afirma uma intenção que a evidência não carrega. Quando os requisitos falham, a saída diz observed_range com esse nome, e um campo obrigatório fallback_ladder_reason impede que “não tínhamos histórico de versões” seja indistinguível de “não existe escada aqui”.
A fase 7 divide cada célula numa janela de recência de 24 meses e reporta células divergentes como duas posições com datas em vez de tirar a média, porque um teto de responsabilidade de 2022 promediado com um de 2026 não descreve nenhum dos dois. O relatório é escrito em references/3-coverage-report-template.md, que abre com as linhas não inferíveis e de evidência insuficiente e deixa as posições derivadas no fim, já que são as que menos precisam de revisão.
Custo e throughput
O gasto de modelo não é a restrição. Um MSA de 15 páginas gira em torno de 8.000 a 12.000 tokens — uma estimativa, não um número medido —, então um corpus de 60 contratos está na ordem de 600.000 tokens de entrada. À tarifa publicada pela Anthropic para o Claude Opus 5 de US$ 5 por milhão de tokens de entrada, isso dá cerca de US$ 3 de entrada mais a saída de extração, deixando a passada inteira abaixo de US$ 10.
O custo humano é o número que importa. Preencher o manifesto leva de 1 a 3 minutos por contrato se os metadados já estiverem num CLM e de 5 a 10 se alguém precisar abrir cada arquivo, então um corpus de 60 contratos é meio dia de ingestão antes da primeira execução. Some cerca de 2 a 4 horas revisando o relatório de cobertura, a maior parte nas seções de contradição e deriva. O manifesto persiste, então a segunda execução é um diff e custa uma fração da primeira. Reexecutar por trimestre é a cadência que vale a pena assumir — a pesquisa da DocJuris com cerca de 300 departamentos jurídicos, publicada em outubro de 2024, encontrou que mesmo no estágio mais maduro a falha recorrente é a titularidade, com a primeira versão do playbook nunca melhorando.
Modos de falha
- A confusão do papel de origem. Uma frequência construída sobre papel misturado se lê como o seu padrão e é o das suas contrapartes. Guarda: a fase 1 se recusa acima de 10% de campos faltantes, e
paper_of_originé uma dimensão de célula e não um filtro, então uma posição de papel da contraparte nunca pode se fundir silenciosamente à de papel próprio. - Falsa confiança com n pequeno. Oito instâncias em dez parece decisivo e não é. Guarda: o rótulo
standardexige um limite inferior de Wilson de 95% acima de 0,60, e células que falham reportamn_requiredem vez de uma posição matizada. - Inventar o ponto de abandono. O campo mais valioso de um playbook é aquele que o corpus não consegue fornecer, que é exatamente a pressão que produz um fabricado. Guarda:
walk_awayé um enum de valor único emreferences/2-clause-position-schema.md— não existe caminho de código que derive um. - Uma linha vermelha que o seu próprio arquivo já cruzou. Guarda: a fase 7 testa ao contrário qualquer ponto de abandono afirmado contra
worst_signede sinaliza contradições com o identificador e a data do contrato. - Poder de barganha lido como preferência. As posições parecem mais fracas no segmento enterprise porque foi ali que você cedeu, não porque o padrão seja diferente lá. Guarda:
counterparty_tieré uma dimensão de célula, e quando os segmentos discordam de forma material a posição misturada é suprimida e a supressão é nomeada no relatório. - Tomar a acurácia da extração como certa. Identificação de cláusulas não é um problema resolvido — o CUAD, o benchmark anotado por especialistas com mais de 13.000 rótulos sobre 510 contratos comerciais e 41 tipos de cláusula, existe porque o desempenho dos modelos exatamente nessa tarefa tem espaço para melhorar. Guarda: cada valor normalizado mantém sua citação de origem e seu ponteiro de página, então a segunda passada é auditável contra a primeira sem reabrir o PDF.
vs alternativas
vs DraftWise Playbook Studio. A resposta direta de prateleira, lançada em 25 de fevereiro de 2026, e a afirmação do fornecedor é que ela comprime a criação de um playbook de mais de seis horas manuais para cinco minutos extraindo posições do histórico de negócios. Se você já está no DraftWise, use — ele é integrado à redação, coisa que este bundle não é. O que o material de lançamento não declara é um tamanho mínimo de corpus, um requisito de segmentação ou o que ele faz quando a evidência é rala, e esses três são toda a substância do problema. Rode este skill sobre o mesmo corpus como conferência das posições, não como substituto do produto.
vs Spellbook Benchmarks. O trabalho State of Contracts 2026 da Spellbook publica mais de 270 benchmarks de cláusula sobre 13 tipos de contrato extraídos de centenas de milhares de contratos em 30 países, num modelo de dados de reciprocidade. Isso responde outra pergunta — onde o mercado está — e é o melhor instrumento para argumentar que o pedido de uma contraparte está fora de mercado. Não consegue dizer onde você está, e a diferença entre as duas coisas costuma ser o achado mais útil disponível. Use as duas; não substitua uma pela outra.
vs a biblioteca de cláusulas do seu CLM. Tanto o Ironclad quanto o Juro mostram frequências de cláusula no seu repositório, e se você já tem o repositório esse é o ponto de partida mais barato. O que eles normalmente não dão é a segmentação por papel de origem, o limite de confiança que separa uma posição de uma coincidência e a recusa explícita a declarar um ponto de abandono. Essas três coisas são o que este bundle acrescenta por cima.
vs escrever num documento do Word de memória. A comparação honesta, já que é o que a maioria dos times faz, e funciona bem com dez contratos em que uma pessoa leu todos. Além disso, a falha não é a memória estar errada, e sim que nada distingue as posições bem evidenciadas das lembradas, então o documento inteiro carrega a mesma autoridade. O valor do relatório de cobertura é que ele se avalia sozinho.
Relacionado: clause-extraction-claude-skill para a camada de extração sobre a qual isto se apoia, clause-library-design para estruturar a biblioteca onde as posições aterrissam, e contract-redline-claude-skill para aplicar o playbook depois que ele existe.