Feature Increment Roadmap: Karpathy Wiki - dennisholee/notes GitHub Wiki

Phase Feature Increment Technical Specification Focus SpecKit specify Goal
P0 Filesystem & Config Setup Define /raw and /wiki directory structures; create CONFIG.md schema for AI folder-mapping rules. Setup project scaffold and validation logic for the folder structure.
P0 The Wiki Compiler (Core) Script to read /raw files, chunk content, and call LLM to generate initial /wiki Markdown files (Entities, Concepts). Build the ingestion pipeline that transforms a PDF/Text into a structured .md file.
P1 Mandatory Backlinking Implement a "Ground Truth" utility that injects markdown citations [^1] linking back to specific /raw filenames. Ensure every generated paragraph in /wiki has a traceable file origin.
P1 Incremental Build System Implement a manifest.json file-hash tracker to compare /raw changes and only re-process "dirty" files. Optimize API usage by skipping unchanged source files during the build.
P1 Vibe-Coded Search (CLI) A CLI tool that takes a natural language query, performs a vector search over /wiki, and returns a summarized answer. Create a lightweight interaction layer for querying the "compiled" brain.
P2 Self-Healing Linter An agentic workflow that parses the /wiki directory to identify "dead ends" (pages with no links) or contradictions. Automate "quality control" by flagging thin or disconnected content for re-generation.
P2 Visual Output Engine Integration of Mermaid.js and Marp templates to turn text-heavy wiki pages into diagrams and slide decks. Add a "Render" command to export wiki pages into visual or presentation formats.
P3 Conflict & Multi-Agent Sync A git-like "Merge" logic for LLM writes; scoring agent outputs to decide which "draft" of a concept page is superior. Handle race conditions when multiple agent tasks try to update the same wiki page.
P3 Knowledge Scouring Integration with a Search API (e.g., Tavily or Perplexity) to fill in "missing" info identified by the Linter. Allow the wiki to "self-expand" beyond the provided /raw documents.