my_wiki/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

WikiLLM is a system for building LLM-powered personal knowledge bases. The workflow consists of:

1. Data Ingest: Source documents (articles, papers, repos, datasets, images) are indexed into a raw/ directory
2. Wiki Compilation: An LLM incrementally "compiles" the raw data into a wiki of markdown files with summaries, backlinks, categorized concepts, and interlinked articles
3. IDE: Obsidian is used as the frontend to view raw data, compiled wiki, and visualizations
4. Q&A: The LLM can answer complex questions against the wiki by researching the related data
5. Output: Results are rendered as markdown files, Marp slides, or matplotlib images, viewable in Obsidian
6. Linting: LLM "health checks" find inconsistencies, impute missing data, suggest new article candidates
7. Extra Tools: Additional tools like a naive search engine over the wiki

Directory Structure

The project will eventually include these key directories:

• raw/ - Source documents and unprocessed data
• wiki/ - LLM-compiled markdown wiki with articles, summaries, and links
• tools/ - CLI tools for searching, processing, and enhancing the wiki

Core Principles

• The LLM writes and maintains all wiki data; manual edits are rare
• User explorations and queries are filed back into the wiki to enhance it
• The system focuses on markdown files and Obsidian-compatible formats
• Images are downloaded locally for easy LLM reference