f37546c6fc
- Update all AGENTS.md watermarks to current HEAD (251d160)
- dev/AGENTS.md: document dev-poll's early direct-merge scan (before lock
check) — approved PRs now merge without waiting for active dev sessions;
chore/gardener PRs merge without issue numbers in branch name
- planner/AGENTS.md: document dispatch-idle-formulas phase (step 4); note
that planner reads both factory and project-specific formulas; clarify
that all planner artifacts use $PROJECT_REPO_ROOT, not $FACTORY_ROOT
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
<!-- last-reviewed: 251d160e213b19a4fcc0cd8f8e3be9ea3283887f -->
|
|
# Review Agent
|
|
|
|
**Role**: AI-powered PR review — post structured findings and formal
|
|
approve/request-changes verdicts to Codeberg.
|
|
|
|
**Trigger**: `review-poll.sh` runs every 10 min via cron. It scans open PRs
|
|
whose CI has passed and that lack a review for the current HEAD SHA, then
|
|
spawns `review-pr.sh <pr-number>`.
|
|
|
|
**Key files**:
|
|
- `review/review-poll.sh` — Cron scheduler: finds unreviewed PRs with passing CI
|
|
- `review/review-pr.sh` — Creates/reuses a tmux session (`review-{project}-{pr}`), injects PR diff, waits for Claude to write structured JSON output, posts markdown review + formal Codeberg review, auto-creates follow-up issues for pre-existing tech debt
|
|
|
|
**Environment variables consumed**:
|
|
- `CODEBERG_TOKEN` — Dev-agent token (must not be the same account as REVIEW_BOT_TOKEN)
|
|
- `REVIEW_BOT_TOKEN` — Review-agent token for approvals (use human/admin account; branch protection: in approvals whitelist)
|
|
- `CODEBERG_REPO`, `CODEBERG_API`, `PROJECT_NAME`, `PROJECT_REPO_ROOT`
|
|
- `PRIMARY_BRANCH`, `WOODPECKER_REPO_ID`
|
|
- `MATRIX_TOKEN`, `MATRIX_ROOM_ID`, `MATRIX_HOMESERVER`
|