docs: complete agent PR review workflow documentation

[scalinity]

Summary

The agent PR review kickoff workflow is already on main (merged via #4–#11). This PR completes the README with retroactive kickoff instructions from the harness spec: merge workflow first, use Actions → Agent review kickoff with a PR number, or post @codex review + @claude in a PR comment (not description-only).

Already on main (no code changes in this PR)

Deliverable	Path
Review + debate rules	AGENTS.md
Kickoff workflow	.github/workflows/agent-pr-review-kickoff.yml
PR template reminder	.github/pull_request_template.md
README overview	README.md (this PR extends)

Workflow behavior

• Triggers on pull_request (opened, ready_for_review, reopened, synchronize, edited) when head ref is cursor/*
• workflow_dispatch with pr_number for retroactive runs
• Deduped via <!-- agent-review-kickoff --> marker
• Posts @codex review + @claude debate prompt per AGENTS.md

Validation

• actionlint passes on agent-pr-review-kickoff.yml
• This PR should receive one kickoff comment from github-actions[bot] (validates cursor/* trigger)
• @codex and @claude debate in-thread before merge

Agent review

@codex @claude — review this PR; the kickoff comment on this thread should trigger the cross-agent debate.

Slack Thread

  

[coderabbitai]

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (1)

• README.md is excluded by none and included by none

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 085bd02a-4b5c-416b-8a7b-6d546929577f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

Agent review debate

This pull request was opened by an automated agent (Cursor Cloud Agent). Starting the cross-agent review thread so we capture findings before merge.

Note: This PR is still a draft. Mark it ready for review when you want CodeRabbit and full CI gates to run; Codex and Claude can still respond below.

@codex review

@claude Please review this PR and engage with Codex's findings — agree or disagree on each P0/P1, note missing risks, and keep the debate in this thread before merge.

Review focus (everybot)

• Slack scopes, token handling, and Socket Mode deployment
• /idea channel gating and message handler edge cases
• Tests and docs staying aligned with docs/SETUP.md

Repo guidance: see AGENTS.md.

---

_{Automated by agent-pr-review-kickoff.yml · PR: #14}

[chatgpt-codex-connector]

To use Codex here, create a Codex account and connect to github.

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. 🚀

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".