Trestle Templates

Open-source markdown template library for the Trestle Labs compliance workspace. Templates are authored in Handlebars-flavored markdown and grouped by control family or framework area so they can be rendered by either the main product or the educational viewer.

Directory Layout

• security/
• availability/
• confidentiality/
• processing-integrity/
• privacy/
• hipaa/
• pci-dss/
• iso27001/
• cross-framework/
• sox/

Each markdown file typically contains:

• reviewer-facing preamble content and metadata,
• YAML frontmatter for title, slug, and mapping details,
• Handlebars expressions and conditional blocks,
• the policy body that is ultimately rendered for end users.

How Templates Are Used

• TrustScaffold stores and compiles approved templates into generated documents for customer organizations.
• trustscaffold-edu reads the raw markdown files directly, renders them with @trestle-labs/core, and strips reviewer-only metadata for teaching-friendly previews.

Authoring Notes

• Prefer canonical payload fields produced by buildTemplatePayload() in @trestle-labs/core rather than ad hoc variable names.
• Keep mapping comments and metadata accurate; downstream tools rely on them for traceability even if the educational app removes them from display.
• Use conditional blocks for provider- or framework-specific wording instead of duplicating full documents.
• Preserve existing slug conventions because both apps key navigation and generation rules off those slugs.

Working In This Package

There is no standalone build step here. Validation usually happens by rendering templates through a consumer app or by running workspace-level checks such as the template compilation scripts in TrustScaffold.