---
name: promotion-decision-record
description: 'Write an artefact-friendly markdown record of Miadi promotion decisions so later RISE and wiki waves can resume from explicit layer choices and blockers.'
---

# Promotion Decision Record

After making promotion decisions, write a concise markdown record into the active artefact folder or working note.

## Purpose

The record should make later waves able to answer:

1. what candidates were considered
2. which layer each candidate belongs to
3. what blocked promotion
4. what draft work can happen next

## Required sections

1. `Scope`
2. `Evidence paths`
3. `Promotion matrix`
4. `Context-layer boundary notes`
5. `Blocked or deferred items`
6. `Draftable next steps`

## Promotion matrix format

| Candidate | Decision | Target surface | Evidence | Rationale | Blockers |
| --- | --- | --- | --- | --- | --- |

Decisions should use the same vocabulary as the promotion architect:

- `keep in provenance`
- `promote to spec`
- `promote to wiki`
- `keep as context-layer note`
- `defer`

Prefer exact paths and compact rationale over broad summary language.