{"slug": "llm-wiki-wip-gravity-wells", "title": "llm-wiki-wip-gravity-wells", "summary": "A developer created an LLM-maintained wiki called 'jarvas-mnemoteca' that extends the LLM-wiki pattern with 'WIP gravity wells'—bounded capsules where related notes, sources, conversations, and artifacts accumulate around a maturing outcome. The system uses a three-stage input-core-output structure, with the LLM responsible for maintaining the wiki by reading sources, creating pages, and updating content, while the human curates sources and steers emphasis.", "body_md": "Purpose:A personal LLM-maintained wiki for scientific curiosity, research synthesis, ideas, writing, projects, experiments, decisions, dead ends, and lessons learned.\n\nPattern:This extends the LLM-wiki pattern: raw sources are not just retrieved at query time; they are incrementally compiled into a persistent, interlinked markdown wiki.\n\nExtension:This addsWIP gravity wells: bounded capsules where related notes, sources, conversations, decisions, drafts, artifacts, and lessons accumulate around a maturing outcome.\n\nLLM role:Maintain the wiki. Read sources, discuss takeaways, create/update pages, keep links current, surface contradictions, update WIP capsules, answer queries, lint the wiki, and log changes.\n\nAuthority:This repo-local`CLAUDE.md`\n\nis the source of truth for how`jarvas-mnemoteca`\n\nis structured and operated. It may also be read as`AGENTS.md`\n\n. Generic agent habits, external skills, and reusable wiki conventions defer to this file when they conflict. Direct iteration in this repo by the human user and a coding agent is normal and acceptable.\n\nMost LLM document workflows behave like RAG: retrieve raw chunks at query time, answer, then forget the synthesis. This repo is different: the durable artifact is the wiki, updated as sources, notes, conversations, and questions arrive.\n\nThe repo is a simple system with three stages: **input → core → output**.\n\n— immutable evidence and memory dumps (external sources + personal notes).`raw/`\n\nis input— compiled understanding: sources, chapters, concepts, entities, ideas, decisions, and WIP gravity wells.`wiki/`\n\nis core— produced artifacts (decks, reports, exports, code outputs, published drafts).`deliverables/`\n\nis output\n\nThe wiki compounds in two directions:\n\n**Global compounding:** reusable knowledge across sources, concepts, people, fields, methods, and patterns.**Local compounding:** WIP gravity wells where an idea matures into a book, essay, side project, experiment, research arc, tool, product idea, or useful dead end.\n\nRaw material is evidence and memory input. Wiki pages are compiled understanding. WIP capsules are local workspaces inside the wiki. Deliverables are produced artifacts; they can be linked from WIP and summarized back only when they contain durable lessons, decisions, or synthesis.\n\nHuman role: curate sources, dump notes, steer emphasis, ask questions, make taste/judgment calls. LLM role: summarize, integrate, cross-link, update, lint, and preserve the trail.\n\n```\n./\n├── CLAUDE.md                       # this schema file (also readable as AGENTS.md)\n├── skills/                         # optional root-level expanded workflows\n├── raw/                            # INPUT — immutable source material (never modified)\n│   ├── external/                   # papers, posts, books, repos, transcripts, datasets\n│   └── personal/                   # idea dumps, devlogs, conversations, reflections\n├── wiki/                           # CORE — compiled understanding\n│   ├── 00_INDEX.md                 # content catalog; read first\n│   ├── log.md                      # chronological append-only operation log\n│   ├── sources/                    # one summary page per external source\n│   ├── personal/                   # one distillation per personal raw note\n│   ├── chapters/                   # broad synthesis pages (NN_Title_Words.md)\n│   ├── concepts/                   # reusable concepts, methods, terms, patterns\n│   ├── entities/                   # people, tools, models, datasets, works\n│   ├── organizations/              # companies, labs, institutions\n│   ├── ideas/                      # durable idea backlog before WIP\n│   ├── decisions/                  # cross-WIP or durable personal decisions\n│   └── wip/                        # WIP gravity wells\n│       └── WIP_Name/\n│           ├── README.md           # hub: latest truth, status, next steps\n│           ├── Map.md              # sources/concepts/links and why they matter here\n│           ├── Log.md              # dated progress, roadblocks, lessons\n│           ├── Decisions.md        # local decisions and rationale\n│           └── Output.md           # optional draft/spec/outline; explicit edits only\n└── deliverables/                   # OUTPUT — produced artifacts, exports, decks, reports, code outputs\n```\n\nRules:\n\n`raw/`\n\n(input) and`deliverables/`\n\n(output) sit at the repo root, outside`wiki/`\n\n, so the input → core → output flow stays legible.`skills/`\n\nis root-level so Claude/Codex-style agents can discover it normally. It is optional and created only when a workflow is too detailed for this file.- The master index is\n`wiki/00_INDEX.md`\n\n(kept from this repo's history; equivalent to the generic`index.md`\n\n). - Chapters synthesize across pages; specific facts belong in source, concept, entity, organization, idea, or WIP pages.\n- Keep directory names boring. The agent should never have to guess where a page belongs.\n\nUse `Title_Case`\n\nwith underscores. Wikilinks omit `.md`\n\n. Prefer bare page names (`[[Cell_Painting]]`\n\n) since Obsidian resolves unique filenames from anywhere in the vault; use a path when a name is ambiguous, e.g. WIP docs (`[[wip/My_Book/README]]`\n\n).\n\n| Kind | Pattern |\n|---|---|\n| External raw | `raw/external/Author_Year_ShortTitle/` |\n| Personal raw | `raw/personal/YYYY-MM-DD_Short_Title.md` |\n| External summary | `wiki/sources/Author_Year_ShortTitle.md` |\n| Personal summary | `wiki/personal/YYYY-MM-DD_Short_Title.md` |\n| Chapter | `wiki/chapters/NN_Title_Words.md` |\n| Concept/entity/org | `wiki/concepts/Name.md` , `wiki/entities/Name.md` , `wiki/organizations/Name.md` |\n| Idea | `wiki/ideas/Idea_Name.md` |\n| Decision | `wiki/decisions/YYYY-MM-DD_Decision_Title.md` |\n| WIP capsule | `wiki/wip/WIP_Name/README.md` |\n| Deliverable | `deliverables/Artifact_Name.ext` |\n\nFrontmatter template:\n\n```\n---\ntype: source | personal | chapter | concept | entity | organization | idea | decision | wip | wip-doc\nstatus: inbox | backlog | active | paused | shipped | dropped\ntags: []\ndate: YYYY-MM-DD\nupdated: YYYY-MM-DD\nsources: []\nwip: []\n---\n```\n\n`type`\n\nis required. `status`\n\nis mainly for ideas/WIP. `sources`\n\nlinks to source summaries, personal summaries, or raw paths. `wip`\n\nlinks reusable pages to relevant WIP capsules. Useful metadata beats perfect metadata.\n\n| Area | Agent authority |\n|---|---|\n`raw/external/` |\nMay read/add user-provided sources. Never rewrite source contents. |\n`raw/personal/` |\nMay create captured snapshots from chat when asked. Never rewrite snapshots unless explicitly asked. |\n`wiki/sources/` , `wiki/personal/` |\nMay create/update during ingest. |\n`wiki/concepts/` , `wiki/entities/` , `wiki/organizations/` , `wiki/chapters/` , `wiki/ideas/` , `wiki/decisions/` |\nMay create/update when supported by ingest, query writeback, or lint. |\n`wiki/wip/*/README.md` , `Map.md` , `Log.md` , `Decisions.md` |\nMay create/update when a source, note, query, or deliverable is clearly relevant to that WIP. |\n`wiki/wip/*/Output.md` |\nMay create/update only when the user asks for draft, outline, spec, or output editing. |\n`deliverables/` |\nMay create/update only when the user asks for an artifact. May read/link during WIP or artifact queries. |\n`wiki/00_INDEX.md` |\nMust update after every wiki write. |\n`wiki/log.md` |\nAppend only. Must update after every operation. |\n`skills/` |\nMay create/update when a workflow is too detailed for this schema or the user asks. |\n`CLAUDE.md` |\nEdit only when the user asks to change the schema. |\n\nNever delete, rename, restructure, or merge files without explicit user approval. Flag suspected duplicates or stale pages during lint.\n\nA WIP gravity well is a bounded capsule for a maturing outcome: unfinished, speculative, paused, shipped, or dropped. Use `wiki/ideas/`\n\nfor loose ideas. Promote an idea to `wiki/wip/WIP_Name/`\n\nwhen it has gravity: repeated notes, multiple sources, real artifacts, decisions, active work, or a concrete intended output.\n\nRules:\n\n- Global pages explain reusable knowledge; WIP pages explain why that knowledge matters for this outcome.\n- Do not duplicate full source summaries inside WIP folders.\n- Do not bury reusable concepts only inside a WIP; promote them to\n`wiki/concepts/`\n\nand link back. `README.md`\n\nis current truth.`Log.md`\n\nis chronological history.- Dead ends are valid WIP when they contain reusable lessons.\n\n| File | Purpose |\n|---|---|\n`README.md` |\ndescription, origin, status, current state, next steps, outcomes, support docs |\n`Map.md` |\nlinked sources, personal notes, concepts, entities, and WIP-specific relevance |\n`Log.md` |\ndated progress, roadblocks, lessons, experiments |\n`Decisions.md` |\nwhat changed, why, alternatives, consequences |\n`Output.md` |\noptional draft/spec/outline; edit only on request |\n\n`deliverables/`\n\nholds produced artifacts: reports, slide decks, PDFs, exports, generated charts, code outputs, and submitted drafts. Deliverables are outputs of the wiki/WIP process, not independent evidence by default.\n\nRules:\n\n- Link deliverables from relevant WIP hubs under\n`Outcomes`\n\nor`Artifacts`\n\n. - Keep active drafts/specs/outlines in\n`wiki/wip/WIP_Name/Output.md`\n\n; keep exported/final artifacts in`deliverables/`\n\n. - Do not use deliverables as evidence for external facts unless they cite primary sources.\n- The LLM may summarize durable lessons, decisions, or reusable synthesis from a deliverable back into wiki/WIP pages; mark this as artifact-derived.\n- Edit deliverables only when the user asks.\n\nUse for papers, books, posts, docs, repos, talks, datasets, and other external material.\n\nSource-type hints: papers/PDFs preserve methods, evidence, limitations; blogs/newsletters need date and staleness; GitHub repos/docs need purpose, API surface, install complexity, license, maintenance status.\n\n- Read the raw source from\n`raw/external/`\n\n. - Surface 2-3 takeaways, contradictions, new concepts/entities, and possible WIP relevance.\n- Create/update\n`wiki/sources/Author_Year_ShortTitle.md`\n\nwith citation/URL, TL;DR, key claims, evidence/methods, limitations, signals/implications, and WIP relevance. - Update relevant global pages: concepts, entities, organizations, chapters, ideas, decisions.\n- If clearly relevant to a WIP, update its\n`README.md`\n\n,`Map.md`\n\n,`Log.md`\n\n, or`Decisions.md`\n\n. - Update\n`wiki/00_INDEX.md`\n\nand append an`ingest`\n\nentry to`wiki/log.md`\n\n.\n\nUse for idea dumps, devlogs, roadblocks, WIP updates, reflections, plans, outcomes, conversations, artifacts, and dead ends.\n\n- If the note came from chat and the user wants it kept, capture it under\n`raw/personal/YYYY-MM-DD_Short_Title.md`\n\n. - Create\n`wiki/personal/YYYY-MM-DD_Short_Title.md`\n\nwith a concise distillation. - Extract durable material: ideas, WIP membership, state changes, lessons, decisions, next actions, reusable concepts, dead ends.\n- Update relevant\n`wiki/ideas/`\n\n,`wiki/wip/`\n\n,`wiki/decisions/`\n\n,`wiki/concepts/`\n\n, or`wiki/chapters/`\n\npages. - Update\n`wiki/00_INDEX.md`\n\nand append a`personal-ingest`\n\nentry to`wiki/log.md`\n\n.\n\n- Read\n`wiki/00_INDEX.md`\n\nfirst unless the user names specific files. - Read relevant compiled pages before raw sources.\n- Answer with wikilinks where useful.\n- If the answer creates durable synthesis, update/create the appropriate wiki/WIP page and log a\n`query`\n\nor`update`\n\nentry.\n\n| Question intent | Start with |\n|---|---|\n| Facts, methods, papers, orgs, people, tools | `wiki/chapters/` , `wiki/concepts/` , `wiki/sources/` , `wiki/entities/` , `wiki/organizations/` |\n| My ideas, WIP, roadblocks, next steps | `wiki/wip/` , `wiki/ideas/` , `wiki/personal/` , `wiki/decisions/` |\n| What should this become? | relevant WIP hub, idea page, personal summaries, then global concepts/sources |\n| What does this source imply? | source summary, concepts, chapters, then related WIP/ideas |\n| Where is the artifact/output? | relevant WIP hub, then `deliverables/` ; artifacts are not independent evidence |\n\nOutput defaults: synthesis = markdown prose with wikilinks; comparison = table; artifact = ask before creating slides, charts, reports, exports, or polished deliverables.\n\nConflict rule: source-backed pages are stronger for external facts; personal/WIP pages are stronger for user intent, project state, and interpretation. Surface mismatches.\n\nRun periodically or when the wiki feels stale. Check for contradictions, stale claims, orphan pages, missing links, missing concepts/entities, uncompiled raw personal notes, WIP without current state/next steps, reusable knowledge trapped inside WIP, outdated index entries, and deliverables that should be linked from WIP outcomes.\n\nSafe lint fixes: broken index entries, missing backlinks, obvious metadata repairs, log entry. Ask first: deleting, renaming, large rewrites, merging pages, changing WIP status, editing outputs/deliverables.\n\nAppend a `lint`\n\nentry to `wiki/log.md`\n\nwith issues found, fixed, and open.\n\n`wiki/00_INDEX.md`\n\nis content-oriented: links, one-line summaries, useful metadata, and reading order. The LLM reads it first for most queries and updates it after every ingest or writeback.\n\nRecommended sections: Reading Order, Vault Map, Active WIP, Idea Backlog, Recent Personal Summaries, Decisions, Source Summaries, Chapters, Concepts, Entities, Organizations, Deliverables, Needs Attention.\n\n`wiki/log.md`\n\nis chronological and append-only. It records ingests, personal ingests, queries, lints, updates, restructures, decisions, WIP promotions, and artifact creation.\n\n```\n## [YYYY-MM-DD] <op> | <title>\n- Inputs: raw/source paths or pages read\n- Pages touched: links to created/updated pages\n- Key update: one sentence\n- Open questions: optional\n```\n\nCommon ops: `ingest`\n\n, `personal-ingest`\n\n, `query`\n\n, `lint`\n\n, `update`\n\n, `restructure`\n\n, `decision`\n\n, `wip`\n\n, `artifact`\n\n.\n\nUse sections as needed. Do not force empty headings.\n\n| Page type | Useful sections |\n|---|---|\n| Source | citation/URL, TL;DR, key claims, evidence/methods, limitations, signals/implications, WIP relevance |\n| Personal summary | raw input, TL;DR, extracted signals, pages updated, next actions |\n| Concept | definition, why it matters, mechanism, examples, sources, related WIP |\n| Idea | one-liner, why it matters, possible shape, questions, next step, related WIP/sources |\n| Decision | decision, context, options, rationale, consequences, links |\n| WIP hub | description, origin, status, current state, map, decisions, open questions, next steps, outcomes/artifacts |\n| Chapter | overview, current synthesis, key concepts, important sources, open questions |\n\nDomain-specific page conventions may live in `skills/`\n\n, e.g. paper-ingest details, organization profiles, literature-review workflows, code-repo reviews, or writing workflows.\n\nRepo: `git@github.com:jarvashq/jarvas-mnemoteca.git`\n\n**Always commit as the bot — never as the human user.** This is already set in the local repo config; do not override with a human identity.\n\n```\ngit config user.name \"jarvas-bot\"\ngit config user.email \"jarvas-bot@users.noreply.github.com\"\n```\n\nCommit after every meaningful wiki operation. Commit message:\n\n```\n<op>: <title>\n\n<one-line summary matching log.md entry>\n```\n\nPush only when the user asks.", "url": "https://wpnews.pro/news/llm-wiki-wip-gravity-wells", "canonical_source": "https://gist.github.com/peterdays/54a8fd9f8a01355ec27a43ac3c49650a", "published_at": "2026-07-09 15:36:53+00:00", "updated_at": "2026-07-15 14:23:13.847589+00:00", "lang": "en", "topics": ["large-language-models", "developer-tools", "ai-tools"], "entities": ["jarvas-mnemoteca"], "alternates": {"html": "https://wpnews.pro/news/llm-wiki-wip-gravity-wells", "markdown": "https://wpnews.pro/news/llm-wiki-wip-gravity-wells.md", "text": "https://wpnews.pro/news/llm-wiki-wip-gravity-wells.txt", "jsonld": "https://wpnews.pro/news/llm-wiki-wip-gravity-wells.jsonld"}}