MinorBaek/wiki-synthesize

O que wiki-synthesize faz?

Antes da primeira execução, leia docs/GOTCHAS.md no kit (armadilhas operacionais para ingestão, síntese e lint) e docs/SEALS.md (o formato de selo).

O "cirurgião" da camada de síntese viva. Reorganiza o repositório de descobertas já verificadas de uma nota (## Descobertas Chave em uma nota de conceito; as seções portadoras de afirmações de uma nota de método) em um bloco de Estado do Conhecimento que captura o fluxo da evidência: resolvida, contestada, substituída, emergente. Ele NUNCA inventa afirmações. Cada entrada remete a uma descoberta existente, e cada entrada nova ou alterada é verificada contra o PDF de cada trabalho que cita antes que o usuário a ratifique (verificação de evidência, camada 2).

Modos

• padrão: /wiki-synthesize <NomeDaNota> sintetiza uma nota de conceito ou método.
• lista de trabalho: /wiki-synthesize (sem argumento) executa wiki-lint Check 15, então apresenta check15_missing priorizada (campos listados em synthesis.priority_fields primeiro, depois por contagem de trabalhos-fonte, decrescente) mais check15_stale (candidatos a ressíntese), e pergunta qual nota processar. A lista de trabalho é um backlog, não uma obrigação de fazer tudo agora. O conjunto elegível é o que Check 15 relata ao vivo; uma contagem congelada escrita em um documento fica obsoleta.
• batch: /wiki-synthesize --batch [N] é modo de campanha de gerenciamento por exceção (onda padrão de 8). Executa Check 15, forma uma onda prioritária, despacha subagentes paralelos (cada um segue SYNTHESIS-WORKFLOW.md e retorna um bloco mais um autorrelato, nunca escreve), bloqueia cada escrita com a verificação de evidência e scripts/synth_validate.py, escreve notas limpas, e escala em 4 gatilhos (T1 número-chave não verificável, T2 perda de informação, T3 anomalia estrutural, T4 baixa confiança do subagente) e em qualquer defeito que a verificação encontrar. Veja references/BATCH-WORKFLOW.md. Proponha os subagentes de uma onda ao usuário primeiro (o que fazem, quantos, qual modelo) e aguarde o sinal verde.

Papel e limites

Faz: lê o repositório de descobertas de uma nota, pondera por evidence_level mais medição inline, redige o bloco, verifica cada entrada nova ou alterada contra o PDF, apresenta para ratificação, então escreve (insere o bloco e absorve ## Controvérsias ou Lacunas), sela as notas fonte, executa o portão, registra.

NÃO faz: inventa números ou afirmações, cria notas debates/ (sinaliza candidatos no relatório), toca em notas abaixo do limiar de síntese, ou escreve qualquer coisa antes da ratificação do usuário.

Onde as coisas ficam

Os caminhos vêm de wiki.config.json. Notas: <wiki_root>/concepts/, methods/, papers/, books/. Sempre leia WIKI_SCHEMA.md (Camada de Síntese Viva) antes de começar.

Limiar (deve ser verdadeiro antes de sintetizar)

status: final E (synthesis.min_sources ou mais trabalhos fonte distintos (padrão 3) OU pelo menos uma fonte citada com evidence_level em synthesis.sr_levels (padrão SR-MA, SR)). Isso é exatamente o teste de qualificação do Check 15 do wiki-lint. Se não for verdadeiro: relate e PARE.

Fluxo de trabalho

Procedimento completo em references/SYNTHESIS-WORKFLOW.md. Resumo: leia contratos, resolva a nota (exato test -f/busca de conteúdo, nunca um glob sozinho), portão de limiar, guarda de pré-texto completo, agrupe descobertas em subquestões, verifique entradas novas ou alteradas contra o PDF, proponha o bloco no chat com citações e páginas, ratifique, escreva (scripts/synth_write.py: insira depois de ## Definição, absorva Controvérsias, carimbe), sele as notas fonte (<kit>/tools/seal.py), diff de ressíntese se um bloco já existir, então registre, re-execute o portão e re-execute Check 15.

Regras de segurança

• Nunca invente. Cada entrada remete a uma descoberta existente; nenhum número novo da memória ou da nota fonte.
• Verificação de evidência, camada 2: nenhuma entrada nova ou alterada sem verificação do PDF. Até 3 trabalhos distintos, o orquestrador os verifica; mais, ele propõe um subagente com o resumo restrito ao diff e aguarda o OK do usuário. Cada defeito é relido no PDF antes que qualquer coisa mude, e as notas fonte são seladas com o nome da nota. Um selo de texto completo em uma nota fonte não protege o que uma nota diz sobre aquele trabalho: em uma auditoria passada deste método, aproximadamente 4 em cada 10 pares de nota-nota fonte amostrados tinham um defeito.
• Humano no circuito. Modos interativos: proponha, ratifique, escreva (nenhuma escrita antes do OK do usuário). Modo batch: synth_validate.py bloqueia cada escrita e os 4 gatilhos escalam; nunca totalmente autônomo.
• Zero perda de informação. Cada marcador de ## Controvérsias ou Lacunas deve mapear para uma entrada do bloco antes que essa seção seja absorvida.
• Guarda de pré-texto completo. Um artigo citado na coorte de pré-texto completo (uma nota de artigo datada antes de synthesis.prefulltext_cutoff e não selada como texto completo, ou selada apenas no nível do resumo) reduz a confiança da entrada afetada e recebe uma bandeira ⚠ inline; pause a entrada apenas se o número do qual ela depende for em si mesmo não verificável. Capítulos de livro são âncoras confiáveis a menos que seu próprio status: seja draft ou stub, que é a nota afirmando que foi ingerida sem o texto completo (uma source_verification em nível de texto completo substitui o status). synth_validate.py V4 aplica isso mecanicamente.
• Afirmações precisam de fontes. Cada entrada cita [[wikilinks]].
• Sistema de arquivos primeiro. Use as ferramentas de arquivo do host; nenhum plugin Obsidian ou MCP é necessário.

Habilidades relacionadas

• wiki-lint: Check 15 produz a lista de trabalho desta skill; Check 32 sinaliza um par (nota, trabalho) sem selo. Execute-o após sintetizar para confirmar que não houve desvio (links limpos, Check 15 remove a nota de missing).
• wiki-ingest: upstream. As descobertas que esta skill reorganiza foram escritas pela ingestão.

Referências

• references/SYNTHESIS-WORKFLOW.md: o procedimento detalhado, o modelo de bloco, a lógica de guarda, o tratamento de ressíntese.
• references/BATCH-WORKFLOW.md: modo batch, o loop do orquestrador, o resumo do subagente, o portão de escrita V1-V5, os gatilhos de escalonamento.
• scripts/synth_validate.py: o portão de escrita e uma varredura de todo o wiki. scripts/synth_write.py: inserção de bloco. <kit>/tools/seal.py: selagem.