---
name: gh-pr-to-green
description:
  Finish a GitHub PR by using gh to gather full PR context, creating a markdown todo list of open
  review comments, addressing them (err on the side of fixing), running council-review and the
  repo-required checks (often `yarn check`), committing/pushing updates, and monitoring CI until
  green. Use when asked to finish/land/complete a PR or resolve review comments.
---

# GH PR to Green

## Workflow

- Get context from PR with `gh`; make sure all review comments, threads, CI failures, and PR
  description updates are included.
- Write them as a markdown todolist in
  `repodocs/prompts/${YYYY}-${MM}-${DD}-${sluggedSemanticTopic}.md` and commit it. If the
  `repodocs/prompts/` dir does not exist, use the `docs/prompts/` dir.
- Merge the latest main into our branch and resolve any conflict carefully.
- Determine which review items are correct.
- Keep working until all items are checked off, either by fixing the issue, or explaining why not in
  the markdown list as well as comments in code where applicable/sensible.
- Commit and push.
- Invoke `council-review`
- If the PR has UI/UX impact, invoke `claude-usertest` instead of duplicating browser-test
  instructions here. Treat its output as reviewer input, reconcile findings yourself, and fold valid
  fixes back into this PR-to-green loop.
- Run the repo-required checks (often `yarn check`).
- Fix any issue that you deem related and worth fixing.
- Commit and push.
- Monitor CI until green:
  - Prefer `gh run watch` (works everywhere with `gh`).
  - If `gh-run-watch.ts` exists in the repo, it's fine to use that too.
- Fix any issue that you deem related and worth fixing.
- Rinse and repeat until CI is green, or there are only 100% unrelated issues remaining.

This skill is PR orchestration only. Do not add inline UX/browser/user-test instructions here; use
dedicated validation skills for those workflows.

Report back with a list of all changes made, and offer a link to the PR for inspection and merge.
Offer to squash merge with `--admin` if the human thinks a last manual review is not needed.