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
ClawMetry adds remote monitoring with E2E encryption for OpenClaw agents
ClawMetry v0.1.0 now includes cloud sync for remote monitoring of OpenClaw agents from any browser or Mac menu bar app, with end-to-end encryption that keeps data encrypted until it reaches your client.
Reddit User Tests Hermes AI Agent's Self-Learning Feature, Finds Critical Flaws
A Reddit user tested Hermes AI agent's self-learning feature, which automatically creates skills from markdown files. The user found it always evaluates its own results as successful, even when output is incorrect, and overwrites manual edits.
Measuring Claude Code MCP Stack: Cache Friendliness vs. Byte Savings, and a 2-Line Fix for Prompt Cache
Greg Shevchenko benchmarks MCP compressors and retrieval layers on two axes: byte savings and cache friendliness. A 2-line fix (sort rg hits, sort map entries) boosts cache from ~0% to 100% with no byte-savings loss. Open-source harness included.
Werld: Open-Ended Artificial Life Simulation with Evolving Neural Networks
Werld is a real-time artificial life simulation where agents with NEAT neural networks evolve their own neural architecture, sensory processing, and behaviors without hardcoded rules or reward functions. The simulation starts with 30 agents on a Watts-Strogatz small-world graph with 64 sensory channels, 7 continuous motor functions, and 29 heritable genome traits.