decision-canon/examples/README.md

# Examples

Illustrative fixtures for probing `DecisionObjectSchemaDraft.md`. They are not records of operational decisions.

## File shape

One Markdown file per decision. The decision is a single YAML block. Populate only the sections the situation needs. Leave unknown fields absent. Do not add a JSON Schema.

The decision's identity id has the form `DEC-EX-NNN`. That id is an example identity. It is not a State Hub work-record id.

`DEC-EX-001` uses the D1 shape from `UnifiedDecisionObject.md`: `question`, `choice`, and `reason`. It does not repeat the id inside the YAML, because that shape has no identity section. The other five examples use schema-draft sections only, and they carry `identity.id`.

## Situations in DECISION-WP-0002

| Id | Situation | File |
| --- | --- | --- |
| `DEC-EX-001` | Trivial engineering choice | [DEC-EX-001-database-choice.md](DEC-EX-001-database-choice.md) |
| `DEC-EX-002` | Architecture decision | [DEC-EX-002-schema-ownership.md](DEC-EX-002-schema-ownership.md) |
| `DEC-EX-003` | Incident-response decision | [DEC-EX-003-incident-rollback.md](DEC-EX-003-incident-rollback.md) |
| `DEC-EX-004` | Security exception | [DEC-EX-004-scanning-exception.md](DEC-EX-004-scanning-exception.md) |
| `DEC-EX-005` | Deployment policy | [DEC-EX-005-deploy-policy.md](DEC-EX-005-deploy-policy.md) |
| `DEC-EX-006` | Constitutional governance rule | [DEC-EX-006-binding-policy-rule.md](DEC-EX-006-binding-policy-rule.md) |

Hiring, procurement, investment, budget allocation, and public-style policy are not in this set. `reviews/kernel-proposal.md` concludes they would not move the D1 minimum. They are not a further workplan.
Record the schema probe for DECISION-WP-0002. Add six illustrative decisions and the pressure note, and open DECISION-WP-0003 for the kernel proposal. Assistant: grok Assistant-Session: 01a1082a-858c-7fe2-9b5a-0b5332107eb3 2026-10-04 20:50:42 +02:00			`# Examples`

			Illustrative fixtures for probing `DecisionObjectSchemaDraft.md`. They are not records of operational decisions.

			`## File shape`

			`One Markdown file per decision. The decision is a single YAML block. Populate only the sections the situation needs. Leave unknown fields absent. Do not add a JSON Schema.`

			The decision's identity id has the form `DEC-EX-NNN`. That id is an example identity. It is not a State Hub work-record id.

			`DEC-EX-001` uses the D1 shape from `UnifiedDecisionObject.md`: `question`, `choice`, and `reason`. It does not repeat the id inside the YAML, because that shape has no identity section. The other five examples use schema-draft sections only, and they carry `identity.id`.

			`## Situations in DECISION-WP-0002`

			`\| Id \| Situation \| File \|`
			`\| --- \| --- \| --- \|`
			\| `DEC-EX-001` \| Trivial engineering choice \| [DEC-EX-001-database-choice.md](DEC-EX-001-database-choice.md) \|
			\| `DEC-EX-002` \| Architecture decision \| [DEC-EX-002-schema-ownership.md](DEC-EX-002-schema-ownership.md) \|
			\| `DEC-EX-003` \| Incident-response decision \| [DEC-EX-003-incident-rollback.md](DEC-EX-003-incident-rollback.md) \|
			\| `DEC-EX-004` \| Security exception \| [DEC-EX-004-scanning-exception.md](DEC-EX-004-scanning-exception.md) \|
			\| `DEC-EX-005` \| Deployment policy \| [DEC-EX-005-deploy-policy.md](DEC-EX-005-deploy-policy.md) \|
			\| `DEC-EX-006` \| Constitutional governance rule \| [DEC-EX-006-binding-policy-rule.md](DEC-EX-006-binding-policy-rule.md) \|

Record the kernel proposal for DECISION-WP-0003. A D1 decision is question, choice, and reason. Every other draft section stays an envelope, and the schema draft is unchanged. Assistant: grok Assistant-Session: 01a1082a-858c-7fe2-9b5a-0b5332107eb3 2026-10-04 20:56:28 +02:00			Hiring, procurement, investment, budget allocation, and public-style policy are not in this set. `reviews/kernel-proposal.md` concludes they would not move the D1 minimum. They are not a further workplan.