From 4cc2ca00b1f3abbf858da4835de902186cad2003 Mon Sep 17 00:00:00 2001 From: Lumi AI Workspace Date: Tue, 7 Jul 2026 00:40:03 +0700 Subject: [PATCH] docs: add review escalation rule --- docs/REVIEW-ESCALATION-RULE.md | 45 ++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/REVIEW-ESCALATION-RULE.md diff --git a/docs/REVIEW-ESCALATION-RULE.md b/docs/REVIEW-ESCALATION-RULE.md new file mode 100644 index 0000000..58a2096 --- /dev/null +++ b/docs/REVIEW-ESCALATION-RULE.md @@ -0,0 +1,45 @@ +# Review Escalation Rule + +Open Problem Lab should make it clear when ordinary review is not enough. + +This guide defines simple triggers for escalating a contribution to stronger review before merge or before treating it as repository knowledge. + +## Escalation triggers + +Escalate review when a contribution: + +- changes an accepted artifact's status or boundary; +- adds a quantitative result used for prioritization; +- changes a generated index or schema-adjacent artifact; +- depends on field assumptions; +- introduces a disputed source; +- changes a review gate, workflow, or governance rule; +- affects a claim where being wrong would waste time, money, reviewer trust, or field capacity. + +## Escalation note + +```markdown +## Review escalation + +**Artifact:** Link to PR, issue, evidence record, or problem-pack section. + +**Trigger:** Which escalation trigger applies? + +**Needed review:** evidence | domain | quantitative | field | maintainer | replication. + +**Risk if skipped:** One sentence. + +**Can merge before escalation?** yes | no | only as exploratory. +``` + +## Reviewer guidance + +A reviewer can approve structure while still escalating substance. The PR should not treat partial review as full acceptance. + +## Agent guidance + +Agents should propose escalation when their work changes status, metrics, review gates, or field-facing claims. + +## Acceptance test + +The rule works when a contributor can tell whether a PR needs ordinary review, stronger review, or exploratory-only merge.