portersky
e85963af55
Wiki template inspired by Andrej Karpathy's llmwiki gist. Includes agent instructions (AGENTS.md), empty wiki scaffold (wiki/index.md, wiki/log.md), editor config, gitignore, and README documenting the ingest/query/lint workflow.
50 lines
1.8 KiB
Markdown
50 lines
1.8 KiB
Markdown
# 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 |
|