mcpField
P
plan-self-review

plan-self-review

github.com/hrdtbsAgent workflows052 installsUpdated 17w ago
Repository

About plan-self-review

plan-self-review is an agent skill for checking plans immediately after they are created or revised. It scores clarity, coverage, feasibility, and consistency, then identifies gaps and guides improvements.

Key features

  1. 01Four-part plan scoring
  2. 02Prioritized deficiency checklist
  3. 03Plan improvement and final check
  4. 04Structured review output

Use cases

  1. 01Reviewing a newly drafted implementation plan
  2. 02Checking an updated plan before execution

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hrdtbs/agent-skills --skill plan-self-review

After installing, type/plan-self-reviewin Claude Code to confirm it loaded.

Details

From the project README

Plan Self-Review

Use this skill immediately after creating or updating a plan. Catching logical gaps, ambiguous steps, or missing dependencies early prevents cascading failures during execution. Self-reviewing your plan helps you approach the problem methodically and reduces the likelihood of needing major revisions later.

Review Steps

  1. Score Plan (100pt): Evaluate the plan based on the following criteria:
    • Clarity (25): Are the steps clear and easy to follow? Do they specify which files and tools will be used?
    • Comprehensiveness (25): Does the plan cover all necessary aspects of the task? Are there any unaddressed edge cases?
    • Feasibility (25): Are the steps achievable with the available tools and context? Do you have enough information to execute them?
    • Consistency (25): Are there any logical contradictions or missing elements? Do the steps follow a logical sequence?
  2. List Deficiencies: Create a prioritized task list (- [ ]) of any gaps, omissions, or ambiguities found in the plan.
  3. Improve: Edit the plan to resolve the identified deficiencies. Update the plan using the appropriate tool.
  4. Final Check: Perform a final check to confirm no logical contradictions or missing elements remain.

Output Format

Present your review using the following structure:

Self-Evaluation Score: [Score]/100
  • Clarity: [Score]/25
  • Comprehensiveness: [Score]/25
  • Feasibility: [Score]/25
  • Consistency: [Score]/25
Deficiencies
  • [Deficiency 1]
  • [Deficiency 2]
Improvements Made
  • [Briefly describe the improvements made to the plan]
Final Check
  • [Confirm that the plan is now logically sound and complete]

Examples

Example 1: Reviewing a plan for adding a new API endpoint

Initial Plan:

  1. Create new endpoint.
  2. Update tests.

Self-Review Output:

Self-Evaluation Score: 40/100
  • Clarity: 10/25 (Missing details on which file to edit and what the endpoint does)
  • Comprehensiveness: 10/25 (Missing documentation update, error handling details)
  • Feasibility: 10/25 (Too vague to execute without further clarification)
  • Consistency: 10/25 (Logically sound but lacks concrete steps)
Deficiencies
  • Specify the exact file and route for the new endpoint
  • Add error handling requirements
  • Identify which test file needs to be updated and what test cases to add
  • Include a step to update the API documentation
Improvements Made
  • Updated the plan to specify the target file (src/api/users.js) and route (POST /users).
  • Added a sub-step for implementing input validation and error handling.
  • Specified the test file (tests/api/users.test.js) and explicitly required testing the error cases.
  • Added a step to update docs/api.md.
Final Check
  • The revised plan is now clear, comprehensive, and specifies exact files and actions. It is logically sound and ready for execution.

Comments

Markdown supported