Spec

Design Principles

The nine core principles that guide the StratMD format

Design Principles

Nine principles guide the StratMD format:

  1. Markdown-native — Plain text, renders everywhere
  2. Human-first — Readable as a document; tables over JSON
  3. AI-friendly — Consistent headings, IDs, table schemas
  4. Git-native — Diffable, mergeable, branchable
  5. Framework-agnostic — Works with OKR, OGSM, custom models
  6. Hierarchical & Linked — Explicit parent/child and cross-references
  7. Hybrid Structure — Narrative + structured tables
  8. Evolvable — Built-in changelogs and versioning
  9. Minimal by default — Optional sections; start small