Skip to content

Commit 3c76e61

Browse files
authored
docs: add review escalation rule
1 parent 2ad72ea commit 3c76e61

1 file changed

Lines changed: 45 additions & 0 deletions

File tree

‎docs/REVIEW-ESCALATION-RULE.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Review Escalation Rule
2+
3+
Open Problem Lab should make it clear when ordinary review is not enough.
4+
5+
This guide defines simple triggers for escalating a contribution to stronger review before merge or before treating it as repository knowledge.
6+
7+
## Escalation triggers
8+
9+
Escalate review when a contribution:
10+
11+
- changes an accepted artifact's status or boundary;
12+
- adds a quantitative result used for prioritization;
13+
- changes a generated index or schema-adjacent artifact;
14+
- depends on field assumptions;
15+
- introduces a disputed source;
16+
- changes a review gate, workflow, or governance rule;
17+
- affects a claim where being wrong would waste time, money, reviewer trust, or field capacity.
18+
19+
## Escalation note
20+
21+
```markdown
22+
## Review escalation
23+
24+
**Artifact:** Link to PR, issue, evidence record, or problem-pack section.
25+
26+
**Trigger:** Which escalation trigger applies?
27+
28+
**Needed review:** evidence | domain | quantitative | field | maintainer | replication.
29+
30+
**Risk if skipped:** One sentence.
31+
32+
**Can merge before escalation?** yes | no | only as exploratory.
33+
```
34+
35+
## Reviewer guidance
36+
37+
A reviewer can approve structure while still escalating substance. The PR should not treat partial review as full acceptance.
38+
39+
## Agent guidance
40+
41+
Agents should propose escalation when their work changes status, metrics, review gates, or field-facing claims.
42+
43+
## Acceptance test
44+
45+
The rule works when a contributor can tell whether a PR needs ordinary review, stronger review, or exploratory-only merge.

0 commit comments

Comments
 (0)