/spec

MFM Spec

Durable project memory for coding agents. MFM Spec turns rough product intent into a validated graph of components, features, evaluations, and decisions that your own agent can read, evolve, and build from.

install hosted skillset up MCPread the format

$ why it exists

Chat is a lousy source of truth. It disappears into scrollback, code outruns intent, and every new agent session wastes context rediscovering the same architecture.

MFM Spec makes the spec the durable artifact. The conversation that produces it is disposable; the validated graph remains portable, inspectable, and cheap for an agent to slice into context.

$ doctrine

MFM services do not replace your coding agent. They steer it. The agent brings the model; MFM supplies deterministic stores, validators, MCP tools, and skills: lines in the sand for the water to follow.

$ graph

components

Structural owners of responsibility: where each durable part of the system lives.

features

Observable behavior and the component capabilities each behavior needs.

evaluations

Feedback and judgment notes that record what was learned without rewriting intent by magic.

$ modes

localskill

Your agent writes one manifest plus Markdown node files in the project, then validates the graph with the bundled linter.

hostedMCP

A database-backed canonical spec with revision history, deterministic mutations, minimal-context reads, and portable export.

$ shape

my-system/
  mfm-spec.yaml
  system.md
  components/
    api.md
    identity.md
  features/
    sign-in.md
  evaluations/
    sign-in-v1.md

The directory layout is for humans. The authoritative shape is the graph: stable ids, typed node kinds, parent links, dependency edges, feature touches, and evaluation subjects.

$ integrity

1

Exactly one root component, named by the manifest.

2

Every parent, dependency, feature touch, and evaluation subject resolves.

3

Component and dependency graphs stay acyclic.

4

Responsibilities, intents, and summaries stay single-sentence and machine-sliceable.

5

Reasoning lives in the body, not only in frontmatter labels.

$ sibling offering

MFM Spec is one of the first MFM services. Atlas is another: a separate product and tooling discovery surface that serves grounded capability evidence when an agent needs to compare external tools.

explore Atlas