> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/using-hivel/cockpit/metrics-and-definitions/quality/review-cycles.md).

# Review Cycles

The Review Cycle Count column is available in the Pull Request tabular view. It shows how many review cycles a pull request went through, so you can see where review feedback and rework are slowing delivery.

### What is a review cycle?

A review cycle is a sequence of comments and commits within a pull request. A cycle is counted when a comment is followed by a commit. A single pull request can have several cycles, each one representing another round of feedback and changes.

### How the count is calculated

| **Pull request state**             | **Review Cycle Count**                          |
| ---------------------------------- | ----------------------------------------------- |
| No comments and no approval        | 0                                               |
| Approved, with or without comments | 1                                               |
| Comments and commits               | One cycle for each comment followed by a commit |
|                                    |                                                 |

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FmrIlt5STcqhU54mDsoIZ%2Fimage.png?alt=media&amp;token=9dd3ccdb-3da0-4188-a621-e316936b1342" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FHHBk5JkanFShv1kyF7T4%2Fimage.png?alt=media&amp;token=787dd463-b28a-40c1-a289-a1a5d478490d" alt=""><figcaption></figcaption></figure>

#### No comments and no approval

If a pull request has neither comments nor an approval, the review cycle count is 0.

#### Approved, with or without comments

If a pull request has been approved, the review cycle count is 1. The approval counts as a review, even if no comments were left.

#### Comments and commits

For pull requests with both comments and commits, the count is based on the number of comment-commit pairs. Each sequence where a comment is followed by a commit counts as one review cycle, so each set of comments followed by a commit increments the count.

### Why it matters

Review Cycle Count helps teams find pull requests that need several rounds of feedback before they are merged. A high count can point to unclear requirements, large changes, or reviews that need more context up front. Use it alongside other review and delivery metrics to spot patterns across teams and repositories.

<br>
