checking-simplicity

Assesses architectures, plans, and code for unnecessary complexity against stated needs.

6|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/jrgilbertson/the-rookery --skill checking-simplicity-jrgilbertson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: checking-simplicity
Source: https://github.com/jrgilbertson/the-rookery/tree/main/skills/checking-simplicity
Command: npx skills add https://github.com/jrgilbertson/the-rookery --skill checking-simplicity-jrgilbertson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Software designs, plans, and implementations often accumulate machinery beyond what the current need requires. This Skill provides a read-only assessment that identifies overengineering and recommends the smallest safe alternative, so teams avoid building and maintaining complexity nobody asked for. ## Core Features & Use Cases - Necessity testing: Compares each boundary, responsibility, and data path against actual consumers and protected constraints using a remove-reuse-native-build ladder. - Independent review: Dispatches a subagent reviewer that has not authored the subject, returning a single structured readout without editing files. - Decision framing: Builds a fixed frame from the user's stated goals, hard constraints, and behaviors that must be preserved, treating unverified additions as proposals. - Use Case: Before implementing a plan that introduces a new caching layer and message queue, run this Skill to check whether reusing an existing mechanism or a native platform capability satisfies the stated need with less machinery. ## Quick Start Ask the agent to check whether the proposed architecture for the notification service can be simplified against the current requirements.

Frequently Asked Questions about checking-simplicity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my software architecture is overengineered?▼

Name the architecture or design as the review subject and state the current need it serves. The reviewer compares each component against actual consumers and protected constraints, then recommends the smallest safe alternative with evidence for each removal.

How to simplify a technical plan before implementation?▼

Submit the plan with its stated goal, hard constraints, and behaviors that must be preserved. The assessment climbs a remove-reuse-native-build ladder and stops at the first approach that fully satisfies the current need.

Does this simplicity check modify my code or files?▼

No, the assessment is strictly read-only. The reviewer returns a readout containing the recommendation and evidence without revising the subject, editing repository files, committing, or approving shipping decisions.

When should I not use a simplicity assessment?▼

Use code review for bugs, regressions, tests, and standards instead. Document review fits plan completeness or writing quality, and PR readiness handles shipping decisions; direct behavior-preserving cleanup of settled code belongs to implementation.

Can the same reviewer who wrote the design run the check?▼

No, the dispatched reviewer must not have authored or implemented the subject under review. Having reviewed an earlier revision is acceptable, and the assessment consists of one reviewer producing one readout.