---
name: wiki-promotion-draft
description: 'Draft Miadi wiki updates from already-reviewed material while preserving provenance, spec, and context-layer boundaries.'
---

# Wiki Promotion Draft

Create wiki drafts only from material that has already survived review and promotion decisions.

## Guardrails

- provenance is not already-promoted knowledge
- wiki pages should not silently replace specs
- context-layer concerns belong near retrieval and composition framing, not automatically inside the wiki
- merge existing knowledge; do not rewrite from scratch unless the page truly has no usable structure

## Draft sections

1. `What this concept is`
2. `Why it matters in Miadi`
3. `Which layer it belongs to`
4. `Related pages and rispecs`
5. `What remains outside the wiki on purpose`

## Draft metadata to include in the note

- source paths
- promotion status
- related pages
- open questions or blockers

## Style rule

Keep the draft concise and link-rich. If the concept is mostly a context-layer or retrieval concern, write a short bridge section that points readers to the rispecs or boundary note instead of over-explaining it in the wiki.