Spec
AI Parsing Rules
Guidelines for AI agents parsing StratMD documents
AI Parsing Rules
Guidelines for AI agents consuming StratMD documents:
Parsing Strategy
- Use YAML parser for frontmatter
- Extract H2 sections as primary structure
- Parse tables as array-of-objects
- Resolve
[[links]]via filename graph - 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
Link Resolution
[[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)