~/guides/FAMILY.md

Guides / Prompts

Ask Claude to draw a five-generation family tree: 4 prompts, from one round of questions to a Mermaid chart

4 prompts: ask for all the data at once, map the migration route, find what is missing, draw a Mermaid tree. Claude can't search records; the data is yours.

Watch the reel on InstagramComment #FAMILY to get this guide

I used 4 prompts to get Claude to draw a five-generation family tree. One thing first: Claude can't search household registration records, and it can't find long-lost relatives. Every name on the tree has to come from you. What it's good at is asking the right questions, organising your answers, telling you what's missing and drawing the chart. This guide gives you: ① all 4 prompts, ② Claude's real reply to each, ③ how to fill the gaps at a Taiwan household registration office, ④ how to paste the code into mermaid.live to get the picture, and ⑤ what not to paste into an AI. The demo "Lin family" uses made-up names and years. The chat screens are demo pages we laid out ourselves, not claude.ai screenshots, but the text in them is Claude Haiku's reply word for word from 23 October 2026. The other images are frames from our reel, starring our orange block mascot.

01The result first: a five-generation tree drawn by Claude

Five-generation family tree from great-grandparents down to a nephew, each couple sharing one box
The real result of prompt 4: Claude's Mermaid code, rendered (demo family, all fictional).

The tree runs from the great-grandparents down to the fifth generation: Lin Wan-de, Lin Jin-shui, Lin Zhi-ming, Lin Yu-xuan, Lin Rui. Each couple sits in one box, a † follows the names of those who have died, and the mother's side is joined in too. I didn't draw it. Claude wrote the code, and Mermaid, a free tool, turned it into a picture.

  1. Prompt 1: build a family tree, and ask for everything it needs in one go.
  2. Prompt 2: from the surname and hometown, map the migration route, marking guesses as "estimated".
  3. Prompt 3: list what data is still missing, and where in Taiwan to find it.
  4. Prompt 4: draw it as a Mermaid family tree, straight to a picture.
Registration office scene: a locked cabinet stamped "can't search", a "my data" folder, the orange mascot
People say AI can find long-lost relatives? It can't. It can't search records; the data comes from you.

You often see claims that "AI found relatives I never knew existed". Chat AIs like Claude aren't connected to Taiwan's household registration system and can't look up anyone's records. They only use what you give them. So I flipped the order: let Claude ask you first, then tell you what's missing, fill the gaps through official channels yourself, and only then draw the tree.

02Prompt 1: get it to ask for everything at once

Prompt 1 (start a new chat and paste it)
Help me build a complete family tree. Ask me for all the information you need in one go, and I'll answer it all at once.
Demo chat page: the user asks Claude to build a family tree, and Claude replies with 9 questions in three groups
Real test: it listed 9 questions in three groups (2026-10-23, Claude Haiku, demo page in our layout).

"In one go" is the key. Without it, Claude often asks one question at a time and you go back and forth for ages. With it, you get one checklist: names, birth years, who has died, any remarriage or adoption, and where the family comes from.

I turned its 9 questions into an answer sheet. Replace the [ ] parts with your family's details and paste it back.

Answer sheet (replace the [ ] parts; birth year only for living people)
My answers:
1. Me: [name], [birth year]; spouse: [name], [birth year]
2. Parents: [father's name, birth year], [mother's name, birth year]
   Grandparents: [names, birth years; add the year of death if they have died]
   Great-grandparents: [if you know them]
3. Siblings: [names, birth order, birth years]
4. Children: [names, birth years]
5. Family members who have died: [names, years of death]
6. Remarriage, adoption or other special relationships: [write "none" if none]
7. Ancestral home and places the family moved: [e.g. Quanzhou, Fujian → Lukang, Changhua → Taichung → Taipei]
8. Layout: vertical, older generations at the top
9. Photos: no

03Prompt 2: map the migration route from surname and hometown

Prompt 2 (same chat, after you've answered the questions)
Based on my surname and where my family comes from, map out the family's migration route and how far back we can trace it. Use only the information I gave you, mark anything uncertain as an estimate, and don't make up any names.
Demo chat page: Claude maps Quanzhou to Lukang, Taichung and Taipei, the last hop marked "estimated"
Real test: a three-hop route, and it marked the hop it wasn't sure about as "estimated" (2026-10-23, Claude Haiku).

For the demo family I only wrote "our ancestors came from Quanzhou and lived in Lukang, Taichung and Taipei". Claude laid that out as a three-hop route, and marked the parents' move to Taipei as "estimated, around the 1990s" because I hadn't given a year. It also said plainly that the great-grandparents are as far back as the data goes.

04Prompt 3: what's missing, and where to find it

Prompt 3
List what information this family tree is still missing, and where in Taiwan I can find it. Only list what's really missing, give one place to look for each item, and don't make up any relatives.
Demo chat page: Claude lists 5 missing items, each with where to look; the household transcript line is highlighted
Real test: 5 missing items, each with a place to look (2026-10-23, Claude Haiku).

This prompt turns "AI finds your relatives" into "AI tells you where to look". The demo family was missing: generations above the great-grandparents, the great-grandparents' birthplaces, the mother's grandparents, the exact years of each move, and the home village in Quanzhou. The places it suggested were the family genealogy book, ancestral tablets, the clan hall, older relatives' memories, and the most concrete one: a household registration transcript (戶籍謄本) from a registration office.

05Filling the gaps: household registration transcripts

The Department of Household Registration (Ministry of the Interior) page on requesting household transcripts is clear. I checked it on 23 October 2026:

  1. Where: you can apply for a household transcript at any household registration office in Taiwan, not just the one where you're registered.
  2. Fee: NT$15 per page for a household transcript.
  3. Who can apply: the person themselves or an interested party; if you can't go in person, you can authorise someone in writing. An interested party only gets the part they have an interest in.
  4. Exception: to view the original registration records, apply at the office where they were originally registered.
  5. What to bring and how to authorise someone: follow the official page and check it before you go.
Official page screenshot: NT$15 per transcript page and any registration office in Taiwan, both highlighted
The official page: NT$15 per page, any registration office in Taiwan (screenshot 2026-10-23, highlights ours).

Records from the Japanese era exist too. Taipei City's procedures, for example, list a "Japanese-era household survey register transcript" (日據時期戶口調查簿謄本) among the types of household transcript: copies of the household survey registers from 1906 (Meiji 39) onward. Your great-grandparents' names and birthplaces are often in there.

Taipei City regulation screenshot: item 5, the Japanese-era household survey register transcript, highlighted
Taipei City procedures: the Japanese-era register is one of the transcript types (screenshot 2026-10-23).

06Prompt 4: draw it as a Mermaid family tree

Prompt 4 (ask once the data is complete)
Draw this family tree as a Mermaid diagram (graph TD), older generations at the top, using the names and years I gave you, with † after anyone who has died, and only the information I gave you. Put each married couple in the same subgraph, then connect the couple to their children; order siblings left to right by birth year.

Mermaid is a way of drawing diagrams with text. Claude doesn't hand you an image; it gives you a block of code, and Mermaid's online editor turns that into a picture. Below is the code it actually gave me. Copy it and try it to see what you'll get.

The code Claude gave me (fictional demo family; paste it straight into mermaid.live)
graph TD
    subgraph GG[" "]
        direction LR
        LWD["林萬得<br/>1905–1979 †"]
        WGS["王罔市<br/>1910–1988 †"]
    end
    subgraph G1[" "]
        direction LR
        LJS["林金水<br/>1938–2015 †"]
        HAT["黃阿桃<br/>1941 年生"]
    end
    subgraph MG[" "]
        direction LR
        CJC["陳進財<br/>1940–2010 †"]
        LXY["李秀英<br/>1943 年生"]
    end
    LHZ["林志豪<br/>1963 年生"]
    subgraph P[" "]
        direction LR
        LZM["林志明<br/>1966 年生"]
        CMH["陳美惠<br/>1968 年生"]
    end
    LSF["林淑芬<br/>1970 年生"]
    subgraph C5[" "]
        direction LR
        LYX["林宇軒<br/>1993 年生"]
        CYZ["張雅筑<br/>大嫂"]
    end
    LVA["林薇安(我)<br/>1996 年生"]
    LRU["林睿<br/>2022 年生"]

    GG --> LJS
    G1 --> LHZ
    G1 --> LZM
    G1 --> LSF
    MG --> CMH
    P --> LYX
    P --> LVA
    C5 --> LRU
  1. Open mermaid.live. No login needed.
  2. Delete the sample code in the Code panel on the left.
  3. Paste Claude's code (from graph TD to the last line, without the explanation around it).
  4. The tree appears on the right straight away. If you can't see all of it, click the fit-to-view frame icon at the top right.
  5. To keep it, a screenshot is the quickest way.
Mermaid Live Editor: Claude's code on the left, the five-generation tree drawn on the right
The same code in mermaid.live, drawn without logging in (screenshot 2026-10-23).

I only added "put each married couple in the same subgraph" after a few tries. Without it, Claude's first two attempts drew the spouse on the row below, which reads as parent and child, so the whole tree read wrong. With it, couples sit side by side in one box and the children hang below that box. It reads at a glance.

07Good to know

Night-time room: a masked ID card stamped "don't paste" in red, a birthday card, the mascot frowning
ID numbers and living relatives' birthdays: don't paste them.
  1. Claude can't search household registration records or find long-lost relatives. Every name and year on the tree comes from what you give it.
  2. Don't paste ID numbers, full addresses or living relatives' full birthdays. A family tree only needs names and years.
  3. Anything marked "estimated" is a guess. Don't write it into the family record as fact; check it against a transcript or the genealogy book first.
  4. Household transcripts aren't open to anyone: only the person, an interested party or someone they authorise can apply, and an interested party only gets the relevant part. The official page has the details.
  5. If the family has sensitive history such as adoption, remarriage or estrangement, ask your family before you draw it in or share it.
  6. Mermaid's layout can come out a little differently each time. What matters is that the people and relationships are right; if the layout bothers you, ask Claude to redraw it rather than editing the code.

Sources

Related guides