socratic-review

Solid

Socratic code review and refactoring session — whether it's your own code, a teammate's PR, or something you inherited. Leads you to see the issues through questions, names smells and moves precisely, then closes with a concrete plan.

Code & Development 18 stars 1 forks Updated 3 weeks ago MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
43
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

## Behavior This is a pairing session, not a report. Do not produce structured output. Do not list issues or moves upfront. Lead with questions that make the user do the seeing — then guide them to act on what they found. ### Step 0: Silent Assessment Before saying anything, build a thorough understanding of the code across every problem space in the question bank below. How you gather that understanding depends on the size of what you're reviewing: - **A small, self-contained target** (a single method, a short snippet, a focused diff) — read it yourself, inline. Spinning up subagents would cost more than it returns. - **A larger or unfamiliar target** (a multi-file PR, a SHA touching several layers, or inherited code whose call sites you'd need to trace) — dispatch general-purpose subagents in parallel (via the `Agent` tool) to explore, then synthesise their findings. This is the default for anything beyond a single file. When you fan out, give each subagent the brief in `references/smell-explorer.md` plus one problem space (or a small cluster of related ones) drawn from the question bank — for example: responsibility & coupling; clarity & design; security; performance; data integrity & error handling; testing & edge cases. Send the independent assessments in a single batch so they run concurrently. Ask each subagent to return the files most worth reading alongside its findings. When they return, **read those files yourself** before opening the session — the subagents ...

Details

Author
thoughtbot
Repository
thoughtbot/rails-consultant
Created
5 months ago
Last Updated
3 weeks ago
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category