usuyukiso/genealogy-biography

Biografia

A entrada descreve a vida de uma pessoa — na maioria das vezes uma planilha cronológica (um evento por linha, compilada de livros métricos, listas de confissão, censos, arquivos judiciais/administrativos), mas também pode ser notas, links ou documentos. A saída é uma biografia legível mais páginas de fontes. A precisão é mais importante que a prosa: genealogistas verificarão cada afirmação com base nos documentos.

Para onde vai a saída. Tudo é escrito no projeto do site family_tree_github/ (MkDocs Material; veja seu README.md):

O quê	Onde
Página da pessoa	family_tree_github/docs/people/P1000-<slug>.md
Registro de arquivo	docs/sources/archives/A1000-<slug>.md
Livro / publicação	docs/sources/books/B1000-<slug>.md
Foto	docs/sources/photos/F1000-<slug>.md (imagem em docs/assets/images/people/)
Página web	docs/sources/websites/W1000-<slug>.md
Lugar (assentamento)	docs/places/PLC1000-<slug>.md
Índice de lugares	docs/places/index.md
Índice de pessoas	docs/people/index.md
Índice de fontes	docs/sources/index.md
Menu	nav: em family_tree_github/mkdocs.yml

Os arquivos raiz antigos (sources.md com números 3000–3011, people.md, *_biography.md) são legados: não escreva neles. Nunca mencione os números antigos em nenhum lugar do site — sem legacy_id, sem coluna ou linha «Прежний №».

IDs. Um prefixo mais um número de quatro dígitos a partir de 1000, obtido do início do nome do arquivo. Um ID nunca muda e nunca é reutilizado, mesmo depois que uma página é excluída. Obtenha o próximo livre e verifique duplicatas com:

python3 .claude/skills/genealogy-biography/scripts/next_id.py next A A P   # A1010, A1011, P1005
python3 .claude/skills/genealogy-biography/scripts/next_id.py find "23И, оп. 2, д. 24"   # já existe?
python3 .claude/skills/genealogy-biography/scripts/next_id.py list

Links. Escreva apenas o ID; o hook do site (hooks/id_links.py) o transforma em um link: [A1006] → link rotulado «A1006» para a página da fonte; [P1000] → link rotulado com o nome da pessoa; [esposa](P1000) → link com seu próprio texto. Nunca escreva caminhos de arquivo ou URLs para páginas internas. Um ID desconhecido quebra a compilação.

1. Leia a entrada

Se a entrada for uma planilha cronológica (.ods, .xlsx, .csv), carregue a habilidade chronology-table primeiro e siga-a: ela despeja a tabela, mapeia as colunas e fornece uma lista de fatos reconciliada por linha com fontes. Nem toda biografia começa a partir de uma tabela — se o usuário fornecer outro material (notas, links, documentos), trabalhe a partir disso e pule a etapa da tabela.

Verifique se a pessoa já tem uma página (next_id.py find "<sobrenome>" e a tabela no topo de docs/people/index.md). Uma página marcada com !!! warning "Страница-заготовка" é um espaço reservado: escreva a biografia nela, mantendo seu ID e nome de arquivo.

1a. Leia as digitalizações no Yandex Archive

Para cada registro com um link yandex.ru/archive/catalog/..., obtenha o texto reconhecido da digitalização:

python3 .claude/skills/genealogy-biography/scripts/yandex_archive.py page "<url>"

Ele imprime o título do documento e o caminho do catálogo (arquivo / фонд / опись / дело) e depois as linhas reconhecidas da página. Use-os para:

• encontrar o registro sobre a pessoa e citá-lo (veja "Cite os registros" abaixo);
• capturar detalhes que faltam na tabela: número do registro, data do batismo vs. data de nascimento, nome da criança e dos pais, padrinhos, fiadores em um casamento, padre, causa da morte, idades;
• preencher uma referência de arquivo ausente (fundo/opis/delo) a partir do caminho do catálogo.

O texto é manuscrito reconhecido por máquina. As colunas da tabela saem como linhas separadas, então corresponda datas e idades às suas colunas por ordem e trate números e nomes raros com cuidado. Para procurar registros que não têm link na tabela (ex.: um registro de morte), tente yandex_archive.py search "<formas de nome, lugar>". Seus trechos vêm de marcação estruturada e às vezes são mais legíveis que as linhas da página (ex.: uma idade). Registre cada busca que você tentou, para que um resultado negativo possa ser relatado.

Registre cada revisão de arquivo. Antes de revisar um delo ou um conjunto de digitalizações, verifique family_tree_github/internal/checks/reviewed_documents.md (interno, não no site) — pode já ter sido pesquisado. Após revisar um — um livro métrico lido para esta pessoa, uma pesquisa no Yandex Archive, um delo folheado em busca de um registro faltante — adicione ou estenda sua entrada lá, incluindo resultados negativos: o que (arquivo, fundo, opis, delo ou caminho das digitalizações), data, como (todas as folhas / amostra / apenas pesquisa), o que foi pesquisado (nomes, lugares), resultado (encontrado → [A…] ou quadros; não encontrado → «искали …, не нашли»), o que permanece não lido. Grandes coleções de digitalizações são pesquisadas com a habilidade archive-scan-search; livros métricos completos são indexados com a habilidade metric-book-index.

2. Extraia fatos e reconcilie-os

Antes de escrever, tenha uma lista de fatos por evento com sua fonte de apoio (da habilidade chronology-table quando a entrada é uma tabela), com idades, variantes de nome, mudanças de status, família e lacunas reconciliadas. Explique as transições de status claramente; veja references/terms.md.

3. Escreva a biografia

A tabela de entrada não é uma fonte — nunca a mencione. A tabela cronológica (e qualquer outra nota de trabalho que o usuário fornecer) é o arquivo de pesquisa privado do usuário; os leitores do site não sabem que ela existe e não sabem nada sobre genealogia ou pesquisa em arquivos. Portanto, em todos os textos de saída:

• Nunca escreva "na tabela", "pela tabela", "da tabela", "nos dados originais", "coluna", "linha N" e similares. Cite apenas fontes reais: registros de arquivo, digitalizações, publicações, sites.
• Onde nada for conhecido, diga-o em termos gerais: "nas fontes disponíveis não há informação sobre isso", "o texto literal do registro não está disponível", "o código de arquivo é desconhecido", "não foi possível encontrar a digitalização".
• Uma transcrição da coluna de comentários é chamada apenas de "decodificação" (o texto do registro), não "decodificação da tabela".
• Erros e lacunas na própria tabela (prefeitura errada, data de nascimento fornecida em vez de data de batismo, linhas sem lugar, nomes escritos errados) não são discutidos na biografia: use o valor correto no texto e relate o problema da tabela ao usuário no chat (etapa 6). Mencione uma grafia variante nas notas apenas se ela aparecer em uma fonte real.
• Explique tudo para um leitor leigo: o que é um tipo de registro, o que significa uma abreviatura ou um status.

Fundamente cada afirmação factual nos dados de entrada. Nunca invente datas, lugares, parentes, profissões, causas ou motivos. Quando os dados forem omissos, fique em silêncio ou diga claramente que os registros não mostram isso. Frases como "provavelmente", "possivelmente" são permitidas apenas para inferências razoáveis diretamente apoiadas pelos dados (ex.: uma mudança inferida a partir de registros em um novo lugar) e devem ser marcadas como inferências. Uma hipótese de trabalho (ex.: que dois registros são a mesma pessoa) vai em «Notas de pesquisa», começando com Suposição (não confirmada por documentos).

Prove o vínculo de parentesco elo por elo. Cada vínculo pai-filho e cônjuge é uma afirmação separada com suas próprias fontes; um avô ou ancestral mais distante é provado apenas através de uma cadeia de elos comprovados. Ao escrever sobre um vínculo:

• Diga em que ele se baseia. Um vínculo nomeado em um registro é escrito como tal («de acordo com o registro de nascimento de 1919»), não como um fato estabelecido a partir de muitas fontes. Ele conta como confirmado por vários documentos apenas se eles forem independentes: uma cópia, extrato, certidão ou recontagem do mesmo registro é a mesma fonte.
• Um patronímico apenas nomeia o pai ("Iakovlevitch" = pai chamado Iákov); não mostra qual Iákov. Sobrenome, vila ou domicílio compartilhado também não são evidência de parentesco.
• Mantenha homônimos completos (mesmo nome e patronímico, mesma vila) como pessoas separadas até que os registros os distingam; um homônimo de fora da árvore tem sua própria página de comparação.
• Quando os registros discordam (ex.: o patronímico de uma mãe), forneça ambas as versões lado a lado com quem forneceu a informação e quando: um registro feito no evento ou pela própria pessoa geralmente tem mais peso do que um posterior feito por outros. Registre-o em research_open_questions.md.
• Uma história de família ou nota do compilador é uma pista, não um documento: atribua-a «de acordo com as anotações do compilador» e nunca a apresente como um registro.

Breve contexto histórico é bem-vindo quando ajuda o leitor a entender um registro (o que foi a colônia penal de Sacalina, o que foi o censo de Tchekhov de 1890, o que significava ser padrinho, o que o status "exilado-colono" permitia). Mantenha-o curto, geral e claramente sobre a época — nunca o apresente como um fato sobre esta pessoa.

Sempre descreva lugares visitados. Sempre que a pessoa visitou um local específico — um templo, santuário, igreja, mosteiro, museu, castelo, fazenda, fábrica, parque, escola, memorial, etc. — adicione uma breve descrição (2–5 frases): o que é, onde exatamente fica, quando e por quem foi fundado, pelo que é conhecido, o que um visitante vê lá. Pesquise os fatos (site oficial, Wikipédia, enciclopédias) e mantenha-os precisos; a conexão da própria pessoa com o lugar (com quem, o que fizeram lá) vem apenas dos dados. Uma cidade, vila ou região por si só não precisa de descrição (uma linha curta de contexto é opcional). Se o nome de um local nos dados parecer escrito errado ou não puder ser encontrado, use o nome real mais provável no texto e anote a grafia original na seção de notas.

Cite os registros. Onde quer que o texto de um registro esteja disponível (uma transcrição na coluna de comentários da tabela, ou texto reconhecido da digitalização), cite-o literalmente, na forma: De acordo com o registro no livro métrico: «Корсаковской тюрьмы ссыльно-каторжная Евдокія Андреева Лапина…» [A1000]. Isso se aplica a cada evento: nascimentos, mortes (incluindo a causa e a idade como escritas), casamentos, padrinhados, censos e listas de confissão.

• Mantenha a grafia original, incluindo ortografia pré-reforma e variantes de nome.
• Na biografia, corrija erros óbvios de OCR silenciosamente. Na página da fonte, mostre-os entre colchetes: Корсаковскаго [no reconhecimento: «Корожковскаго»].
• Interpretação e explicação são bem-vindas e ficam no texto. Coloque-as ao lado da citação, não em vez dela, ex.: «…(старoсти)» — ou seja, morreu de velhice.
• Se nenhum texto existir (sem transcrição na tabela e sem digitalização ou uma ilegível), diga-o claramente no texto: "O texto literal do registro não está disponível, não foi possível encontrar a digitalização." Nunca parafraseie um registro como se ele tivesse sido citado.
• De onde vem uma citação é declarado em sua página de fonte, não na biografia (veja "Rótulo de origem do texto" na etapa 4). A explicação geral desses rótulos e das marcas [?], […], [ilegível], [no reconhecimento: «…»] vive uma vez na seção «Откуда взяты цитаты» de docs/sources/index.md; não a repita nas páginas de pessoa.

Cite inline. Após cada afirmação, adicione o ID da fonte entre colchetes: ...nasceram os gêmeos Ivan e Maria [A1000]. Vários em sequência: [B1000][A1005]. Cada ID usado deve ter uma página, e cada página de fonte desta pessoa deve ser citada pelo menos uma vez.

Vincule pessoas. Quando uma pessoa que tem sua própria página é mencionada, vincule-a: [Egor Pocherevin](P1001) no texto corrido, [P1001] em listas (renderiza como o nome completo). Pessoas sem página ficam em texto simples — não crie páginas para todos os mencionados.

Idioma. Escreva no idioma que o usuário pediu. Se não especificado, use o idioma do conteúdo da tabela (para tabelas em russo — russo). Mantenha nomes e texto de registro citado em sua forma original; ao escrever em outro idioma, translitere nomes e forneça o original entre parênteses na primeira menção.

Estrutura (adapte os cabeçalhos à vida da pessoa; pule seções sem dados):

---
person_id: P1005
name: "Nome Patronímico Sobrenome"
name_variants:
  - "<como registrado nos documentos>"
birth_date: "1885-07-15"        # ISO; "1851/1857" para um intervalo; "" se desconhecido
birth_date_status: confirmed    # confirmed | probable | unknown
death_date: ""
death_date_status: unknown
parents: [P1000]                # apenas IDs de pessoas que têm páginas
spouses: []
children: []
sources: [A1000, A1005]
---

# <Nome completo> (<ano de nascimento ou intervalo> – <ano da morte>)

<Resumo de um parágrafo: quem, onde, o arco da vida em 3–4 frases.>

NÃO adicione um parágrafo explicando códigos de fonte ("Códigos entre colchetes — ...", tipos de fonte,
observações sobre OCR). Essa explicação geral vive uma vez em docs/research-method.md e
docs/sources/index.md, não nas páginas de pessoa.

## <Período de vida 1, ex.: Origens>
## <...>
## <Últimos anos e morte>

## Família
<Cônjuges e filhos com datas, como uma lista curta; vincule aqueles que têm páginas.>

## Cronologia
| Data | Evento | Lugar | Fonte |
<Tabela compacta, uma linha por linha da entrada.>

## Observações sobre documentos
<Discrepâncias em idades, nomes, datas; lacunas; dúvidas não resolvidas que valem pesquisa adicional;
quais registros não têm texto disponível; leituras de OCR que precisam ser verificadas contra a digitalização.>

## Notas de pesquisa
<Hipóteses e pistas de pesquisa, cada uma marcada «Suposição». Pule se não houver.>

## Fontes
- [A1000] — <descrição curta>
- ...

## Pessoas relacionadas
- <papel> — [P1000]

4. Páginas de fonte (obrigatórias quando existem fontes)

Uma página por documento distinto, compartilhada por todas as biografias. Se várias linhas citarem o mesmo registro, cite o mesmo ID. Antes de criar uma página, pesquise por ela (next_id.py find por referência de arquivo, URL da digitalização, código original): se existir, reutilize o ID, adicione quaisquer novos detalhes ou citações sobre esta pessoa a essa página e adicione a pessoa ao seu related_people e «Pessoas relacionadas».

Escolhendo o prefixo — pelo papel do material, não onde está armazenado:

• A — um registro de arquivo: entrada de livro métrico, lista de confissão, ficha de censo, arquivo. A página contém a referência do arquivo (архив, фонд, опись, дело, лист) e o link da digitalização. Use A mesmo quando a referência for desconhecida, mas claramente for um registro de arquivo.
• D — um arquivo ou documento concreto (digitalização/PDF local, notas do compilador, certidão). Por enquanto, fontes D não são publicadas: não crie …

[truncado para tradução]