Introduction

StratMD is a Markdown-native format for strategy documentation, designed to bridge the gap between human readability and AI parseability.

The Problem StratMD Solves

Most strategy documents today fall into one of two traps:

• Too unstructured: Plain text, Word docs, or free-form Notion pages drift over time and are hard for AI agents to query reliably.
• Too rigid: Proprietary tools (Confluence, Notion databases, Slides) create lock-in, poor versioning, and token-inefficient outputs for agents.

The result: Strategy remains a static artifact instead of living data that humans and agents can use effectively.

The StratMD Approach

StratMD uses plain Markdown files with light conventions:

• YAML frontmatter for metadata
• Standardized H2 sections for consistency
• Tables for structured data (goals, risks, actions)
• Wiki-style links for hierarchy
• Optional Mermaid diagrams for visuals

This makes files:

• Fully human-readable and editable in any editor
• Git-friendly for versioning and collaboration
• Predictably parseable for AI agents
• Completely portable—no tool lock-in

Who It's For

• Founders and teams building structured strategy without heavy tools
• AI agent builders needing reliable strategy context
• Anyone wanting strategy as versioned, queryable data

See the Design Principles for the philosophy and Format Overview for the core structure.