Track the source-of-truth code, skills, bootstrap rules, docs, and packaging files before adding new features. Exclude local vault config, generated skill mirrors, temporary exports, virtual environments, and business data files from version control. Validation: inspected staged file list and git ignored status before commit.
2.5 KiB
2.5 KiB
Obsidian Wiki — Copilot Context
This project is a skill-based framework for building and maintaining an Obsidian knowledge base using AI coding agents. There are no scripts or dependencies — everything is markdown instructions that the agent executes directly.
Project Overview
- Purpose: Build and maintain an Obsidian wiki using the LLM Wiki pattern (Andrej Karpathy).
- Tech Stack: Markdown only. No code, no dependencies. The AI agent IS the runtime.
- Key Config:
.envcontainsOBSIDIAN_VAULT_PATHpointing to the vault location. - Skills:
.skills/contains skill folders, each with aSKILL.mddefining a workflow.
Key Concepts
- The wiki is a compiled artifact — knowledge distilled from raw sources into interconnected pages.
- Every wiki page has YAML frontmatter:
title,category,tags,sources,created,updated. - Pages are connected with Obsidian
[[wikilinks]]. - A
.manifest.jsonin the vault root tracks all ingested sources for delta-based updates. index.mdandlog.mdmust be updated after every operation.
Skills Reference
| Skill | Folder | Purpose |
|---|---|---|
| Setup | .skills/wiki-setup/ |
Initialize vault structure |
| Ingest | .skills/wiki-ingest/ |
Distill documents into wiki pages |
| History Router | .skills/wiki-history-ingest/ |
Route `/wiki-history-ingest <claude |
| Claude History | .skills/claude-history-ingest/ |
Mine ~/.claude conversations |
| Codex History | .skills/codex-history-ingest/ |
Mine ~/.codex sessions and rollout logs |
| Data Ingest | .skills/data-ingest/ |
Process any text data |
| Status | .skills/wiki-status/ |
Audit ingestion state and delta |
| Query | .skills/wiki-query/ |
Answer questions from wiki |
| Lint | .skills/wiki-lint/ |
Find broken links, orphans |
| Rebuild | .skills/wiki-rebuild/ |
Archive and rebuild |
| Cross-Linker | .skills/cross-linker/ |
Auto-discover and insert missing wikilinks |
| Tag Taxonomy | .skills/tag-taxonomy/ |
Enforce consistent tag vocabulary |
| LLM Wiki | .skills/llm-wiki/ |
Core architecture pattern |
| Skill Creator | .skills/skill-creator/ |
Create new skills |
Coding Conventions
- When creating wiki pages, always use YAML frontmatter.
- Use
[[wikilinks]]syntax for cross-references — NOT markdown links. - Project-specific knowledge goes in
projects/<name>/. Global knowledge goes in top-level categories. - Never modify the
.obsidian/directory.