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-integratorAbout 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
| Stage | Phase | Action | Output |
|---|---|---|---|
| Gather | 1. Gather Inputs | Collect review reports + plan + domain context | Input set |
| 2. VoltAgent Detection | Detect specialists, suggest install if beneficial | Available specialist map | |
| Analyze | 3. Extract Findings | Parse findings with severity, source, citations | Structured finding list |
| 4. Cross-Reference | Match each finding against plan content | Category per finding | |
| 5. Actionability Filter | Score actionability, drop low-signal findings | Filtered finding list | |
| 6. Classify | Assign action category (epistemic-weighted) | must-fix / bundle / defer / info | |
| Apply | 7. Apply Edits | Edit plan document with rollback on coherence break | Updated plan |
| 8. Verify | Re-read modified plan, check coherence | Verified plan or rollback | |
| Finalize | 9. Update Peripherals | Update ADRs, runbooks, memory | Supporting docs |
| 10. Produce Summary | Traceability table | Audit trail | |
| 11. Persistent Log | Append decisions to integration log | integration_log.jsonl |
Phase 1: Gather Inputs
Collect three things:
- Review report(s) -- file path, inline paste, or reference to prior conversation
- Plan document -- markdown plan, design doc, RFC, or architecture proposal
- 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 Signal | VoltAgent Specialist | Verification Use |
|---|---|---|
| SQL / database queries | voltagent-data-ai:database-optimizer | Verify query correctness in must-fix edits |
| Data pipelines / ETL | voltagent-data-ai:data-engineer | Verify pipeline logic changes |
| ML / model training | voltagent-data-ai:ml-engineer | Verify model config / hyperparameter fixes |
| Python code | voltagent-lang:python-pro | Verify code snippet corrections |
| TypeScript code | voltagent-lang:typescript-pro | Verify TS code corrections |
| Go code | voltagent-lang:golang-pro | Verify Go code corrections |
| Rust code | voltagent-lang:rust-engineer | Verify Rust code corrections |
| Java / Spring | voltagent-lang:java-architect | Verify Java code corrections |
| Terraform / IaC | voltagent-infra:terraform-engineer | Verify infra changes in plan edits |
| Kubernetes / k8s | voltagent-infra:kubernetes-specialist | Verify k8s manifest changes |
| Docker / containers | voltagent-infra:docker-expert | Verify container config changes |
| CI/CD / pipelines | voltagent-infra:deployment-engineer | Verify deployment procedure edits |
| Security / auth | voltagent-qa-sec:security-auditor | Verify security fix correctness |
| Performance / scaling | voltagent-qa-sec:performance-engineer | Verify performance-re |