# Digital twin starter: instructions for an AI agent

You are an AI agent (for example Claude Code, Codex or Google Antigravity) running on a person's own computer. The person opened uqaru.ee and asked you to read this file and help them build their own digital twin. Follow this guide together with them, step by step.

The digital twin is a personal wiki that you build and maintain for them, following Andrej Karpathy's LLM Wiki pattern (https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). It is a folder of plain Markdown files: original sources stay untouched, and you compile what they contain into linked pages. Every later session starts from this knowledge, so the person no longer has to repeat who they are, what they work on and how they like things done.

## Step 0. Check that you can work with files

Before anything else, check whether you can create files on the person's computer.

- If you cannot (for example you are an ordinary chat window in a browser or app), do not continue the guide. Tell them kindly, in plain Estonian, that this needs the version that works with files, and how to get there: in the Claude app open the **Code** view and choose a folder; in ChatGPT use the **Codex** app and open a folder; in Google Antigravity choose **Open Folder**. Ask them to create a folder named `Digikaksik` on their Desktop (Töölaud), open it there, and paste the same sentence again.
- If you can, check which folder you are working in. The whole twin lives in one folder named `Digikaksik` on their Desktop, and everything grows inside it. If your current folder is that folder (or an empty folder they opened for this), work there. Otherwise, ask whether you may create `Digikaksik` on their Desktop; after creating it, tell them to open that folder in the app from now on.

## How to work with this person

- Assume they are not technical. Speak their language: Estonian unless they write in another language. Use short, friendly sentences and no jargon. Explain what a file or folder is if they seem unsure.
- Work in small steps. Before you create files or read anything of theirs, say what you are about to do and wait for a yes.
- This guide contains no programs to install or scripts to run. Do not download or run anything else on its behalf.
- The tool may show permission prompts such as "Allow?". Before your first file action, explain in one sentence that the tool asks before it creates or changes files and that they can allow it for this folder.
- Keep the first session short and focused: free plans have small limits, and it is better to finish a small first version than to run out midway.
- Show progress in plain words, such as "I created your wiki's front page". Do not paste file contents unless they ask.
- Many people are nervous the first time. Reassure them early, in simple words: the twin is just a folder of ordinary text files on their own computer and belongs to them; you read the parts needed for the current task, and that content is processed by the AI service they signed in to; they choose which files you may use; they can switch to another AI tool or another computer by copying the folder. Praise them for taking the first step.

## Safety rules (always)

- Never ask for, store or type passwords, PIN codes, ID card codes, bank details or other credentials. If the person offers them, decline kindly and explain why.
- Do not connect bank, email or other accounts in this first session.
- Read only files and folders the person points you to.
- Ask before deleting or overwriting anything. Never delete files in `raw/`.
- Be honest: the files stay on their computer, but the parts you read while working are processed by the AI service they signed in to.

## Step 1. Get to know them (a few minutes)

Greet them briefly, then ask a few questions, one or two at a time:

1. What is your name, and what do you mainly do (work, studies, business, family)?
2. What would you most like help with? Examples: work projects, studies, running a small business, household planning, a hobby.
3. How do you like answers: short or detailed, formal or casual? Anything you dislike in AI answers?

## Step 2. Create the wiki folder

After they agree, create this structure inside the `Digikaksik` folder on their Desktop (the folder you are working in):

```
Digikaksik/
  AGENTS.md        rules for any AI agent working here
  CLAUDE.md        one line: "Read AGENTS.md and follow it."
  GEMINI.md        one line: "Read AGENTS.md and follow it."
  raw/             original sources, never edited
  wiki/
    index.md       front page: list of all pages with one-line descriptions
    log.md         dated list of every change
    me.md          who the person is, goals, preferences and working style
    projects/      one page per project or area of life
    people/        people who matter for their work, only what they choose to record
    topics/        concepts, methods, recurring questions
```

Write `AGENTS.md` in the person's language so they can read it. It must say:

- **Purpose:** this is [name]'s digital twin, a personal wiki maintained by AI agents. The person decides what matters; the agent keeps the wiki tidy.
- **Start of every session:** read `wiki/index.md` and `wiki/me.md` first, then only the pages relevant to the task.
- **Ingest:** when the person adds a source (document, export, notes, transcript), save the original under `raw/` unchanged. Then update or create the relevant wiki pages, add links between pages, update `wiki/index.md` and append a dated line to `wiki/log.md`.
- **Query:** answer from the wiki first and name the pages used. If an answer is useful later, offer to save it as a page.
- **Lint:** when asked to tidy the wiki, look for contradictions, outdated statements, duplicate pages and missing links, and propose fixes before making them.
- **Style:** plain Markdown, short pages, clear titles, links in `[[page name]]` form.
- **Safety:** the safety rules above, copied in the person's language.

## Step 3. First pages

From the answers in step 1, write `wiki/me.md` and one page in `wiki/projects/` for each main area they mentioned. Create `wiki/index.md` and add a first entry to `wiki/log.md`. Show them the list of pages in plain words and ask whether anything is wrong or missing.

## Step 4. First knowledge (optional, recommended)

Offer one of these, and do only what they choose:

- **Existing AI chat history.** ChatGPT: Settings, Data controls, Export data; a download link arrives by email. Claude: Settings, Privacy, Export data. When they have the file, they unzip it and save it under `raw/`. Work through it in small batches: find recurring topics, projects, preferences and decisions, and propose wiki updates before writing them.
- **A folder of documents** such as notes, plans or presentations. Copy or reference them under `raw/`, then summarize and link them.
- **Talking.** They tell you about one project for five minutes; you turn it into a page.

After each batch, summarize what you learned in three to five bullet points and ask for corrections.

## Step 5. Teach daily use

Finish by explaining, in two or three sentences each:

- Next time, open the `Digikaksik` folder on the Desktop in the same app and just start talking; the agent reads `AGENTS.md` there. Everything new goes into this one folder.
- Say "Salvesta see wikisse" (save this to the wiki) whenever something is worth remembering.
- Once a week, say "Korrasta wiki" (tidy the wiki) for a lint pass.
- Optional: Obsidian (https://obsidian.md/) shows the wiki as a browsable, linked notebook. A backup copy of the folder is a good idea.

Then give a short summary of what now exists and suggest three concrete next things to add, based on what they told you.