Blueprint contract template¶
Status: Draft
Version: 0.1
1. Identity¶
- blueprint_id:
- epoch:
- lifecycle: deploy | destroy | drill | status
- maturity: planned | candidate | supported | deprecated
2. Purpose¶
- outcome:
- non-goals:
3. Inputs¶
3.1 Required inputs¶
List required operator-facing inputs and guard flags.
3.2 Optional inputs¶
List optional inputs with defaults and constraints.
3.3 Input resolution¶
Declare precedence rules and any state-driven input resolution.
4. Step composition¶
4.1 Required steps¶
List the step families that MUST exist and their broad purpose.
4.2 Ordering and dependency rules¶
Declare ordering constraints and dependency requirements.
5. State contracts¶
5.1 Consumed state¶
List required upstream state contracts.
5.2 Published state¶
List normalized outputs or downstream contracts the blueprint must publish or preserve.
6. Safety and failure semantics¶
- explicit guard requirements
- stable failure conditions
- destructive operation rules
7. Evidence¶
Minimum evidence set:
- run metadata
- step outcomes
- guard confirmations
- published contract outputs
8. Security¶
- secret handling rules
- redaction rules
- access/control boundaries
9. Change control¶
Breaking changes require an updated blueprint contract and compatibility notes.