Files
openbitdo/process/dirtyroom_dossier_schema.md

686 B

Dirty-Room Dossier Schema

Each dossier is a TOML file that captures sanitized protocol evidence for one PID and one operation group.

Required Fields

  • dossier_id
  • pid_hex
  • operation_group
  • command_id
  • request_shape
  • response_shape
  • validator_rules
  • retry_behavior
  • failure_signatures
  • evidence_source
  • confidence
  • requirement_ids
  • state_machine
  • runtime_placeholder
  • hardware_placeholder

Optional Fields

  • class_family
  • notes

Authoring Rule

Prefer short, structure-level descriptions over long prose. The dossier should be good enough to guide clean implementation and testing without embedding dirty-room source text.