← ClaudeAtlas

comment-cleanuplisted

Mecanica de limpieza de comentarios de codigo en archivos .cs -- clasificar cada comentario, aplicar el umbral doble Context Delta/Decision Delta (MEF-ADR-0044), intentar codificar la informacion en el codigo, comprimir los sobrevivientes y releer el archivo. Usar cuando se revise o refactorice un archivo .cs sobre-comentado: narracion que repite el codigo, provenance (`// HU-XX`, citas de issue/PR/HU), citas de ADR sueltas sin restriccion activa, o comentarios que duplican lo que un nombre, un tipo o un test ya dicen.
augusto-romero-arango/eda-evsourcing-azure-harness · ★ 0 · Testing & QA · score 70
Install: claude install-skill augusto-romero-arango/eda-evsourcing-azure-harness
# Limpieza de comentarios de codigo Mecanica operativa de MEF-ADR-0044 (doctrina de comentarios minimos): ese ADR fija **cuando** un comentario merece existir; este Skill fija **como** podar los que no. Lo usa el `reviewer` (fase refactor del pipeline TDD, MEF-ADR-0044 seccion 6) sobre archivos `.cs` que el propio PR del issue ya interviene -- nunca sobre un archivo externo al diff. Tambien se dispara en cualquier sesion interactiva sobre un archivo `.cs` que el usuario senale como sobre-comentado, sin pasar por el pipeline (MEF-ADR-0033). **Este Skill no ensena a escribir comentarios nuevos** -- esa doctrina compacta vive en el body de cada agente escritor (`test-writer`, `implementer`, `smoke-test-writer`). Aqui solo la mecanica de limpieza sobre comentarios ya existentes. **Alcance**: `.cs` (produccion, tests, smoke tests) unicamente -- MEF-ADR-0044 seccion 5 fija que HCL, JSON/YAML de workflows y Markdown/bash del propio plugin quedan fuera de este modo de limpieza (HCL en particular es hogar canonico de documentacion de MEF-ADR-0027/MEF-ADR-0032; no se poda). ## 1. Clasificar cada comentario candidato Antes de tocar nada, recorre el archivo y clasifica cada comentario existente en una de estas categorias. La etiqueta es solo el punto de partida -- el umbral del paso 2 decide, no la categoria por si sola: | Categoria | Descripcion | Suele... | |---|---|---| | Narracion del codigo | Repite en prosa lo que la linea o el bloque siguiente ya dice | podarse | | Rationale