{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/logo.png\" width=\"337\" alt=\"surgical-dev logo\"/>\n</p>\n\n<h1 align=\"center\">surgical-dev</h1>\n\n<p align=\"center\">\n  <strong>surgical-level precision. surgical-level pragmatism. Zero-bloat engineering.</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/sniperwolf/surgical-dev/stargazers\"><img src=\"https://img.shields.io/github/stars/sniperwolf/surgical-dev?style=flat&color=yellow\" alt=\"Stars\"></a>\n  <a href=\"https://github.com/sniperwolf/surgical-dev/commits/main\"><img src=\"https://img.shields.io/github/last-commit/sniperwolf/surgical-dev?style=flat\" alt=\"Last Commit\"></a>\n  <a href=\"https://github.com/sniperwolf/surgical-dev/issues\"><img src=\"https://img.shields.io/github/issues/sniperwolf/surgical-dev?style=flat&color=brightgreen\" alt=\"Issues\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/github/license/sniperwolf/surgical-dev?style=flat&color=blue\" alt=\"License\"></a>\n  <a href=\"https://geminicli.com\"><img src=\"https://img.shields.io/badge/Gemini%20CLI-Extension-orange?style=flat\" alt=\"Gemini CLI\"></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"#the-problem\">The Problem</a> •\n  <a href=\"#operational-features\">Features</a> •\n  <a href=\"#how-to-use\">Workflow</a> •\n  <a href=\"#installation\">Install</a>\n</p>\n\n---\n\nA Gemini CLI extension that transforms the model into a **disciplined, surgical engineer.** \n\nInspired by *[Andrej Karpathy's observations](https://x.com/karpathy/status/2015883857489522876)* on LLM coding pitfalls, **surgical-dev** enforces a strict behavioral layer that prioritizes minimal diffs, existing style preservation, and goal-driven verification.\n\nAI coding agents are sometime **\"too helpful\"**: they refactor unrelated code, add speculative abstractions, and fix bugs without reproduction.\n\n## The Problem\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🗣️ \"Too Helpful\" AI\n\n> \"I've fixed the bug in `auth.ts`. I also took the liberty of updating the deprecated API calls in three adjacent functions, reformatted the whole file from single to double quotes for consistency, and added a new `ConfigManager` class in case you want to add more providers later.\"\n\n</td>\n<td width=\"50%\">\n\n### 🔪 surgical-dev (Disciplined)\n\n> \"Fixed the bug in `auth.ts`. Changed 2 lines only. Verified with new test case.\"\n\n</td>\n</tr>\n</table>\n\n**Minimal diffs. Zero noise. Maximum impact.**\n\n## Operational Features\n\n| Feature            | What it do                                                       | Trigger                             |\n|--------------------|------------------------------------------------------------------|-------------------------------------|\n| **Dense Context**  | High-density rules in `GEMINI.md` for minimal token overhead.    | Automatic                           |\n| **Audit Command**  | Reviews your plan/diff for over-engineering or scope creep.      | `/surgical:audit`                   |\n| **Reviewer Agent** | Delegate strict code reviews to a surgical specialist sub-agent. | `gemini delegate surgical-reviewer` |\n| **Surgical Skill** | Deep \"behavioral reset\" for complex tasks. (≈500 tokens)         | `Activate surgical-standards`       |\n\n## How to Use\n\nFollow this workflow to maintain surgical-level discipline in every session.\n\n### 1. Strategy Audit (`/surgical:audit`)\n**When:** After the model proposes a plan, but before you say \"Go.\"  \n**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).\n\n### 2. Surgical Reviewer (`gemini delegate surgical-reviewer`)\n**When:** You've finished a task and want to ensure no \"noise\" leaked into the diff.  \n**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.\n\n### 3. Behavioral Reset (`Activate surgical-standards`)\n**When:** The model is \"looping,\" getting confused, or producing overly complex code.  \n**Why:** Loads the full, detailed standards as an \"emergency brake\" to return the model to a pragmatic, surgical mindset.\n\n### 4. Continuous Enforcement (`GEMINI.md`)\n**When:** Every single turn.  \n**Why:** Provides a background constraint, reminding the model to reproduce bugs before fixing them and remove orphans (imports/vars) instantly.\n\n## Installation\n\nOne command. Direct from GitHub.\n\n```bash\ngemini extensions install https://github.com/sniperwolf/surgical-dev\n```\n\n### Local Development (Optional)\n```bash\ngemini extensions link YOUR_PATH_TO/surgical-dev\n```\n\n---\n\n**License**\nMIT © 2026 Fabrizio Fallico ([me@fabriziofallico.com](mailto:me@fabriziofallico.com))\n",
  "bytes": 4687,
  "sha": "53d367d4794151be60aa48b68991dae8282b4bae8df60bac88a9732f5f09a3b7",
  "repo_slug": "sniperwolf/surgical-dev",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_sniperwolf_surgical_dev_e01cef0c/readme"
}