Spec

AI Parsing Rules

Guidelines for AI agents parsing StratMD documents

AI Parsing Rules

Guidelines for AI agents consuming StratMD documents:

Parsing Strategy

  1. Use YAML parser for frontmatter
  2. Extract H2 sections as primary structure
  3. Parse tables as array-of-objects
  4. Resolve [[links]] via filename graph
  5. Prefer structured tables over narrative mining

Table Parsing

Tables should be parsed with:

  • Headers as object keys
  • Each row as an object
  • IDs preserved for cross-referencing
[[filename]]           → Find file by name
[[filename#Heading]]   → Find file + section
[[filename#ID]]        → Find file + element ID

Confidence and Status Fields

When present, these fields indicate:

  • Confidence - Certainty level (0-100%)
  • Status - Current state (untested, validated, invalidated)
  • Trend - Direction (up, down, stable)