project-wiki: Instructions file for Claude Code

{{PROJECT_NAME}}

Project

• What this is: {{PROJECT_DESCRIPTION}}
• Deliverable: {{PROJECT_DELIVERABLE}}
• Audience: {{PROJECT_AUDIENCE}}
• Owner: {{PROJECT_OWNER}}

New here? This is a project-wiki: an agent-maintained knowledge base that turns scattered source material into a durable, cross-linked synthesis. If the placeholders above are still {{...}}, run /wiki-setup first.

What a project-wiki is

A working repository for building a precise, shared understanding of a problem space — its entities, concepts, decisions, and open questions — out of whatever raw material you can point it at (docs, meeting transcripts, web pages, design files, pasted notes). The agent keeps the synthesis current and consistent as new material lands, and can publish the core of it back out as clean documents.

Architecture

Three layers, inspired by Karpathy's LLM Wiki:

1. Sources (sources/) — faithful captures of external material. One file per source, original URL preserved in frontmatter so we can always re-fetch. Sources are mostly immutable — edited only to fix mistakes.

2. Wiki (wiki/) — the persistent synthesis layer. Markdown pages, owned by the agent, that compile, cross-link, and keep current the understanding extracted from sources. Entity pages, concept pages, decisions, open questions. New sources update existing wiki pages; substantive questions can produce new pages.

3. Schema (this file) — the operating manual. How the wiki is structured, what the conventions are, and how each operation works.

The viewer (viewer/) renders both sources and wiki for browsing + commenting via annotations.

Repo layout

{{PROJECT_SLUG}}/
├── CLAUDE.md              # this file — operating manual (Claude)
├── AGENTS.md              # operating manual for other agents (Codex, etc.)
├── README.md             # human-facing intro + quickstart
├── log.md                # append-only chronological record of operations
├── sources/              # faithful captures of external material
│   ├── INDEX.md          # one-line pointer to each source
│   ├── <slug>.md         # per-source capture
│   └── assets/           # binary assets (images, diagrams)
├── wiki/                 # synthesis layer — agent-owned, interlinked
│   ├── index.md          # wiki page catalog
│   ├── overview.md       # top-level synthesis (the project in one page)
│   ├── open-questions.md # rolling list of unresolved items
│   ├── entities/         # one page per entity
│   ├── concepts/         # one page per cross-cutting concept
│   ├── decisions/        # ADR-style notes for decisions made
│   ├── diagrams/         # mermaid diagrams of the model
│   └── references/       # external / competitive captures used as input
├── annotations/          # user highlights + comments captured in the viewer
│   └── <slug>.json
├── _templates/           # source + wiki page templates
└── viewer/               # Astro web viewer