governor.md

MCP server for long-term project governance. Records vision, goals, guardrails, SOPs, and architectural decisions (ADRs) — the contracts that all execution must honor.

Part of the trilogy: research.md → governor.md → docket.md

• research.md earns decisions with evidence
• governor.md records them as binding contracts
• docket.md executes within those contracts

(governor.md was previously codenamed visionlog; docket.md was previously ike. Same tools, new brand names.)

What it enforces

• Guardrails are active or deprecated — never deleted
• ADRs are permanent once accepted — a new ADR supersedes, never overwrites
• Goals form a DAG — dependencies must be resolved before a goal is available
• Vision is sticky — it does not drift session to session

Trilogy conventions

governor.md follows shared conventions with docket.md and research.md. See CONVENTIONS.md for the full standard.

• Config lives at .governor/config.yaml (committed to git)
• Tools: project_init (new project) and project_set (register existing for session)

Install

uv tool install governor-md
# or: pip install governor-md

Add to .mcp.json:

{
  "mcpServers": {
    "governor": {
      "type": "stdio",
      "command": "governor"
    }
  }
}

Session protocol

project_set { path: "/path/to/project" }   <- returns project_id
governor_boot { project_id: "..." }        <- active guardrails + goal state
governor_guide { project_id: "..." }       <- vision + decisions + goal map

Read both governor_boot and governor_guide at the start of every session before touching any task or code.

Project structure

my-project/
  .governor/
    config.yaml          <- project GUID + metadata (commit this)
    vision.md            <- north star, anti-goals, success criteria
    goals/               <- GOAL-NNNN.md — DAG of milestones
    adr/                 <- ADR-NNNN.md — architectural decisions
    guardrails/          <- GUARD-NNNN.md — active constraints
    sops/                <- SOP-NNNN.md — coordination protocols

Tools

Session

Orientation (call at session start)

Vision

Goals

Decisions (ADRs)

Guardrails

SOPs