v0.1.0
First release of megabrain.md — an open standard for keeping a second brain as a git repository of plain Markdown files, read and written by AI agents as first-class clients.
What's in this release
The megabrain specification, v0.1.0 (attached: SPEC.md)
The normative document defining what makes a repository a megabrain:
- Core invariants — plain Markdown + YAML under git, files as the source of truth, procedures that live in the repository, human-in-the-loop intake, fail-loudly agents
- Archetypes — a closed set of seven structural kinds (ephemeral work item, durable entity, background context, append-only log, dated series, captured external, derived view) that make any instance legible to an unfamiliar agent
- Schema — two universal required keys (
domain,date_added), reserved keys with fixed meanings, declared types for instance-defined fields - The manifest — a single
megabrain.mdfile in which every instance declares itself, so an agent orients in one read - Agent runtime contract — the
AGENTS.mdskeleton, intent-based dispatch to procedure files, and the in-turn re-read rule that makes behavior reproducible across harnesses, models, and sessions - Integration, lifecycle, and version-control contracts — live-queried (never mirrored) integrations, a completion protocol that logs before deleting, and a content/contract split that keeps the standard human-owned