SAGE: The Format STIX, OSCAL, and SARIF Don't Cover
Summary
The Cloud Security Alliance (CSA) has published SAGE (Security Analysis and Guidance Exchange) on May 4, 2026, a new format addressing the "structured narrative gap" in security research. This gap refers to the inability of existing machine-readable formats like STIX, OSCAL, and SARIF to capture analytical prose explaining threat models, risk decisions, or design tradeoffs, which typically reside in PDFs. The article highlights the critical risk of "poisoned guidance" in RAG pipelines, citing a USENIX Security 2025 study where five malicious texts achieved a 90% attack success rate. SAGE is based on CommonMark with YAML frontmatter, incorporating required fields for identity, classification, provenance, and integrity via a SHA-256 content_hash, plus optional cryptographic signatures. It also includes trust marking using FIRST TLP 2.0 and generation metadata for AI authorship. SAGE is intended to sit alongside, not replace, existing security formats, providing the crucial reasoning layer.
Key takeaway
For MLOps Engineers or AI Security Engineers deploying RAG pipelines with security content, you must prioritize integrity. The lack of structured narrative and integrity checks in current security documents creates a significant poisoning vector for your AI agents. Adopt SAGE now to ensure provenance and tamper detection for ingested security research, and demand that your tooling vendors support this critical new standard. This mitigates risks from poisoned guidance and enhances agent reliability.
Key insights
SAGE provides a machine-readable, integrity-checked format for security narratives, closing a critical gap for AI agents.
Principles
- Unstructured security narratives pose an attack surface.
- Integrity checks are crucial for AI-ready content.
- Trust markings must propagate across derivative works.
Method
SAGE uses CommonMark with YAML frontmatter, including required fields for identity, provenance, classification, and a SHA-256 content_hash for integrity, plus optional cryptographic signatures.
In practice
- Test SAGE template with your own documents.
- Compute and verify content_hash with colleagues.
- Ask vendors about SAGE consumption and indexing verification.
Topics
- SAGE Format
- RAG Security
- AI Agent Integrity
- CommonMark
- YAML Frontmatter
- Cloud Security Alliance
Best for: CTO, VP of Engineering/Data, Director of AI/ML, AI Security Engineer, MLOps Engineer, AI Engineer
Related on AIssential
Editorial summary, takeaway, and curation by AIssential. Original article published by Cloud Security Alliance.