Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

plan-review-integrator

Integrate structured review panel findings into an implementation plan document. Takes output from agent-review-panel (or any structured review with severity-rated findings) and cross-references each finding against the plan, classifies it into an action category, applies concrete edits, and produces a traceability summary. Trigger when the user says "update the plan with review findings", "incorporate review feedback into the plan", "integrate review results", "apply review recommendations to the plan", "cross-reference review output against the plan", "merge review findings into the implementation plan", "what needs to change in the plan based on the review", "take the review panel output and update my plan", "reconcile the review feedback with the current plan", or invokes /plan-review-integrator. Does NOT trigger for running a review panel (use agent-review-panel), writing a plan from scratch, general code review, summarizing review findings without applying them, or brainstorming

wan-huiyan · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add wan-huiyan/agent-review-panel --skill plan-review-integrator

About this skill


name: plan-review-integrator version: 2.0.1 author: wan-huiyan description: > Integrate structured review panel findings into an implementation plan document. Takes output from agent-review-panel (or any structured review with severity-rated findings) and cross-references each finding against the plan, classifies it into an action category, applies concrete edits, and produces a traceability summary. Trigger when the user says "update the plan with review findings", "incorporate review feedback into the plan", "integrate review results", "apply review recommendations to the plan", "cross-reference review output against the plan", "merge review findings into the implementation plan", "what needs to change in the plan based on the review", "take the review panel output and update my plan", "reconcile the review feedback with the current plan", or invokes /plan-review-integrator. Does NOT trigger for running a review panel (use agent-review-panel), writing a plan from scratch, general code review, summarizing review findings without applying them, or brainstorming implementation approaches. consumes_from: agent-review-panel hands_off_to: implementation-executor output_contract: > Returns: (1) updated plan document with edits applied, (2) traceability summary table mapping each finding to its disposition, (3) optional peripheral updates (ADRs, runbooks, memory files), (4) integration_log.jsonl append. Idempotent: re-running on the same review+plan produces the same result if no user overrides are applied.

Plan-Review Integrator v2.0

Consumes structured review panel output and integrates findings into an implementation plan document -- turning review feedback into concrete plan updates with full traceability.

Key insight: Review panels often identify correct symptoms but prescribe wrong fixes when they lack domain context. Always validate recommendations against domain-specific constraints before applying them.


Quick Reference

StagePhaseActionOutput
Gather1. Gather InputsCollect review reports + plan + domain contextInput set
2. VoltAgent DetectionDetect specialists, suggest install if beneficialAvailable specialist map
Analyze3. Extract FindingsParse findings with severity, source, citationsStructured finding list
4. Cross-ReferenceMatch each finding against plan contentCategory per finding
5. Actionability FilterScore actionability, drop low-signal findingsFiltered finding list
6. ClassifyAssign action category (epistemic-weighted)must-fix / bundle / defer / info
Apply7. Apply EditsEdit plan document with rollback on coherence breakUpdated plan
8. VerifyRe-read modified plan, check coherenceVerified plan or rollback
Finalize9. Update PeripheralsUpdate ADRs, runbooks, memorySupporting docs
10. Produce SummaryTraceability tableAudit trail
11. Persistent LogAppend decisions to integration logintegration_log.jsonl

Phase 1: Gather Inputs

Collect three things:

  1. Review report(s) -- file path, inline paste, or reference to prior conversation
  2. Plan document -- markdown plan, design doc, RFC, or architecture proposal
  3. Domain context -- memory files, config files, related docs, session history

Domain context is essential for validating reviewer recommendations. Do NOT skip it.

Empty review guard: If the review contains no actionable findings (clean pass), produce no classifications and output: "No action items identified. Plan unchanged." Skip Phases 3-8 and go directly to Phase 10 with a summary confirming the clean review.


VoltAgent Specialist Verification (v1.3)

VoltAgent specialist agents (130+ across 10 families) have built-in domain expertise via their system prompts. Unlike agent-review-panel (which replaces reviewer personas with VoltAgent agents), this skill uses VoltAgent as an optional second-opinion verifier for high-severity edits. The skill remains single-agent; specialists are consulted, not orchestrated. Full catalog: github.com/VoltAgent/awesome-claude-code-subagents

Step 1: Detection. During Phase 1 (Gather Inputs), scan the system-reminder agent list for any voltagent-* prefixed agents. Note which families are installed (e.g., voltagent-data-ai, voltagent-infra, voltagent-lang). If none found, skip all VoltAgent steps silently -- everything works without them.

Step 2: Content-signal routing. Match plan content signals to specialists:

Content SignalVoltAgent SpecialistVerification Use
SQL / database queriesvoltagent-data-ai:database-optimizerVerify query correctness in must-fix edits
Data pipelines / ETLvoltagent-data-ai:data-engineerVerify pipeline logic changes
ML / model trainingvoltagent-data-ai:ml-engineerVerify model config / hyperparameter fixes
Python codevoltagent-lang:python-proVerify code snippet corrections
TypeScript codevoltagent-lang:typescript-proVerify TS code corrections
Go codevoltagent-lang:golang-proVerify Go code corrections
Rust codevoltagent-lang:rust-engineerVerify Rust code corrections
Java / Springvoltagent-lang:java-architectVerify Java code corrections
Terraform / IaCvoltagent-infra:terraform-engineerVerify infra changes in plan edits
Kubernetes / k8svoltagent-infra:kubernetes-specialistVerify k8s manifest changes
Docker / containersvoltagent-infra:docker-expertVerify container config changes
CI/CD / pipelinesvoltagent-infra:deployment-engineerVerify deployment procedure edits
Security / authvoltagent-qa-sec:security-auditorVerify security fix correctness
Performance / scalingvoltagent-qa-sec:performance-engineerVerify performance-re
Read the complete source ↗