---
name: "agent-maintained-personal-wiki-method"
description: "Use when you need to Turn your notes into a personal wiki kept up to date by a coding agent. Have a coding agent build and maintain a wiki of your notes"
---

# Have a coding agent build and maintain a wiki of your notes

Job: [Turn your notes into a personal wiki kept up to date by a coding agent](https://aiagents.org/canai/agent-maintained-personal-wiki)

## Need

- ai agent

## Steps

1. Put the folder under git and split raw from wiki. Create raw/ and wiki/, add wiki/index.md and wiki/log.md, and commit. Make raw/ read-only in the schema rules. Check: git status is clean and the two folders exist.
2. Write the schema with the agent. Ask the agent to propose the schema: page types, naming, links, source citations, conflicts, and the ingest, query and lint steps. Edit it until it matches how you think. Check: The schema is short, and you agree with every rule in it.
3. Ingest one source and review the diff. Run the ingest prompt on one source. Read every changed page in the diff before you commit. Check: Each new fact links to its source, and no page was duplicated.
4. Ingest in small batches. Add sources one at a time or a few at a time, committing after each. Large batches make diffs hard to review. Check: Each commit holds one ingest and its log line.
5. Query the wiki, and file good answers back. Ask questions against the wiki. When an answer is useful, ask the agent to save it as a page with links to the pages it used. Check: Answers cite wiki pages, and those pages cite raw sources.
6. Lint on a schedule. Run a lint pass weekly or after every ten sources: orphan pages, dead links, duplicate entities and stale reference sections. Approve fixes one by one. Check: The lint report shrinks over time and you approved each fix.
7. Add search when the wiki outgrows the index. When the index and pages no longer fit the agent's context, add per-folder indexes or a local search tool, and keep the wiki as the main record. Check: The agent still finds the right pages for your questions.
8. Optional: The source includes a Claude Code ingest prompt; it is linked there, not copied here.
9. Note: Steps quoted from the Agents Handbook (CC BY 4.0). Works with Claude Code, Codex, Claude Cowork or Gemini CLI. Review each diff before you commit.

## Credit

Method author Agents Handbook editors (CC BY 4.0)
Source: https://agentshandbook.com/p/build-a-personal-knowledge-base-wiki-from-your-notes