Markdown Gatekeeper

Markdown Gatekeeper is a local-first authority layer for projects where humans, Claude, Codex, and other agents create overlapping Markdown documents.

It keeps ordinary Markdown and local Git. It adds one rule: a document does not become current authority merely because an agent calls it authoritative.

This repository is the first dogfood implementation. It intentionally has no cloud service and no MCP dependency.

After the package is published to npm, the equivalent command is npm install -g markdown-gatekeeper .

During local development, use npm link in this repository instead of installing globally from GitHub. New Codex tasks and Claude Code sessions then detect managed projects automatically, while unrelated global instructions and unmanaged projects are left alone.

After installation, routine Agent sessions use Gatekeeper silently. If a managed project still has registry revision zero or pending legacy entrypoints, the host-specific bootstrap automatically resumes adoption. Successful housekeeping is not shown to the user; owner review appears only when the current task actually depends on unresolved product intent. Bootstrap calls the installed global mdg command directly and only uses a verified host launcher or repository-local fallback.

Claude and Codex project hooks block accidental direct edits to protected authority files.