Spec/plan reviewer prompt templates are not referenced from their skills

[eranroseman]

skills/brainstorming/spec-document-reviewer-prompt.md and skills/writing-plans/plan-document-reviewer-prompt.md provide dispatch templates for reviewing spec and plan documents, but neither skills/brainstorming/SKILL.md nor skills/writing-plans/SKILL.md references its template. An agent following the skill therefore never learns to dispatch the reviewer, so the templates read as orphaned.

Request: either wire the reference into each SKILL.md (e.g. "after writing the spec to docs/superpowers/specs/, dispatch a reviewer using spec-document-reviewer-prompt.md"), or — if the review step is intentionally optional/manual — note that in the template so it doesn't read as dead.

[rasibintang]

I dug into the git history to settle the "wire them up vs. remove them" question (also discussed in #1511), and the evidence says these files are leftovers from a deliberately removed workflow — and there's already an open PR that removes them.

History:

• ee14cae / 6c274dc introduced the two reviewer prompts as part of the 2026-01-22 document-review-system, and the SKILL.md flows dispatched them at the time.
• e6221a4 — "Replace subagent review loops with lightweight inline self-review" — deliberately removed the dispatch steps from both brainstorming/SKILL.md and writing-plans/SKILL.md. The commit message carries the regression data: 5 versions × 5 trials showed the subagent review loop added ~25 min per run with no measurable plan-quality improvement, while inline self-review catches 3–5 real bugs in ~30s. It was reverted (4ae1a3d) and then reapplied (3f80f1c), so the decision stuck.
• That commit touched only the two SKILL.md files — the prompt templates were left behind unreferenced, which is exactly the state this issue describes.
• The system's test went the same way: ea8aad8 — "tests: remove test-document-review-system.sh (covered by drill spec-reviewer-catches-planted-flaws)".

Conclusion: re-wiring the references would reintroduce a workflow the maintainer removed with data in hand; removal matches the recorded intent. And PR #1899 already does exactly that — it deletes both spec-document-reviewer-prompt.md and plan-document-reviewer-prompt.md (among other confirmed orphans). Merging #1899 would resolve this issue and #1511.