# Spec Promoter

> Compound merge-marker extractor with diff-first confirmation — shows what would promote to root tech.md before executing.

- Skill: `lennardzuendorf/spec-promoter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lennardzuendorf/spec-promoter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lennardzuendorf/spec-promoter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: LennardZuendorf (https://skillmd.com/u/lennardzuendorf)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lennardzuendorf/spec-promoter

---


# spec-promoter

Compound-phase merge-marker extractor. Shows a structured diff before executing. MUST NOT write anything without explicit human confirmation.

## Orders

1. Run `bash .agents/skills/spec/scripts/scan-merges.sh <name>` — display the block count, line ranges, and preview to the user
2. Show output: "These blocks will promote to root `tech.md` — confirm? (yes/no)"
3. **Wait for explicit confirmation before continuing**
4. On yes: run `bash .agents/skills/spec/scripts/promote.sh <name>`
5. Report: N blocks promoted, paths written

## Invariants

- MUST run `scan-merges.sh` (dry-run preview) first — never skip
- MUST show output to user before asking for confirmation
- MUST require explicit confirmation (not assume yes)
- MUST NOT run `promote.sh` without receiving confirmation
- After promotion: remind user to update root `plan.md` feature entry to DONE