plan-eng-review

The plan-eng-review skill is designed to assist engineering managers and developers in reviewing and solidifying technical plans before implementation. It focuses on evaluating architecture, data flow, diagrams, edge cases, test coverage, and performance considerations. By providing structured guidance and opinionated recommendations, this skill helps identify potential issues early in the development process, reducing the risk of costly design flaws and improving overall code quality. Its proactive nature ensures that plans are thoroughly vetted before coding begins, streamlining collaboration and decision-making within engineering teams.

The skill offers several core capabilities. It can interactively walk users through technical plans, highlighting areas that may need attention and suggesting improvements. It tracks execution plans and provides mechanisms for locking in the architecture and design decisions. Additionally, it manages session and telemetry data to monitor usage, ensures compliance with the Completeness Principle (encouraging complete solutions when feasible), and respects user preferences regarding proactive suggestions and data sharing. The skill also integrates with version control metadata, providing contextual awareness of the current branch and repository state.

Typical use cases include reviewing architecture and engineering plans, conducting pre-implementation checks, and offering guidance on test coverage and performance considerations. Target users are engineering managers, senior developers, and team leads who want to ensure that designs are robust and that potential issues are addressed before development begins. It is particularly useful when a developer is about to start coding from a design document or planning a new feature, as it can proactively identify gaps or weaknesses in the proposed implementation.