HTML Effectiveness Router

Decide whether the deliverable should be HTML (interactive, visual, self-contained) or markdown (text-first, diffable, repo-native). Route to the correct template when HTML wins.

Decision Rule

Choose HTML when the output benefits from:

• Visual layout, color, typography, or spatial relationships
• Interaction (click, hover, navigate, edit)
• Side-by-side comparison or live preview
• Presentation at fixed viewport (slides, canvas)
• Rich media embedding (screenshots, diagrams with styling)

Choose markdown when the output is:

• Primarily prose documentation
• Version-controlled spec or plan
• CLI/terminal instructions
• API reference or changelog
• Content the user will edit heavily in an IDE