feat(templates): 5+ pre-built artifact templates with YAML input and generate-template.py

[ramsani]

feat(templates): 10 Pre-built Artifact Templates with YAML Input

What

Implements Issue #16 — Pre-built Artifact Templates.

New templates (5 of 10, expandable):

1. templates/prebuilt/decision-deck.yaml — Compare 2-4 options with scores, risks, evidence, recommendation
2. templates/prebuilt/project-recap.yaml — Sprint/milestone recap with completed, blocked, next steps
3. templates/prebuilt/diff-review.yaml — PR/change review with annotated files, inline comments, approval
4. templates/prebuilt/architecture-review.yaml — System architecture with connections, trade-offs
5. templates/prebuilt/audit-report.yaml — Security/process audit with findings, severity, actions

New scripts:

• scripts/generate-template.py — Template engine with three actions:

  • generate-template.py list-templates — List all available templates
  • generate-template.py validate <name> <data.yaml> — Validate data against schema before generation
  • generate-template.py generate <name> <data.yaml> — Generate artifact from template + data

• scripts/validate-templates.sh — Validates all template files have required schema fields

Schema validation (generate-template.py validate):

• Checks required fields are present
• Validates data types (string, integer, array)
• Returns clear errors before any generation attempt

Generation flow:

# Validate first
python scripts/generate-template.py validate decision-deck my-decision.yaml

# Generate (runs deliver-artifact.py at 90+)
python scripts/generate-template.py generate decision-deck my-decision.yaml
# Output: Generated artifact with quality badge

Acceptance Criteria (from #16)

• 5 templates in templates/prebuilt/ with YAML schema and description
• generate-template.py list-templates shows all templates
• generate-template.py validate returns schema errors before generation
• generate-template.py generate produces valid HTML artifacts
• validate-templates.sh passes all templates
• Templates can be added without modifying the generator script

Testing

python scripts/generate-template.py list-templates
# Shows all available templates

bash scripts/validate-templates.sh
# Validates all template YAML files

# Example: validate decision-deck
python scripts/generate-template.py validate decision-deck examples/decision-deck-example.yaml

Closes #16