[AGENT] Create PR template enforcement agent

[ashleyshaw]

Issue Type: Task
Priority: Medium
Phase: 3 (Automation & Enforcement)
Depends on: #717
Effort: 2h

Summary

Create .github/agents/pr-template-enforcement.md agent specification for intelligent template validation.

Details

• File: .github/agents/pr-template-enforcement.md
• More intelligent than workflow regex validation
• Can understand semantic completeness (not just section presence)
• Can auto-fix simple template issues (reorder sections, etc.)
• Provides helpful guidance for complex fixes
• Coordinated with validation workflow

Agent Capabilities

1. Detect template type from branch name and PR body
2. Validate structure against template specification
3. Check completeness of required fields (not just presence)
4. Auto-fix simple issues:
   • Missing changelog section → add with placeholder
   • Misaligned sections → reorder
   • Missing checklist → add standard checklist
5. Smart guidance for complex issues:
   • If risk assessment incomplete → suggest what to include
   • If test steps vague → provide examples
6. Escalate issues that require human judgment

Agent Rules

• Don't be overly strict (allow reasonable variations)
• Prioritize user experience (helpful comments, not blockers)
• Respect branch type (fix/ PRs need different validation than docs/)
• Work with workflow, not against it

Acceptance Criteria

• Agent spec document created
• Behaviors clearly defined
• Integration with workflow is clear
• Examples of agent output provided

---

Part of: Template Enforcement & Governance project backlog

[linear-code]

LS-863

[ashleyshaw]

Status Update: Backlog published to develop ✅

Template enforcement project backlog is now live. This issue is Phase 3 (Automation) and depends on Phase 2 completion (#712–#716).

Complete backlog: .github/projects/active/template-enforcement-governance/ISSUES.md
Action plan: .github/projects/active/template-enforcement-governance/ACTIONS.md

---

Generated by Claude Code