strategy-reviewer

Reviews roadmap pull requests and publishes approval verdicts via GitHub checks.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/volter-ai/open-autonomy-compiler --skill strategy-reviewer-volter-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: strategy-reviewer
Source: https://github.com/volter-ai/open-autonomy-compiler/tree/main/.claude/skills/strategy-reviewer
Command: npx skills add https://github.com/volter-ai/open-autonomy-compiler --skill strategy-reviewer-volter-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Roadmap changes in .open-autonomy/roadmap.yml need an independent gate that judges strategist proposals on merit and planner edits on consistency, without giving the reviewer the ability to merge its own approvals. ## Core Features & Use Cases - Dual-mode review: Classifies the PR diff as a strategist proposal (new proposed: true items judged against the constitution and merit rubric) or a planner operational edit (judged only for consistency with ratified items). - Governance enforcement: Rejects any PR touching files outside the roadmap and strategist archive, such as the constitution, workflows, or skills. - Credential-split publishing: Writes a typed open-autonomy.review.v1 JSON result in trusted-effect mode, or posts the agent-review status last in local compatibility mode, never merging code itself. - Use Case: A strategist agent opens a PR adding three proposed roadmap items; this skill fetches the diff via gh pr view, checks each item for north-star alignment, evidence, and falsifiability, then publishes an approved or changes-requested verdict bound to the exact head SHA. ## Quick Start Review the roadmap pull request referenced by the TARGET_REF environment variable and publish the verdict according to the runner's mode.

Frequently Asked Questions about strategy-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a roadmap pull request automatically?▼

Fetch the PR with `gh pr view "$TARGET_REF"` and `gh pr diff`, classify the diff as a strategist proposal or planner edit, then judge it against the constitution and rubric. Publish the verdict as a typed JSON result or an `agent-review` status depending on the runner mode.

What is the difference between a strategist proposal and a planner operational edit?▼

A strategist proposal adds new items with `proposed: true` and is judged on merit, evidence, and north-star alignment. A planner operational edit only maintains ratified items (decomposition, reordering, wording) and is judged for consistency, never with the merit rubric.

Can the strategy reviewer merge or edit the roadmap itself?▼

No. The reviewer holds `code:review` but deliberately lacks `contents: write`, so it cannot push, merge, or author roadmap items. GitHub auto-merge lands the PR only after required checks pass.

What happens if a roadmap PR touches files outside the roadmap?▼

The governance check fails and the review returns changes-requested. Changes to the constitution, merit criteria, workflows, or skills are never ratified by this reviewer, and code changes are deferred to the code reviewer as not-applicable.

When does the review return human-required instead of pass or fail?▼

Human-required is used only when a specific human judgment is missing, expressed through the schema's typed `humanTask` with an assignee, completion criteria, and response channel. Fixable problems return changes-requested instead.