Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

docs(adr): record check precision defaults in an ADR that amends ADR 0003

Fermée Adaptée aux débutants
  • Quelque chose ne va pas ?
#8,537 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Une pull request liée a déjà été fusionnée.

  • #8707 par @melodic-automation-lanes — fusionnée

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
73/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
markdown, shell
Domaine
documentation

Piste de recherche

Lisez l’ADR 0003 et l’ADR le plus récent, docs/adr/0079-dispatch-tagged-phase-reviews-to-quality-gate-at-the-phase-boundary.md, afin de suivre le format et le contexte des décisions du projet. Créez le prochain ADR numéroté dans docs/adr/, ajoutez l’amendement spécifié et les détails de la décision, puis exécutez scripts/check-adr-numbers.sh --check après modification. La tâche est terminée lorsque l’ADR consigne les règles de précision et d’exception, nomme le critère de l’échelle d’application et #3756, et réussit la vérification des numéros.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

status: ready

Refs: #7572

Agent Brief

Type: Task
Summary: Write one new ADR that amends ADR 0003 with the precision defaults for checks: zero effective false positives for a blocking check, under 10% for an advisory one, plus the exception rules.

Current behavior:

  • docs/adr/0003-verification-guards-earn-default-on-by-measured-precision.md says a guard earns default-on by measured precision but states no number; its reference guard shipped at 57% precision (docs/adr/0003-verification-guards-earn-default-on-by-measured-precision.md:48-49).
  • No ADR carries an Amends: line for ADR 0003 (rg -l 'Amends: \[?ADR 0003' docs/adr prints nothing on main). The newest ADR is docs/adr/0079-dispatch-tagged-phase-reviews-to-quality-gate-at-the-phase-boundary.md.
  • House style for the line is - Amends: [ADR 0049](0049-run-ci-lanes-on-github-hosted-runners-under-trigger-and-token-hardening.md), in the header list (docs/adr/0074-review-risky-dependabot-updates-in-a-model-job-and-act-in-a-scripted-job.md:7).
  • feedback.disable_not_useful_ratio and exceptions.max_days exist only in the decision record, not in any tracked file (rg -n 'disable_not_useful|max_days' docs plugins scripts prints nothing).

Desired behavior:

  • A new docs/adr/NNNN-<kebab-title>.md, numbered one above the highest on main when the lane runs, in the shape of docs/adr/0079-dispatch-tagged-phase-reviews-to-quality-gate-at-the-phase-boundary.md (title, - Status: accepted, - Date:, Context, Decision, Consequences), written the way /architecture:record-decision writes one.
  • Its header list carries - Amends: [ADR 0003](0003-verification-guards-earn-default-on-by-measured-precision.md).
  • Decision text:
    • A blocking check ships with 0 effective false positives on its corpus.
    • An advisory check stays under 10% false positives; the 10% is named as a corpus-precision proxy, not a measured per-guard rate.
    • feedback.disable_not_useful_ratio is not adopted until #3756 produces a per-guard signal.
    • Exceptions expire after 90 days by default, as a team setting.
    • Break glass is an inline exception that carries a reason, an expiry and a person's approval.
    • Existing guards keep their recorded justification; nothing is re-graded by this ADR.
  • Consequences name the enforcement ladder's guardrail criterion (docs/conventions/enforcement-ladder/README.md) as the reader of these numbers, and #3756 as the open work that grades guards.

Key interfaces:

  • docs/adr/0003-verification-guards-earn-default-on-by-measured-precision.md (read; not edited).
  • scripts/check-adr-numbers.sh (the number must not collide).

Acceptance criteria:

  • rg -l 'Amends: \[?ADR 0003' docs/adr lists exactly one file, the new ADR.
  • The new ADR contains 0 effective false positives, 10%, 90 days and #3756 (rg -c '0 effective false positives|10%|90 days|#3756' <new file> is at least 4).
  • scripts/check-adr-numbers.sh --check exits 0.
  • The diff touches only docs/adr/. scripts/check-changelog-fragments.sh --check-required origin/main passes with no fragment, because no plugin's shipped files change.
  • CI's lint-repo job (which runs check-adr-numbers.sh and the markdown lint) passes. In the lane, run scripts/check-adr-numbers.sh --check at most once, after the last edit.

Out of scope:

  • Editing ADR 0003 itself or any guard.
  • Adding the 90-day exception setting to a plugin; this ADR records the default only.
  • The ladder's guardrail criterion text (sibling slice ladder-v2).

Origin:

  • 0 effective false positives blocking, under 10% advisory: ours, from Google's published bar, D31, Q199, D84.
  • 10% named as a corpus-precision proxy: ours, D116, Q559.
  • Drop feedback.disable_not_useful_ratio until #3756: owner's, D84.
  • Exception expiry 90 days as judgment inside the team setting: owner's, D84.
  • Break glass inline exception with reason, expiry and approval: hers (Lauren's), D64.

Do not run with: none. No other open slice edits docs/adr/ for ADR 0003; two ADR-writing PRs racing for one number is caught by check-adr-numbers.sh.

Slice of #7572, drafted by the Issue Triage session from the thread's recorded decisions.

Langage dominant
Shell
Étoiles
22
Forks
2
Merge moyen
3 h 42 min
PR mergées (30 j)
938

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de melodic-software/claude-code-plugins

Toutes les issues de melodic-software/claude-code-plugins

Issues similaires

Plus d'issues Shell/Bash

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.