surgical-level precision. surgical-level pragmatism. Zero-bloat engineering.
The Problem • Features • Workflow • Install
A Gemini CLI extension that transforms the model into a disciplined, surgical engineer.
Inspired by Andrej Karpathy's observations on LLM coding pitfalls, surgical-dev enforces a strict behavioral layer that prioritizes minimal diffs, existing style preservation, and goal-driven verification.
AI coding agents are sometime "too helpful": they refactor unrelated code, add speculative abstractions, and fix bugs without reproduction.
|
|
Minimal diffs. Zero noise. Maximum impact.
| Feature | What it do | Trigger |
|---|---|---|
| Dense Context | High-density rules in GEMINI.md for minimal token overhead. |
Automatic |
| Audit Command | Reviews your plan/diff for over-engineering or scope creep. | /surgical:audit |
| Reviewer Agent | Delegate strict code reviews to a surgical specialist sub-agent. | gemini delegate surgical-reviewer |
| Surgical Skill | Deep "behavioral reset" for complex tasks. (≈500 tokens) | Activate surgical-standards |
Follow this workflow to maintain surgical-level discipline in every session.
When: After the model proposes a plan, but before you say "Go."
Why: Forces the model to review its own proposal for Scope Creep (refactoring a whole file for a 1-line fix) and Speculative Bloat (adding abstractions you didn't ask for).
When: You've finished a task and want to ensure no "noise" leaked into the diff.
Why: This sub-agent has zero tolerance for non-surgical edits. It will flag quote changes, unnecessary classes, and missing verification steps in its own lean context.
When: The model is "looping," getting confused, or producing overly complex code.
Why: Loads the full, detailed standards as an "emergency brake" to return the model to a pragmatic, surgical mindset.
When: Every single turn.
Why: Provides a background constraint, reminding the model to reproduce bugs before fixing them and remove orphans (imports/vars) instantly.
One command. Direct from GitHub.
gemini extensions install https://github.com/sniperwolf/surgical-devgemini extensions link YOUR_PATH_TO/surgical-devLicense MIT © 2026 Fabrizio Fallico ([email protected])