docs: add TRIAGE.md — issue-triage SLA + canonical label scheme#23
Merged
Conversation
Codifies how inbound issues and discussions are handled across the four quantcli/* repos: - Four priority buckets (critical / high / medium / low) and how triage assigns them; severity-vs-visibility check to avoid loud-but-cosmetic inflation. - Time-to-first-touch SLA per priority for issues vs discussions, measured in US/Eastern business days. First-touch is a triage comment, not a reaction. - Canonical label vocabulary: triage:*, kind:*, area:*, priority:*, and compat:ref. Retains "good first issue" / "help wanted" defaults. - Routing tree by kind+area; security re-routed privately per SECURITY.md before any further public comment. - Repro request template for kind:bug + needs-info. - Out-of-scope list (no roadmap commitments, no upstream-maintainer outreach without board sign-off, no advocacy between exporters). Bulk label application across the four repos is gated on maintainer approval of this PR; this commit only lands the policy. Resolves part of QUA-44. Co-Authored-By: Paperclip <noreply@paperclip.ing>
DTTerastar
approved these changes
May 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
New
TRIAGE.mdat repo root, plus link fromREADME.mdandCONTRIBUTING.md#Questions.The doc codifies:
priority:critical/high/medium/low) with definitions and examples.quantcli/*repos:triage:*,kind:*,area:*,priority:*,compat:ref. GitHub'sgood first issue/help wanteddefaults are kept.kind+area.kind:securityis re-routed privately per SECURITY.md before any further public comment.kind:bug+triage:needs-info, with a 14-day reporter-response window.Why
Today, the four repos run on GitHub default labels only and have no published triage SLA. Reporters don't know what to expect and triage decisions are ad-hoc. This is the first onboarding deliverable for the Community Manager role and the basis for the one-week SLA run that closes QUA-44.
What it implies for the per-service CLIs
quantcli/common,quantcli/crono-export-cli,quantcli/liftoff-export-cli, andquantcli/withings-export-cliis gated on approval of this PR. Once approved, labels are created in a separate, scripted change documented on QUA-44.kind:securitydoes not change the disclosure flow — SECURITY.md remains the source of truth for reporting.Reviewer notes
priority:mediumissues at 2 business days). They can tighten once the one-week run gives us a baseline.priority:critical/high/medium/lowrather than GitHub's default colors so that the labels themselves carry the SLA. This trades the GitHub default scheme for predictability across the four repos.Resolves
Part of QUA-44 (Onboarding #1 for Community Manager).