Suggest edit — AGENTS.md — schema for this LLM wiki

Title

Name

Note

---
title: AGENTS.md — schema for this LLM wiki
visibility: public
---

# AGENTS.md

This is an **LLM wiki** in the [Karpathy](wiki/entities/andrej-karpathy.md) 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

- `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.md` AND any concept page where he's an originator.

## Ingestion protocol

When a new raw source is added:

1. Drop the source into `raw/` (immutable).
2. Append an entry to `log.md` with date, source filename, and a one-line summary.
3. 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.
4. Update `index.md` to list any new pages.
5. 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: speculative` and 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.