MIF Documentation
Written once. Read by both. The MIF ecosystem documentation, organized by what you need to do.
These docs are organized by the Diátaxis framework — four modes, each matched to a different need — plus the architecture decision records.
Tutorials Learning-oriented. Start here: build your first MIF bundle step by step.
How-to guides Task-oriented. Recipes for specific jobs, such as migrating existing data into MIF.
Reference Information-oriented. The schema reference and API reference — look things up.
Explanation Understanding-oriented. Why MIF is shaped the way it is, including OKF conformance.
Decisions (ADRs) The architecture decision records — the context and consequences behind each choice.
Specification The normative MIF specification and canonical JSON Schemas, served at mif-spec.dev.
Across the ecosystem
Ontology corpus The shared, growing corpus of MIF ontologies — the YAML a person reads and the JSON-LD a parser resolves.
mif-docs plugin The Claude Code documentation skill suite — one skill per document genre over a MIF Level-1 floor.
Plugin marketplace The modeled-information-format Claude Code plugin marketplace — SHA-pinned, attested, fail-closed admitted.
mif-rs The Rust implementation of MIF — core library, CLI, MCP server, and research-harness tooling.
Structured MADR The Structured MADR specification — a machine-checkable superset of the MADR architectural decision record format.
Org governance & release runbooks The org-level governing runbooks — release, branch-protection, Dependabot auto-merge, and labels — that this repo follows.