The Bug Report & QA Kit

name: Bug report
description: Something does not work as expected.
title: 'Bug: [Area]: [what goes wrong] when [trigger]'
labels:
- bug
- needs-triage
body:
- type: markdown
  attributes:
    value: |
      The default for anything that works incorrectly. If it fits a more specific template below, use that instead.

      Severity levels are defined in docs/severity-guide.md. Triage may change severity and sets priority.
- type: input
  id: summary
  attributes:
    label: Summary
    description: 'One sentence: what breaks and who it affects.'
  validations:
    required: true
- type: textarea
  id: environment
  attributes:
    label: Environment
    description: Version or build, URL or screen, browser or device + OS, account/plan, feature flags.
    value: "Build: \nURL / screen: \nBrowser or device + OS: \nAccount / plan: \nFlags: \n"
  validations:
    required: true
- type: textarea
  id: steps
  attributes:
    label: Steps to reproduce
    description: Start from a known state. One action per step.
    value: "1. Logged in as \n2. \n3. \n"
  validations:
    required: true
- type: textarea
  id: expected
  attributes:
    label: Expected result
    description: What should happen. Link the spec or last working version if you can.
  validations:
    required: true
- type: textarea
  id: actual
  attributes:
    label: Actual result
    description: What happens instead. Paste the exact error text.
  validations:
    required: true
- type: dropdown
  id: frequency
  attributes:
    label: How often does it happen?
    options:
    - Always (every try)
    - Often (more than half of tries)
    - Sometimes (less than half)
    - Once so far
  validations:
    required: true
- type: dropdown
  id: severity
  attributes:
    label: Severity (see the severity guide)
    description: Triage may change it.
    options:
    - 'S1 Critical: data lost/exposed or core flow blocked, no workaround'
    - 'S2 Major: core feature wrong or failing for a group'
    - 'S3 Minor: works with an easy workaround'
    - 'S4 Cosmetic: looks or reads wrong only'
    - Not sure (triage will set it)
  validations:
    required: true
- type: textarea
  id: evidence
  attributes:
    label: Evidence
    description: Drag in a screen recording or screenshot. Add console errors, request IDs or log links.
  validations:
    required: false
- type: textarea
  id: logs
  attributes:
    label: Console or log output
    description: Paste text, not screenshots of text. Remove secrets and personal data.
    render: shell
  validations:
    required: false
- type: input
  id: workaround
  attributes:
    label: Workaround
    description: What users can do meanwhile, or "none known".
  validations:
    required: false
- type: checkboxes
  id: checks
  attributes:
    label: Before you submit
    options:
    - label: I searched existing issues and this is not a duplicate
      required: true
    - label: I removed passwords, tokens and personal data from attachments
      required: true