Add decision gate constraints and review checklist

README.md

@@ -159,6 +159,7 @@ your-project/
 | **Windsurf** | `.windsurf/rules/agdr.md` | [tools/windsurf/](tools/windsurf/) |
 | **Any AI** | System prompt | [tools/system-prompts/](tools/system-prompts/) |
 | **Git** | Pre-commit hook | [tools/git-hooks/](tools/git-hooks/) |
+| **Review** | Checklist | [agdr-review.md](agdr-review.md) |
 
 ### Claude Code
 

agdr-review.md

@@ -0,0 +1,19 @@
+# AgDR Review Checklist
+
+Use when reviewing Agent Decision Records in pull requests or post-decision audits.
+
+## Inhibition-Based Review
+
+Before approving an AgDR, resolve these constraints:
+
+- [ ] **Do not** accept the decision without examining the premise — is the real problem correctly identified?
+- [ ] **Do not** approve if only one option was seriously considered — are alternatives genuinely viable?
+- [ ] **Do not** approve vague pros/cons — reject "faster" or "better" without measurable specifics
+- [ ] **Do not** approve without checking the Y-statement captures the actual tradeoff being accepted
+- [ ] **Do not** approve if consequences are all positive — every decision has downsides
+
+## Review Questions
+
+1. What would make this decision wrong?
+2. What's the strongest argument against this choice?
+3. Under what conditions would another option have been better?

commands/decide.md

@@ -10,6 +10,16 @@ Forces structured decision-making and creates an auditable Agent Decision Record
 /decide how to implement caching
 ```
 
+## Decision Gate Constraints
+
+Before creating an AgDR, resolve these constraints:
+
+- **Do not** document a decision before understanding the real problem
+- **Do not** accept the first option — at least 2 viable alternatives must be compared
+- **Do not** list pros/cons you haven't verified — base claims on evidence
+- **Do not** write "better" or "faster" without specifics — use measurable criteria
+- **Do not** proceed without naming the tradeoff you're accepting
+
 ## Process
 
 ### 1. Parse Decision Topic

skills/decide/SKILL.md

@@ -15,6 +15,16 @@ Forces structured decision-making and creates an auditable Agent Decision Record
 /decide how to implement caching
 ```
 
+## Decision Gate Constraints
+
+Before creating an AgDR, resolve these constraints:
+
+- **Do not** document a decision before understanding the real problem
+- **Do not** accept the first option — at least 2 viable alternatives must be compared
+- **Do not** list pros/cons you haven't verified — base claims on evidence
+- **Do not** write "better" or "faster" without specifics — use measurable criteria
+- **Do not** proceed without naming the tradeoff you're accepting
+
 ## Process
 
 ### 1. Parse Decision Topic

tools/codex/agdr-decide/SKILL.md

@@ -7,6 +7,16 @@ description: Enforce Agent Decision Record (AgDR) workflow in Codex. Use when ma
 
 Follow this process before implementation whenever the decision is non-trivial.
 
+## Decision Gate Constraints
+
+Before creating an AgDR, resolve these constraints:
+
+- **Do not** document a decision before understanding the real problem
+- **Do not** accept the first option — at least 2 viable alternatives must be compared
+- **Do not** list pros/cons you haven't verified — base claims on evidence
+- **Do not** write "better" or "faster" without specifics — use measurable criteria
+- **Do not** proceed without naming the tradeoff you're accepting
+
 ## 1. Parse the Decision Topic
 
 Extract the specific decision from the user request and restate it clearly.

tools/copilot/copilot-instructions.md

@@ -8,6 +8,16 @@ When you detect a decision point, STOP before implementing. Compare at least 2 r
 
 Every AgDR must include a Y-statement summary: "In the context of [situation], facing [concern], I decided [decision] to achieve [goal], accepting [tradeoff]."
 
+### Decision Gate Constraints
+
+Before creating an AgDR, resolve these constraints:
+
+- **Do not** document a decision before understanding the real problem
+- **Do not** accept the first option — at least 2 viable alternatives must be compared
+- **Do not** list pros/cons you haven't verified — base claims on evidence
+- **Do not** write "better" or "faster" without specifics — use measurable criteria
+- **Do not** proceed without naming the tradeoff you're accepting
+
 Do not create AgDRs for trivial choices like variable names, formatting, or following existing project conventions.
 
 Reference: https://github.com/me2resh/agent-decision-record

tools/cursor/.cursorrules

@@ -14,6 +14,14 @@
 # - Making an architectural choice → STOP, document decision first
 # - Adding a new dependency → STOP, document decision first
 
+# DECISION GATE CONSTRAINTS
+# Before creating an AgDR, resolve these constraints:
+# - Do not document a decision before understanding the real problem
+# - Do not accept the first option — at least 2 viable alternatives must be compared
+# - Do not list pros/cons you haven't verified — base claims on evidence
+# - Do not write "better" or "faster" without specifics — use measurable criteria
+# - Do not proceed without naming the tradeoff you're accepting
+
 # TEST: If someone asked "why did you choose X over Y?" and you'd need to explain
 # trade-offs, that's a decision. Document it.
 

tools/cursor/agdr.mdc

@@ -23,6 +23,16 @@ Before writing any code, scan your planned response for these patterns. If any m
 
 **Test:** If someone asked "why did you choose X over Y?" and you'd need to explain trade-offs, that's a decision. Document it.
 
+## Decision Gate Constraints
+
+Before creating an AgDR, resolve these constraints:
+
+- **Do not** document a decision before understanding the real problem
+- **Do not** accept the first option — at least 2 viable alternatives must be compared
+- **Do not** list pros/cons you haven't verified — base claims on evidence
+- **Do not** write "better" or "faster" without specifics — use measurable criteria
+- **Do not** proceed without naming the tradeoff you're accepting
+
 ## When to Create an AgDR
 
 - Library/framework selection (e.g., "use Zustand over Redux")

tools/system-prompts/agdr-enforcement.md

@@ -16,6 +16,15 @@ When making technical decisions during coding, you MUST create an Agent Decision
 - Picking an implementation approach
 - Making an architectural choice
 
+### Decision Gate Constraints
+
+Before creating an AgDR, resolve these constraints:
+- Do not document a decision before understanding the real problem
+- Do not accept the first option — at least 2 viable alternatives must be compared
+- Do not list pros/cons you haven't verified — base claims on evidence
+- Do not write "better" or "faster" without specifics — use measurable criteria
+- Do not proceed without naming the tradeoff you're accepting
+
 ### AgDR Format
 
 Create a markdown file at `docs/agdr/AgDR-{NNNN}-{slug}.md`:

tools/windsurf/agdr.md

@@ -22,6 +22,16 @@ Before writing any code, scan your planned response for these patterns. If any m
 
 **Test:** If someone asked "why did you choose X over Y?" and you'd need to explain trade-offs, that's a decision. Document it.
 
+## Decision Gate Constraints
+
+Before creating an AgDR, resolve these constraints:
+
+- **Do not** document a decision before understanding the real problem
+- **Do not** accept the first option — at least 2 viable alternatives must be compared
+- **Do not** list pros/cons you haven't verified — base claims on evidence
+- **Do not** write "better" or "faster" without specifics — use measurable criteria
+- **Do not** proceed without naming the tradeoff you're accepting
+
 ## When to Create an AgDR
 
 - Library/framework selection