AGENTS.md
This is an LLM wiki in the Karpathy sense — a structured markdown knowledge base maintained by an LLM, ingesting raw sources and producing an evolving conceptual map.
The seed source is a single ~2-hour conversation between Jacob Cole and David (otter.ai transcript, April 2026, recorded during a drive through the Bay Area). It's a download of Jacob's full vision: IdeaFlow, Collective Intelligence, Contemplative Practice, Accretive Collective Action, and the Super Conscious State.
Three layers
raw/ — immutable source material. Never edit. New transcripts go here.
wiki/ — LLM-generated pages. Concept, entity, project, practice, theme.
AGENTS.md — this file. How to extend the wiki.
log.md — append-only ingestion record.
index.md — content catalog.
Page types
Every wiki page has frontmatter with a type field. Allowed types:
| Type | Folder | Purpose |
|---|---|---|
concept |
wiki/concepts/ |
A philosophical or technical idea (e.g. wu wei disclosure, sparks of motivation) |
entity |
wiki/entities/ |
A person, organization, or tribe referenced |
project |
wiki/projects/ |
A product, initiative, or scheme Jacob has built or wants to build |
practice |
wiki/practices/ |
A cultivation method (qigong position, meditation framing, NVC) |
comparison |
wiki/comparisons/ |
A side-by-side of two frameworks or approaches |
theme |
wiki/themes/ |
A cross-cutting thread that touches many other pages |
source-summary |
raw/ (companion) |
Optional: an LLM summary of a raw source |
Frontmatter schema
---
title: Human-readable title
type: concept | entity | project | practice | comparison | theme
visibility: public | unlisted | private
sources:
- raw/transcript.md#timestamp
related:
- wiki/concepts/other-page.md
confidence: high | medium | low | speculative
---
confidence: speculative— flag pages that extrapolate beyond what's explicit in raw sources (e.g. orca LLMs, alien contact thought experiments).confidence: low— Jacob mentioned it once in passing.confidence: high— clearly stated, repeated, or central to the conversation.
Linking
- Use
[[Page Title]]Obsidian-style wikilinks for cross-references. WikiHub renders these automatically. - Prefer linking by canonical title (the value in
title:frontmatter), not file path. - A new ingestion can ripple: adding a transcript that mentions Doug Engelbart should update
wiki/entities/doug-engelbart.mdAND any concept page where he's an originator.
Ingestion protocol
When a new raw source is added:
- Drop the source into
raw/(immutable). - Append an entry to
log.mdwith date, source filename, and a one-line summary. - Walk the source. For each entity, concept, or project mentioned:
- If a wiki page exists, update it (add a new
## From <source>section, update related links). - If not, create one following the appropriate folder/type.
- If a wiki page exists, update it (add a new
- Update
index.mdto list any new pages. - Re-check
themes/pages — themes often need ripple updates because they synthesize across sources.
Editorial voice
- Pages are summaries, not transcripts. Quote sparingly; summarize Jacob's framing in the third person.
- Where Jacob coins or borrows a term, attribute it (e.g. "wu wei disclosure" is from Jacob's friend, not Jacob himself).
- Note disagreement or uncertainty explicitly (
confidence:field plus prose). - Don't hide the speculative or paranormal — Jacob explicitly engages with it. Mark
confidence: speculativeand represent it faithfully.
What this wiki is for
Jacob said it directly in the conversation:
"I need to have an LLM wiki for the vision for IdeaFlow in the world that just keeps updating. And I'll put one together tonight. Out of this conversation, we'll keep pushing stuff to it."
So: this is the living, growing index of Jacob's vision. Future conversations, essays, talks, and projects can all be ingested into raw/, and the wiki/ layer should evolve to absorb them.