An open source design system that's fully customizable and agent ready
TypeScript
docs: new props/API changes from contributors require human judgment (no AI auto-approve) (#3817)
Cindy Zhang537ccc0bf4d7
diff --git a/.github/instructions/packages.instructions.md b/.github/instructions/packages.instructions.mdindex 44e3796090..af6f393c29 100644--- a/.github/instructions/packages.instructions.md+++ b/.github/instructions/packages.instructions.md@@ -52,6 +52,17 @@ in what order, so effort lands where the risk is — and so the risk checksjudgment"); note it should be spec'd + vibe-tested. Do not verdict the APIyourself.+> **Hard stop — new props / API changes from a contributor need human judgment.**+> If a PR adds a **new prop** or otherwise changes API surface (a new+> component, variant, exported hook/type, or a changed/removed signature) and the+> author is an external/community contributor, the AI reviewer must **not**+> approve or merge it — even if it's clean, additive, and passing CI. Flag it as+> **⚠️ Needs human/maintainer judgment on the API surface** and leave the+> approve/merge decision to a human. "Additive and non-breaking" is *not*+> sufficient to auto-approve API surface — whether the API *should exist* and+> take this shape is a human call. Behavior-only fixes, tests, docs, and chores+> from contributors can still take the fast/standard path.+State the category, the risk (breaking? blast radius?), and the chosen path atthe top of the review, e.g. `Triage: bug fix · non-breaking · low blast radius →fast path`. This makes the depth of review legible and ensures the