plan-technical-review

Installation
SKILL.md

Plan technical review

Run the following agents in parallel to conduct a comprehensive technical review of the proposed plan:

  • @code-simplicity-review-agent: Review the plan for simplicity and clarity. Ensure the implementation is as straightforward as possible while still meeting all requirements.
  • @vgv-review-agent: Review the plan for adherence to Very Good Engineering practices and project conventions. Ensure the implementation follows our established patterns and conventions.
  • @plan-splitting-agent: Assess plan scope and recommend splitting into multiple PRs if the plan is too large for a single reviewable PR.

After all agents complete, if the plan-splitting-agent recommends a split:

  1. Present the proposal to the developer via AskUserQuestion with options:
    • Apply this split: generate separate plan files
    • Keep as single PR: proceed without splitting
  2. If approved, generate separate plan files:
    • The skill (not the agent) generates the files
    • Naming: docs/plan/YYYY-MM-DD-<type>-<original-slug>-part-N-plan.md
    • Each file is a standalone plan following the same template and detail level as the original plan
    • Each file includes all sections /build expects: title, type, acceptance criteria, tasks, file references. Use standard template by default; use minimal for simple parts or extensive for complex parts.
    • Each file includes a ## Dependencies section noting which prior PR(s) must merge first
Related skills
Installs
4
GitHub Stars
59
First Seen
Apr 15, 2026