[Audit] Issue Templates, Automation, & AI Agent Integration

[ashleyshaw]

Overview

Comprehensive audit of issue templates, their relationship to the automated labeling system, and how AI agents should create issues to trigger proper automation.

Current Problems

1. Issue templates exist (.github/ISSUE_TEMPLATE/*.md) but don't consistently trigger automation
2. PR templates work well, but issue templates don't map clearly to labeling rules
3. .github/labeler.yml has rules for PRs and branches, but minimal rules for issues
4. AI agents don't have clear instructions on how to structure issues for automation

Areas to Audit

See child issues for detailed audits of:

• Issue template inventory and standardization
• Mapping between templates and automation triggers
• Missing automation rules in labeler.yml for issue types
• AI agent instructions for issue creation

Acceptance Criteria

• All issue templates audited and categorized
• Clear mapping between template usage and automation triggers
• Labeler.yml rules for issues identified and documented
• AI agent instructions for issue creation updated

Related Files

• .github/ISSUE_TEMPLATE/ (all files)
• .github/ISSUE_TEMPLATE/config.yml
• .github/ISSUE_TEMPLATE/README.md
• .github/labeler.yml (issue rules section)
• .github/issue-types.yml
• docs/ISSUE_CREATION_GUIDE.md
• .github/custom-instructions.md

Related Documentation

• Issue Creation Guide
• Issue Templates README
• Label Strategy
• Automation Governance

[linear-code]

LS-823