# Advanced: GitHub Issues, Projects & Team Workflows

Issue Templates: Stop Getting "It's Broken" Reports

Create .github/ISSUE_TEMPLATE/bug_report.yml:

name: Bug Report
description: Report a bug in the application
title: "[Bug]: "
labels: ["bug", "triage"]
body:
  - type: textarea
    id: description
    attributes:
      label: What happened?
      description: A clear description of the bug
    validations:
      required: true
  - type: textarea
    id: steps
    attributes:
      label: Steps to reproduce
      description: How can we reproduce this?
      value: |
        1. Go to '...'
        2. Click on '...'
        3. See error
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: Expected behavior
      description: What should have happened?
    validations:
      required: true
  - type: dropdown
    id: severity
    attributes:
      label: Severity
      options:
        - Critical (app is broken)
        - Major (feature is unusable)
        - Minor (cosmetic or workaround exists)
    validations:
      required: true

This YAML-based form appears when someone opens a new issue and selects "Bug Report." No more vague one-line tickets.

GitHub Projects (v2): Your Kanban Board