Skip to content

Reporting

                     what do you have?
                             |
        +--------------------+--------------------+
        |                    |                    |
        v                    v                    v
+---------------+    +---------------+    +---------------+
| bug           |    | feature       |    | question      |
+---------------+    +---------------+    +---------------+
        |                    |                    |
        v                    v                    v
  title is the defect    the outcome you       Discussions
  repro steps            want, not the
  expected vs actual     change you would
  evidence               make, and why
        |                    |
        +---------+----------+
                  |
                  v
        +-------------------+
        | triage            |   `ready`: approved, the ticket is the plan
        |                   |   `model:*`: which model runs it
        +-------------------+
                  |
                  v
        one branch, one PR, `Closes #N`

A bug report names the defect in the title, then gives the repro, expected versus actual, and the evidence. A feature request names the outcome and why, never the change you would make. Questions go to Discussions, not the tracker. Triage adds ready once the ticket is the plan and a model:* label for who runs it; from there the SDLC chart applies. No preamble, no restated brief, no closing summary.

Triage itself uses two skills, depending on how settled the ask already is. A raw idea with open questions goes through /grill: one question at a time, recommended answer first, until nothing is left unresolved; /grill plan files the result as a decision record plus one step ticket per unit of work, each already labelled ready and model:*. An ask that's already well-scoped skips straight to labelling. Either way, /kata is what actually dispatches a ready ticket: one branch, one PR, wait for review, squash-merge on LGTM.

Source: .github/ISSUE_TEMPLATE/, CONTRIBUTING.md, rules/tickets.md, rules/voice.md.