store: PR Reviewer Label Convention and State Machine

graph/workflows/pr-reviewer-label-convention-and-state-machine-1c58a8.md

@@ -0,0 +1,40 @@
+---
+id: 1c58a8f4-ad77-4dd7-aa1a-f6e3b7f628de
+type: workflow
+title: "PR Reviewer Label Convention and State Machine"
+tags: [pr-reviewer, gitea, labels, workflow, automation]
+importance: 0.6
+confidence: 0.8
+created: "2026-03-02T21:57:20.947377+00:00"
+updated: "2026-03-02T21:57:20.947377+00:00"
+---
+
+# PR Reviewer Label Convention and State Machine
+
+## Label State Machine
+
+```
+(open PR, no ai labels)
+        |
+        v
+  ai-reviewing          orange #f39c12 — review in progress
+        |
+   +---------+
+   |         |
+   v         v
+ai-reviewed  ai-changes-requested
+green        red
+#27ae60      #e74c3c
+(approved)   (issues found)
+```
+
+## Dispatcher Behavior
+- Skips PRs that already have any of the three labels: `ai-reviewing`, `ai-reviewed`, `ai-changes-requested`
+- Labels are created automatically if they don't exist in a repo
+
+## Label Details
+| Label | Color | Meaning |
+|-------|-------|---------|
+| `ai-reviewing` | `#f39c12` (orange) | Review agent is currently running |
+| `ai-reviewed` | `#27ae60` (green) | Review complete, approved |
+| `ai-changes-requested` | `#e74c3c` (red) | Review complete, changes needed |