Stable enough to try
The core flow is install, init, index, status, pack, checkpoint, handoff, and validate in a normal Git repository.
Public alpha
Usable today, still pre-v1.
Markdown Knowledge Graph is ready for careful early adopters, not frictionless enterprise rollout. Start with a small repo, keep changes in Git, and use validation before trusting larger workflows.
Advanced surfaces evolve
Project DB, queues, subgraphs, graph import, workflow mirrors, and MCP are alpha surfaces that need repo-specific tests.
Upgrade deliberately
Use mdkg upgrade dry-runs, changelog notes, local commits, and strict doctor output before changing established repos.
What to expect before v1
mdkg will keep tightening command UX, warning summaries, docs, graph import safety, subgraph workflows, and advanced local state. Public alpha means you should expect careful release notes and repo-level validation before adopting new surfaces. Markdown graph files remain the durability boundary that should be reviewable in normal Git history.