Skip to content

v0.1.0

Choose a tag to compare

@pserey pserey released this 29 Jul 01:14

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.md file in which every instance declares itself, so an agent orients in one read
  • Agent runtime contract — the AGENTS.md skeleton, 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