Ingestão de Wiki

Transforme um documento de origem em conhecimento de wiki durável e interligado.

Entradas

• Um problema de operação com operationType: "ingest" atribuído a você.
• Um caminho raw/ mencionado no corpo do problema (sempre trate raw/ como imutável).
• O wikiId, spaceSlug e a raiz do espaço de destino do problema de operação (caso contrário, pare e apresente a configuração ausente ao solicitante).

Fluxo de Trabalho

1. Leia o contexto primeiro.
   • Leia as AGENTS.md do espaço de destino para convenções de página (nomes de arquivos, frontmatter, voz, estilo de citação).
   • Leia as wiki/index.md do espaço de destino para ver o que já existe.
   • Leia as últimas ~20 entradas de wiki/log.md do espaço de destino para evitar re-ingestão de uma origem ou re-resolução de uma contradição que outra pessoa já registrou.
2. Leia a origem de ponta a ponta com wiki_read_source, passando o wikiId e o spaceSlug do problema de operação. Não escaneie. Observe a estrutura da origem, as alegações, as datas e qualquer coisa que contradiga as páginas existentes.
3. Planeje, depois confirme — mas apenas se o usuário estiver no loop. Se a operação veio de uma rotina (sem usuário ativo), prossiga. Se um usuário estiver perguntando interativamente, resuma os 3 a 5 pontos principais que você pretende registrar e pergunte qual enfatizar antes de escrever.
4. Escreva a página de origem em wiki/sources/<slug>.md — ~300–800 palavras, frontmatter de acordo com o esquema da wiki, voz neutra, alegações-chave com trechos citados onde eles têm peso. A página de origem é o destino canônico de citação para todo o resto que esta habilidade escreve.
5. Atualize ou crie páginas downstream em entities/, concepts/ e synthesis/. Uma ingestão típica toca em 5 a 15 páginas; resista a criar páginas para ideias que aparecem apenas uma vez.
6. Conecte os links cruzados. Cada alegação que vem da origem a cita como (see [[wiki/sources/<slug>]]). Cada entidade / conceito mencionado pelo nome em mais de uma página se vincula à sua página dedicada.
7. Marque contradições; não sobrescreva silenciosamente. Quando um novo material discorda de uma página existente, anexe uma chamada > ⚠ contradicted by [[wiki/sources/<slug>]] (YYYY-MM-DD) à página mais antiga e anote o conflito no log.
8. Atualize wiki/index.md com resumos de uma linha para quaisquer novas páginas.
9. Anexe uma entrada de log em wiki/log.md:

   ## [YYYY-MM-DD] ingest | <source title>
   - source: raw/<filename>
   - new pages: [[...]], [[...]]
   - updated pages: [[...]], [[...]]
   - notes: <one-line synthesis or open question>
   

Voz

• Concisa, factual, neutra. Referencie material, não narrativa.
• Sem enquadramento de "Hoje eu aprendi" ou "Isso é interessante porque".
• Cite a origem textualmente quando a paráfrase perder precisão.

Verificação

Antes de fechar o problema de operação:

• A página de origem existe em wiki/sources/<slug>.md com frontmatter válido e um campo sources: apontando para o caminho bruto.
• Cada página nova ou atualizada se vincula de volta à página de origem ou a uma página downstream que o faz.
• wiki/index.md lista cada nova página sob a categoria correta com um resumo de uma linha.
• wiki/log.md tem a entrada de ingestão com o formato exato de cabeçalho do nome do arquivo (para que grep "^## \[" wiki/log.md continue funcionando).
• Qualquer contradição entre a nova origem e uma página mais antiga é anotada, não sobrescrita silenciosamente.
• Nenhum arquivo sob raw/ foi modificado.

Ferramentas

wiki_list_sources, wiki_read_source, wiki_search, wiki_read_page, wiki_write_page. Sempre inclua o wikiId e o spaceSlug do problema de operação.