Skip to content

[DOCS] Update AGENT.md with canonical template rules #715

@ashleyshaw

Description

@ashleyshaw

Add comprehensive "Template & Issue Type Governance" section to AGENT.md as single source of truth.

Details

  • Add new section after "Git & Branching Strategy"
  • Define PR template selection rules (branch name → template mapping)
  • Define issue template selection rules (problem type → template mapping)
  • Explain enforcement mechanisms (workflow, agent, CI)
  • Link to portable instruction files
  • Make clear this is canonical for all AI models

Content

  1. Overview: Why templates matter for automation
  2. PR Template Rules: Table mapping branch prefixes to templates
  3. Issue Template Rules: Table mapping issue characteristics to templates
  4. Template Anatomy: Common sections, required fields, optional fields
  5. Enforcement: How violations are detected and corrected
  6. References: Links to instructions, templates, CI workflow

Acceptance Criteria

  • AGENT.md section is comprehensive and authoritative
  • All branch types covered
  • All issue types covered
  • Enforcement approach is clear
  • References point to real files

Metadata

Issue Type: Task
Priority: High
Phase: 2 - Documentation & Guidance
Effort: 2h
Depends on: #2, #4, #5, #6

Project: Template Enforcement & Governance

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Priority

    None yet

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions