What problem does it solve? Agent-generated plans often fail at two altitudes: they are either too vague ("add caching", "handle auth") or lost in low-level detail with no product vision. This Skill treats the plan as junior work, builds a senior reviewer grounded in live codebase research and current best practices, then diagnoses and rewrites the plan into a scoped, evidence-backed version. ## Core Features & Use Cases - Altitude Diagnosis: Classifies each plan section as fog (too vague), tunnel (too granular), or mixed using concrete checklists and a vague-word blacklist. - Evidence-Based Adversarial Review: Every finding cites a file and line from the repository or a dated web source, with blocker/major/minor severities and concrete fixes. - Plan Promotion: Produces a rewritten senior plan with goals, decisions with rationale, interfaces, sequencing, rollback strategy, and open questions for humans. - Use Case: After an agent drafts a migration plan, invoke the review to catch that the plan targets an API the pinned dependency version does not have, then receive a corrected, sequenced rewrite. ## Quick Start Ask the assistant to run a junior-to-senior senior review on the plan it just produced before committing to it.
