feat(pr-reviewer): read the repo's AGENTS.md and guideline docs before reviewing

plugins/pr-review/scripts/prompt.py

@@ -78,6 +78,8 @@
 
 For dependency update PRs, do **NOT** approve a target version that was published less than 7 days ago. First-party packages maintained by the same organization as the reviewed repository are intentionally excluded from this 7-day waiting rule, but still scrutinize them for supply-chain risk.
 
+Before reviewing, you MUST read the repository's own guidance to understand the repo first: read `AGENTS.md` at the repository root (and any nested `AGENTS.md` covering the changed files), plus other relevant docs when present — e.g. `CONTRIBUTING.md`, `CLAUDE.md`, `.cursorrules`, and any review or coding-guideline docs. Apply that guidance to your review.
+
 Review the PR changes below and identify issues that need to be addressed.
 
 ## Pull Request Information

skills/github-pr-reviewer/scripts/main.py

@@ -808,7 +808,12 @@ def _build_review_prompt(repo: str, pr: dict, head_sha: str, label_event: dict,
         "Required workflow:\n"
         "1. The workspace is already the repository root at the exact Head SHA above. "
         "Do not clone, fetch, check out, or delete the repository.\n"
-        "2. Inspect the PR discussion, existing review comments, changed files, and the diff, "
+        "2. Before reviewing, you MUST read the repository's own guidance to understand the repo first.\n"
+        "   Read `AGENTS.md` at the repository root (and any nested `AGENTS.md` covering the "
+        "changed files), plus other relevant docs when present - e.g. `CONTRIBUTING.md`, "
+        "`CLAUDE.md`, `.cursorrules`, and any review or coding-guideline docs. Apply that "
+        "guidance to your review.\n"
+        "   Then inspect the PR discussion, existing review comments, changed files, and the diff, "
         "together with the surrounding code in the workspace.\n"
         "   Use `gh` or GitHub REST API calls with `GITHUB_PERSONAL_ACCESS_TOKEN`; never print secret values.\n"
         "3. Ground every finding in the workspace code. Before using an inline location, verify that "

skills/github-pr-reviewer/tests/test_main.py

@@ -509,6 +509,19 @@ def test_no_guide_section_when_guide_is_none(self):
         )
         self.assertNotIn("Repo-specific review guide", prompt)
 
+    def test_prompt_requires_reading_repository_guidance(self):
+        prompt = main._build_review_prompt(
+            "owner/repo",
+            self._pr(),
+            "0123456789abcdef",
+            {"id": "1", "created_at": "t"},
+        )
+
+        self.assertIn("MUST read", prompt)
+        self.assertIn("AGENTS.md", prompt)
+        self.assertIn("CONTRIBUTING.md", prompt)
+        self.assertIn("nested `AGENTS.md`", prompt)
+
 
 class TestNormalizeRepo(unittest.TestCase):
     """A repository is written down in more than one way, and every API path in

skills/openhands-sdk/SKILL.md

@@ -198,6 +198,7 @@ Source: [`examples/`](https://github.com/OpenHands/software-agent-sdk/tree/main/
 - [`55_persistent_memory.py`](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/01_standalone_sdk/55_persistent_memory.py)
 - [`56_structured_output.py`](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/01_standalone_sdk/56_structured_output.py)
 - [`57_prompt_hooks`](https://github.com/OpenHands/software-agent-sdk/tree/main/examples/01_standalone_sdk/57_prompt_hooks)
+- [`58_ask_oracle_tool`](https://github.com/OpenHands/software-agent-sdk/tree/main/examples/01_standalone_sdk/58_ask_oracle_tool)
 
 ### [`02_remote_agent_server/`](https://github.com/OpenHands/software-agent-sdk/tree/main/examples/02_remote_agent_server)
 

tests/test_pr_review_prompt.py

@@ -59,6 +59,16 @@ def test_prompt_with_roasted_trigger():
     assert "/codereview-roasted" in prompt
 
 
+def test_prompt_instructs_reading_repo_guidance():
+    """The reviewer must be told to read AGENTS.md (and other guideline docs)
+    to understand the repo before reviewing."""
+    prompt = _format_prompt(require_evidence=False)
+
+    assert "AGENTS.md" in prompt
+    assert "MUST read" in prompt
+    assert "CONTRIBUTING.md" in prompt
+
+
 def test_format_prompt_omits_evidence_requirements_by_default():
     prompt = _format_prompt(require_evidence=False)