AGENTS.md Schema for LLM-Compiled Knowledge Bases with Learning Layer
A developer has published AGENTS.md v1.0, a schema standard for building LLM-compiled personal knowledge bases using Claude. The approach involves dropping raw sources into a folder and having Claude compile concept articles, backlinks, and index files directly to markdown without RAG or vector databases.
Schema Details
The AGENTS.md file is versioned and contains 14 sections covering directory layout, compilation workflows, query workflows, linting workflows, learning layer, quality rules, and contamination mitigation. When dropped into any directory, Claude reads it at the start of every session to understand how to structure the wiki, name files, lint for contradictions, handle confidence levels, and avoid contaminating the wiki with low-quality agent output.
Learning Layer Addition
Beyond Karpathy's original archive workflow, this implementation adds a learning layer where Claude automatically generates flashcards from every concept article it writes. It maintains a spaced repetition review queue using the FSRS algorithm and tracks knowledge gaps detected during linting.
Claude Code Implementation
The developer used Claude Code to:
- Iterate on the AGENTS.md schema across dozens of sessions until agent behavior was consistent
- Write all 50 repository files including templates, documentation, and a worked example wiki on AI alignment
- Catch schema inconsistencies like frontmatter path convention differences between the spec and example articles
- Compile the worked example wiki (5 concept articles, flashcards, review queue, gap tracker) in a single session
Repository Contents
The GitHub repository includes:
- AGENTS.md v1.0 specification
- Templates for every file type (concept, summary, topic, flashcard, lint report, output report)
- Worked example wiki fully populated with AI alignment topic
- Documentation covering why not RAG, learning layer design, contamination mitigation, and fine-tune path
The project is MIT licensed and available for developers working with AI coding agents to structure and master their personal knowledge bases.
📖 Read the full source: r/ClaudeAI
👀 See Also
Rails-AI-Context Gem Provides Claude Code with Complete Rails App Model via MCP
The rails-ai-context gem auto-introspects Rails applications and exposes 39 tools via MCP, allowing Claude Code to query specific app details like schema with encrypted columns, model associations, routes, Stimulus wiring, and Turbo mappings instead of reading entire files.
Fehu: CLI Double-Entry Bookkeeping with Claude AI MCP Integration
Fehu is a lightweight CLI personal accounting tool that connects to Claude AI via MCP, allowing natural language transaction recording with a SQLite-backed double-entry system. It features hierarchical accounts, auto-tagging with hashtags, a powerful calc engine, and multi-currency support.
Hyper iOS App: Voice Recorder with Real-Time Transcription and Action Extraction
Hyper is an iOS voice recorder app that transcribes conversations in real-time, provides summaries and action items, and allows mid-conversation queries via wakeword detection. It's designed for unstructured meetings like 1:1s, coffee chats, and standups.
LLM Cost Profiler: Open-source tool tracks API spending to make case for local models
LLM Cost Profiler is a Python tool that tracks every API call to OpenAI/Anthropic, showing exactly what you're spending and where. It exposes tasks that are overpriced relative to their complexity, providing concrete dollar amounts to justify moving to local models.