NEW

Start with the pressure: sales, launch, abuse, agents, data, or guardrails

Publication DSL

A structured language for reports, deliverables, field guides, and evidence.

The DSL keeps Markdown readable while giving high-value sections real structure: findings, risks, controls, evidence packs, permission matrices, trust boundaries, charts, print notes, and executive decisions.

example

Mini AI Security Deliverable Example

A compact example showing nested Publication DSL blocks for a client-facing AI security deliverable.

example

Mini AI Security Report Example

A compact report example showing findings, charts, evidence, and recommendations.

example

Publication DSL Block Gallery

A single example file demonstrating every official v1 block.

deliverable

AI Product Security Assessment Sample

A fuller sample showing how the Publication DSL can structure a serious AI Product Security review.

deliverable

Enterprise AI Security Evidence Pack Sample

A DSL sample for a buyer-ready enterprise AI security evidence pack.

field-guide

Field Guide Chapter DSL Sample

A sample field guide chapter using the Publication DSL for teaching and advisory content.

Official v1 blocks
:::callout
Callout

A short emphasized note, warning, evidence note, or interpretive aside.

:::stat-grid
Stat Grid

A compact grid of metrics, proof points, or review snapshot values.

:::pull-quote
Pull Quote

A visually prominent quote or thesis line.

:::checklist
Checklist

A checklist of controls, readiness items, or operational tasks.

:::section-opener
Section Opener

A strong section opener with optional kicker and narrative lead.

:::course-hero
Course Hero

A course landing hero with eyebrow, title, subtitle, and narrative lead.

:::module-list
Module List

A numbered module list for course outlines and curriculum maps.

:::principle-grid
Principle Grid

A grid of short principle cards with supporting detail.

:::principle
Principle

A single operating principle card.

:::learning-path
Learning Path

A recommended path or progression for learners.

:::module-opener
Module Opener

A module opener with the module thesis and lead-in context.

:::prompt-example
Prompt Example

A public-safe example prompt or instruction pattern.

:::exercise
Exercise

A learner exercise, scenario, or practice prompt.

:::policy
Policy

A short policy statement or operating rule.

:::process
Process

A sequence of steps, stages, or gates.

:::step
Step

A single numbered step or stage in a process.

:::template
Template

A prompt, checklist, or other reusable template.

:::pattern-list
Pattern List

A collection of reusable patterns or prompt patterns.

:::pattern
Pattern

A single reusable pattern or practice card.

:::risk-list
Risk List

A collection of risks, failure modes, or hazard cards.

:::risk
Risk

A single risk or failure-mode card.

:::comparison
Comparison

A side-by-side comparison container.

:::comparison-item
Comparison Item

One side of a comparison pair or matrix.

:::review-comment
Review Comment

A model-safe review comment or feedback example.

:::code-sample
Code Sample

A short code snippet or toy example rendered in a preformatted block.

:::example
Example

A public-safe example, scenario, or illustrative snippet.

:::finding-card
Finding Card

A structured security, market, governance, or maturity finding.

:::finding-grid
Finding Grid

A container for multiple finding-card blocks.

:::risk-register
Risk Register

A data-backed register of AI risks, owners, status, severity, evidence, and remediation.

:::evidence-pack
Evidence Pack

A data-backed summary of controls, evidence, implementation status, and ownership.

:::control-map
Control Map

A data-backed control map for frameworks, buyer questions, ownership, and evidence status.

:::permission-matrix
Permission Matrix

A data-backed matrix of agent/tool permissions, action classes, approvals, logging, and owners.

:::trust-boundary-map
Trust Boundary Map

A data-backed trust boundary visualization for users, AI systems, providers, tools, and logs.

:::decision-box
Decision Box

A high-signal executive decision, condition, or recommendation.

:::chart
Chart

A data-backed chart wrapper using the existing chart system where possible.

:::table
Table

A markdown table wrapper with title, print behavior, and lintable identity.

:::artifact
Artifact

A reference to a deliverable, figure, source file, route, or generated asset.

:::page-break
Page Break

A print/PDF page break hint.

:::print-note
Print Note

A note specifically intended to clarify print/PDF behavior or static fallback.

:::recommendation-grid
Recommendation Grid

A compact set of recommended actions, decisions, or next steps.

:::domain-playbook
Domain Playbook

A practitioner playbook container for a security domain, including checks, questions, controls, evidence, and outputs.

:::failure-mode-list
Failure Mode List

A list of ways a system, control, workflow, or operating model breaks in practice.

:::question-set
Question Set

Practitioner questions for review, assessment, workshop, or evidence request use.

:::test-plan
Test Plan

Checks, probes, adversarial scenarios, or validation steps to run against a system.

:::control-evidence-map
Control Evidence Map

A mapping between controls, guardrails, owners, checks, and evidence artifacts.

:::artifact-list
Artifact List

A list of evidence, deliverables, worksheets, outputs, or generated assessment artifacts.

:::claim-card
Claim Card

A public-safe claim unit with claim-readiness, confidence, basis, caveat, and implications.

:::claim-ledger
Claim Ledger

A grouped set of claim-card blocks for research reports and evidence-led publications.

:::audience-action-grid
Audience Action Grid

A table or list of actions organized by audience, stakeholder, or operating role.

:::caveat-box
Caveat Box

A public-safety caveat or interpretation boundary for research, survey, sponsor, or psychometric claims.

:::definition-list
Definition List

A structured term and definition block for concept-first chapters and field references.

:::related-paths
Related Paths

A structured map of related routes, services, tools, chapters, workbench instruments, or next actions.

:::comparison-matrix
Comparison Matrix

A side-by-side comparison table for roles, publications, evidence classes, or options.