planning-reviews

What problem does it solve?

This Skill ensures planning-phase plans are understandable, structurally complete, and safely positioned for implementation by running required review passes and recording findings with dispositions in the plan artifact.

Core Features & Use Cases

• Planning review orchestration: Executes the required planning reviews (zero-context, implementer readiness, expert technical when triggered, security/privacy, human readability, and automation readiness when applicable) and merges the results into the plan’s ## Planning Reviews section.
• Evidence-grounded security/privacy checks: Performs a security/privacy review grounded in the current plan state and requires explicit evidence hooks for trust-boundary claims, emitting findings that drive remediation when evidence is missing.
• Deterministic disposition workflow: Produces stable, review-type-specific findings with F-xxx ids and exhaustive dispositions (Accept/Reject/Defer), including DR references and patch targets.
• Safety guardrails for human agency: Supports auto-remediation only for clarity/structure issues that don’t change decisions, while requiring explicit human A/R/D for policy, trust boundaries, unknowns, or decision-affecting items.
• Required review schemas: Uses the mandated review schemas so downstream validators and agents can parse findings and dispositions reliably.

Quick Start

Use the planning-reviews skill during the Reviews stage (after Implementation but before plan approval) to refresh planning review findings and write dispositions into the current plan artifact for the next approval loop.