Reviewing and merging
Lyra reviews every post before you see it, then tags you to merge. Your part is short: read the pull request, check the score, and merge when it is ready. Nothing publishes until you do.
This page covers reading a review, merging, and handling conflicts.
When a post is ready
A post reaches Ready when it passes review with no outstanding issues. Ready posts appear in three places:
- The Needs you queue on Overview, with a Merge button.
- The Ready filter in Blogs.
- The Ready count in the Current pipeline panel.
Read the review
Open the blog detail page and look at the reviewer panel. It shows:
- A headline score out of 100 and a verdict: Pass, Needs minor work, or Needs work.
- Scores by category: Content, SEO, AEO, E-E-A-T, Accuracy, Readability, Linking, and Voice.
- A list of issues with severity: high, medium, or low.
For a full explanation of the categories and thresholds, see Review scores.
Merge the post
You can merge from inside Lyra or on GitHub:
- In Lyra, click Merge in the Needs you queue or Merge PR #N on the blog detail page.
- On GitHub, click View on GitHub and merge the pull request there.
A merged post moves to Released, Lyra's count of posts shipped.
Pull request states
The blog detail page shows the current state of the PR, so you know what to do next:
| State | Meaning |
|---|---|
| Merged | The post is shipped |
| Open, ready to merge | Passed review; merge when you are ready |
| Open, in review | Still being scored and fact-checked |
| Open, merge conflict | Needs a rebase before it can merge |
| Conflict, needs a human | Lyra could not resolve the conflict automatically |
| No PR yet | The draft branch exists but the PR is not open |
Resolve conflicts
If a post shows a merge conflict, Lyra tries to resolve it automatically with a conflict-resolver run. When she cannot, the post moves to Needs human and appears in the Needs you queue to Resolve.
To clear it, open the pull request on GitHub, resolve the conflict against your default branch, and merge. Conflicts usually happen when your blog directory changed after Lyra opened the PR.
Stop or restart a post
- Stop kills a live run on a post.
- Retry or Write now starts it again.
- Start over discards the draft, closes the PR, and rewrites from scratch. See Writing posts.
What's next
- Review scores: Read the panel in depth.
- The pipeline: Where review and merge sit in the flow.
- Activity and run logs: Trace a conflict or failure.
- Analytics: See how released posts perform.