# llmwiki

> Inspired by [Andrej Karpathy's llmwiki gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f).

A personal knowledge base built and maintained by an AI agent (Claude Code).
Drop source documents into `raw/`, then tell the agent to ingest, query, or
lint. The agent owns everything under `wiki/`; you own everything under `raw/`.

## How it works

The agent follows the operations defined in `AGENTS.md`:

- **ingest `<source>`**: summarize a raw document, create or update concept and
  entity pages, cross-link related pages, update the index.
- **query `<question>`**: answer a question from the wiki, optionally filing
  the answer as a new synthesis page.
- **lint**: find contradictions, orphan pages, missing cross-references, and
  low-confidence unsourced claims.

## Directory layout

```
raw/            Source documents (immutable — drop files here)
raw/assets/     Images, PDFs, attachments
wiki/           Agent-maintained knowledge base
wiki/index.md   Catalog of all wiki pages
wiki/log.md     Append-only operation log
AGENTS.md       Agent instructions and page schema
```

## Getting started

1. Clone this repo as your wiki template.
2. Add source documents to `raw/`.
3. Open Claude Code or the pi CLI and run:

   ```
   ingest <filename>
   ```

## Page types

| Type         | Description                                      |
|--------------|--------------------------------------------------|
| `concept`    | An idea, technique, or term                      |
| `entity`     | A person, model, paper, project, or organization |
| `source`     | Summary of a raw document (`src-` prefix)        |
| `synthesis`  | Answer to a query, filed for future reference    |
| `comparison` | Side-by-side analysis of two or more entities    |