Reference Documentation

Technical specifications and reference material for the Dossier project.

Core Specifications

• Protocol - The dossier file format and verification protocol
• Schema - Dossier metadata schema and validation rules
• Specification - Complete formal specification
• Spec-Shaped Dossiers and Signature v3 - The Agent Skills frontmatter layout, value encoding, signature schemes v1/v2/v3, migration

API & CLI Reference

• Core API Reference - @ai-dossier/core library API documentation
• Capability Manifest - .dossier/automation/manifest.yaml spec and the cap command
• CLI Reference - Command-line tool options and usage

File Formats

• Dossier files (.ds.md) - Markdown with frontmatter in the Agent Skills (spec) layout or the legacy JSON layout
• Working files (.dsw.md) - Mutable execution state
• Signature formats - Ed25519 and AWS KMS signatures
• Plan artifacts (plan:v1) - Canonical per-issue plan comments

Standards & Compliance

• Security standards
• Cryptographic requirements
• Version compatibility

For Developers

• Implementing a verifier: See Protocol
• Parsing dossiers: Check the Schema
• Integration: Review Specification

Rendered from docs/reference/README.md in the repository. Edit it there.