feedback

Feedback (issues router)

File a GitHub issue on this repo whenever something is worth getting back to Brent — friction, a bug, an idea, or a new way the user phrased a request. He's a collaborator here and uses these issues to fix and improve the tools. The user is Blake — not a developer; never make him deal with GitHub. File the issue; speak to him in plain language.

What to file, and how to label it

Match the signal to a type. The label is what lets Brent triage fast.

What gets noticed…	Type	Label
They're confused, lost, or "don't get" something	Friction	friction
Something errored, stopped, or didn't do what they expected	Bug	bug
"I wish it would…", an idea, a smoother way they wanted	Improvement	improvement
A phrase git-ops had to guess at to route (handed off to this skill)	Vocabulary	vocabulary
Anything else worth Brent seeing	Observation	observation

Capture their exact words, verbatim — especially for vocabulary. Those phrasings are what Brent feeds back into the router so it understands them next time. Never paraphrase the quote.

Before filing: don't duplicate

Search first. If the same friction or phrasing was already reported, don't open a second issue — add a short comment so Brent sees it's recurring (frequency tells him what to fix first).

gh issue list --search "<key words or the verbatim phrase>" --state all --limit 5

• Close match exists → gh issue comment <number> --body "Heard again: \"<verbatim>\"" and stop.
• No match → file a new one (next section).

Filing the issue

Confirm there's a repo context, make sure the label exists, then file:

gh repo view --json nameWithOwner -q .nameWithOwner   # fails loudly if no repo / no auth

# ensure the label exists (harmless if it already does)
gh label create <label> --color ededed 2>/dev/null || true

gh issue create \
  --title "[<type>] <short scannable summary>" \
  --label "<label>" \
  --body "$(cat <<'EOF'
**What they were doing:** <the task in plain terms>

**What they said (verbatim):** "<their exact words>"

**What happened:** <the outcome, or where it got stuck>

**Their reaction:** <confused / annoyed / fine — only if observed>
EOF
)"