---
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:41.293885+00:00"
relations:
  - target: b27fb831-811e-4103-b5f1-3c36d5b1ad20
    type: RELATED_TO
    direction: outgoing
    strength: 0.9
    edge_id: 247edb7f-9fd7-4ee1-91fd-d61b883b9a9e
  - target: 4321bee8-105e-4fc8-b645-964d1234c966
    type: RELATED_TO
    direction: outgoing
    strength: 0.89
    edge_id: a97c61d5-2e7f-4fe0-9e3f-709eb0e6852e
  - target: 4321bee8
    type: RELATED_TO
    direction: outgoing
    strength: 0.88
    edge_id: 8f9e5e42-249a-4978-8086-a9a891b7a880
  - target: b79abde1-7076-4448-aa8e-65a08f354d93
    type: RELATED_TO
    direction: incoming
    strength: 0.8
    edge_id: 27770af7-81d7-461b-a841-638de9e2cc61
---

# 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 |