autoresearch-genealogy

What this skill does

# autoresearch-genealogy

> Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.

A structured system of autoresearch prompts, Obsidian vault templates, archive guides, and methodology references for AI-assisted genealogy research. Built for Claude Code's autonomous research loops, adaptable to any AI tool or manual workflow.

---

## What This Project Does

- Provides 12 Claude Code `/autoresearch` prompts that autonomously search the web, update your vault, and self-verify results
- Supplies a complete 19-file Obsidian vault starter kit with YAML frontmatter and markdown templates
- Includes 24 country/region-specific archive guides (Europe, Americas, Oceania, Jewish genealogy)
- Offers 9 methodology reference documents covering confidence tiers, DNA guardrails, naming conventions, and source hierarchy
- Defines 7 step-by-step workflows for OCR pipelines, oral history, discrepancy resolution, and phase planning

---

## Installation

```bash
# Clone the repository
git clone https://github.com/mattprusak/autoresearch-genealogy.git
cd autoresearch-genealogy

# Copy vault template into your Obsidian vault
cp -r vault-template/ ~/path/to/your/ObsidianVault/genealogy/

# Or copy to any markdown editor folder
cp -r vault-template/ ~/Documents/my-genealogy/
```

No package manager or build step required — this is a pure markdown/prompt project.

---

## Project Structure

```
autoresearch-genealogy/
├── prompts/              # 12 autoresearch prompt files for Claude Code
├── vault-template/       # 19-file Obsidian vault starter kit
│   ├── Family_Tree.md
│   ├── Research_Log.md
│   ├── Open_Questions.md
│   ├── templates/        # Person, certificate, postcard, region, etc.
│   └── ...
├── archives/             # 24 country/region research guides
├── reference/            # 9 methodology documents
├── workflows/            # 7 step-by-step process guides
└── examples/             # 6 anonymized worked examples
```

---

## Quick Start Workflow

### Step 1: Seed your family tree

Open `vault-template/Family_Tree.md` and fill in what you already know, starting with yourself and working backward:

```markdown
---
title: Family Tree
last_updated: 2026-03-19
generations_documented: 3
lines_active: 2
---

# Family Tree

## Generation 1 (Self)
- **Name**: Jane Smith (b. 1985, Chicago, IL)

## Generation 2 (Parents)
- **Father**: John Smith (b. 1955, Detroit, MI)
- **Mother**: Mary O'Brien (b. 1958, Boston, MA)

## Generation 3 (Grandparents)
- **Paternal Grandfather**: Robert Smith (b. ~1920, unknown)
- **Paternal Grandmother**: Helen Kowalski (b. ~1925, Poland?)
```

### Step 2: Scan physical documents

Photograph or scan certificates, letters, postcards. Use the OCR workflow:

```
See: workflows/ocr-pipeline.md
```

### Step 3: Run autoresearch prompts in Claude Code

```
/autoresearch prompts/01-tree-expansion.md
```

### Step 4: Audit and verify

```
/autoresearch prompts/02-cross-reference-audit.md
```

---

## Autoresearch Prompts — Reference

Each prompt in `prompts/` follows this structure:

```markdown
## Goal
[What this iteration should accomplish]

## Metric
[Measurable success condition — e.g., "increase sourced person files from N to N+10"]

## Direction
[Step-by-step instructions for the AI]

## Verify
[Cross-check to run after each iteration]

## Guard Rails
[What NOT to do — prevent hallucination, preserve source rigor]

## Iterations
[How many loops to run before stopping for human review]

## Protocol
[Output format, file naming, YAML fields to populate]
```

### All 12 Prompts

| File | Purpose |
|------|---------|
| `01-tree-expansion.md` | Push every branch back using web research |
| `02-cross-reference-audit.md` | Find and fix discrepancies between tree and sources |
| `03-findagrave-sweep.md` | Locate Find a Grave memorials for deceased ancestors |
| `04-gedcom-completeness.md` | Sync GEDCOM file with vault data |
| `05-source-citation-audit.md` | Verify every person has ≥2 independent sources |
| `06-unresolved-persons.md` | Identify and resolve unnamed people in documents |
| `07-timeline-gap-analysis.md` | Find life events where records should exist but don't |
| `08-open-question-resolution.md` | Systematically attack every open research question |
| `09-bygdebok-extraction.md` | Extract data from digitized local history books |
| `10-colonial-records-search.md` | Search pre-1800 colonial American records |
| `11-immigration-search.md` | Locate passenger manifests and naturalization records |
| `12-dna-chromosome-analysis.md` | Analyze per-chromosome ancestry data |

### Running a prompt in Claude Code

```bash
# In Claude Code terminal or chat:
/autoresearch prompts/08-open-question-resolution.md

# With a specific vault path context:
/autoresearch prompts/03-findagrave-sweep.md --context vault-template/Family_Tree.md
```

---

## Vault Template Files

### Person file template (`vault-template/templates/person.md`)

```markdown
---
full_name: ""
birth_date: ""
birth_place: ""
death_date: ""
death_place: ""
father: ""
mother: ""
spouse: ""
children: []
confidence: "Moderate Signal"  # Strong Signal | Moderate Signal | Speculative
sources: []
open_questions: []
last_updated: ""
---

# [Full Name]

## Life Events

| Event | Date | Place | Source |
|-------|------|-------|--------|
| Birth | | | |
| Marriage | | | |
| Death | | | |

## Sources

1. [Source 1 — type, repository, date accessed]
2. [Source 2 — type, repository, date accessed]

## Open Questions

- [ ] Question 1
- [ ] Question 2

## Notes

[Narrative summary, naming variant notes, contextual history]
```

### Certificate transcription template (`vault-template/templates/certificate.md`)

```markdown
---
document_type: ""        # birth | death | marriage | baptism
document_date: ""
repository: ""
file_reference: ""
transcribed_by: ""
transcription_date: ""
confidence: ""
---

# Certificate: [Type] — [Name] — [Year]

## Transcription

[Verbatim transcription of the document]

## Key Data Extracted

- **Subject**: 
- **Date**: 
- **Place**: 
- **Witnesses/Informants**: 
- **Officiant**: 

## Discrepancies

[Note any conflicts with other sources]

## Image

![[filename.jpg]]
```

### Research log entry pattern (`vault-template/Research_Log.md`)

```markdown
## 2026-03-19 — Tree Expansion Session

**Prompt run**: 01-tree-expansion.md  
**Iterations**: 5  
**Metric start**: 42 sourced person files  
**Metric end**: 51 sourced person files  

### Searches Performed
- FamilySearch: "Kowalski Poznan 1880–1920" — 3 results, 2 useful
- Ancestry: "Smith Michigan census 1920" — found Robert Smith (b. 1919)
- FindAGrave: "Helen Kowalski Detroit" — memorial #12345678

### Negative Results (Important)
- No passenger manifest found for Stanislaw Kowalski, searched 1890–1910
- No church records found for O'Brien line in Cork pre-1850

### New Open Questions
- [ ] Was Robert Smith born in Michigan or Ohio? 1920 census says MI, 1930 says OH.
```

---

## Confidence Tier System

From `reference/confidence-tiers.md`:

```
Strong Signal    — Two or more independent primary sources agree
Moderate Signal  — One primary source, or two secondary sources agree
Speculative      — Logical inference, DNA suggestion, or single secondary source
```

Apply confidence in every person file YAML:

```markdown
---
confidence: "Moderate Signal"
---
```

---

## Archive Guides — Key Countries

Each guide in `archives/` covers:
- Where to find records (free vs paid)
- What AI tools can access directly vs what requires browser
- Record types available by era

```
archives/
├── ireland.md
├── england-wales.md
├── scotland.md
├── norway.md
├── sweden.md
├── poland.md
├── germany.md
├── italy.md
├── france.md
├── spain-portugal.md
├── netherlands.md
├── austria.md
├── hungary.md
├── russia-ukraine.md
├── usa-colonial.md
├── usa-immigration.md
├── usa-census.md
├── usa-vital-records.md
├── african-american.md
├── canada.md
├── mexico-latin-america.md
├── australia-new-zealand.md
├── jewish-genealogy.md