What problem does it solve?
When implementors complete planned development tasks, they often make unstated risky assumptions or encounter missing context that leads to deviations from the original project plan, undetected bugs, or misaligned features that require costly rework later. This Skill automates the structured review of these assumptions and context gaps to catch issues early, align implementation with intended design, and reduce post-implementation debugging and rework time.
Core Features & Use Cases
- Structured Finding Tracking: Creates a stable finding ledger to track every assumption and context gap, ensuring no issues are dropped during review.
- Automated High-Confidence Fixes: Fixes clear deviations from the plan directly in code or docs without requiring user input, reducing manual review work.
- Clarifying Question Workflow: Presents one ambiguous finding at a time to the user via integrated questioning tools to get precise input without overwhelming them.
- Context Gap Surfacing: Collects missing plan information from implementor reports to help users update future task generation and specs.
- Use Case: After an implementor finishes a set of tasks from a software development plan, run this Skill to audit their session reports for unstated assumptions, fix any clear spec deviations, and resolve ambiguous choices with user input to ensure the final implementation matches the original design intent.
Quick Start
Use the review-assumptions skill to audit the latest implementor session reports for your current project's task set and resolve all flagged assumptions and context gaps.
