Skip to content

Validate and document the PR review loop end-to-endΒ #19

Description

@ProtocolWarden

Context

The two-phase PR review loop (self-review via kodo β†’ human escalation via πŸ‘ or comment) is implemented but hasn't been exercised end-to-end in a documented way. Trust in the write path requires a validation pass and an operator guide.

Goal

Run the PR review loop against at least one real PR (or a controlled test PR) and document the audit trail. Create docs/operator/pr_review.md covering:

  • How the self-review phase works (what kodo reads, what LGTM/CONCERNS means)
  • How human escalation is triggered
  • Guardrail checklist (bot safety contract, <!-- controlplane:bot --> marker, allowed_reviewer_logins)
  • What to do when a review gets stuck

Acceptance Criteria

  • docs/operator/pr_review.md exists
  • At least one end-to-end review run is documented (even if synthetic)
  • Guardrail checklist is complete and accurate

Labels

pr-review, operator-docs, trust

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions