AGENTS.md — how to use this brain

TL;DR — This repo is a second brain: durable notes plus an engine that makes them queryable (search, a knowledge graph, and an MCP server for AI agents). Read before acting; write back what you learn. MAP.md is the index; CONVENTIONS.md is the rulebook.

Reading order

0. MAP.md — the canonical index; use it to locate any topic.
1. README.md — what this is and how it's built.
2. now.md — the current snapshot (focus, what's live, next moves).
3. about-me.md — the person and how they work.
4. projects/README.md — what exists, status, and stack.
5. learnings/README.md — reusable lessons; check before building.
6. gaps.md — the known unknowns.

Rules for writing into the brain

Full rules in CONVENTIONS.md. The essentials:

• Register every new file in MAP.md. Nothing exists until it's mapped.
• Link to files, not headings (refactor-safe); keep links relative.
• Be accurate and honest. No hype, no invented metrics. Record dead ends.
• Keep entries short and factual. Bullets over prose. This is a reference.
• Never store secrets. Reference where a secret lives, never the value.

What this is NOT

• Not a code repo for an app — it holds knowledge plus the engine that serves it.
• Not a secrets vault.