Improve Loop
freyesperales/improve-loop
Loop iterativo de auditoria adversarial que melhora apps continuamente
Ver no GitHubSkill de melhoria contínua para Claude Code que interroga aplicações de forma sistemática e iterativa, analisando UX, código, segurança, performance, escalabilidade e outros aspectos sem perder a essência do produto. Implementa um ciclo que rota entre 9 lentes de análise, acumula descobertas num ledger e aplica melhorias validadas contra a identidade do projeto.
Instalação
npx convez-ai freyesperales/improve-loop1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Auditoria contínua de aplicações em desenvolvimento
- Melhoria iterativa de qualidade, segurança e performance
- Validação de refatorações mantendo a identidade do produto
- Identificação sistemática de gargalos e débitos técnicos
Veredito

Skill robusto e bem-estruturado que automatiza auditorias cíclicas com rigor metodológico. Destaca-se pela abordagem adversarial, proteção da essência do produto e acúmulo de histórico, sendo especialmente valioso para times que buscam melhoria contínua além de code reviews pontuais.
README
A tradução para o português deste README ainda está na fila.
🔁 improve-loop
Un skill de Claude Code que instala un loop de mejora continua sobre tu aplicación: la cuestiona de forma implacable y sistemática —UX, código, seguridad, eficiencia, escalabilidad, bugs, accesibilidad, mantenibilidad y observabilidad— sin perder su esencia.
No es una auditoría de una pasada. Es un ciclo que nunca declara "terminado": cada vuelta elige una lente, interroga el código como un adversario, propone mejoras concretas, las valida contra la identidad del producto, las aplica y las anota en un ledger acumulativo. Vuelta tras vuelta, una app correcta se convierte en una excepcional.
¿Por qué?
La mayoría de los reviews son fotos: un PR, un momento, una lista de issues que se
olvida. Las apps no mejoran por fotos, mejoran por presión constante aplicada
en la dirección correcta. improve-loop convierte esa presión en un proceso:
- Rota lentes para no obsesionarse con una sola dimensión.
- Acumula en
IMPROVE-LOG.mdpara que el progreso sea visible y no se repita. - Protege la esencia: una "mejora" que diluye lo que hace especial al producto no es una mejora — se descarta o se reformula.
Instalación
Clónalo como skill personal de Claude Code:
# macOS / Linux
git clone https://github.com/freyesperales/improve-loop \
~/.claude/skills/improve-loop
# Windows (PowerShell)
git clone https://github.com/freyesperales/improve-loop `
$env:USERPROFILE\.claude\skills\improve-loop
O como skill de proyecto (solo para un repo):
git clone https://github.com/freyesperales/improve-loop \
./.claude/skills/improve-loop
Reinicia Claude Code. El skill se auto-activa cuando pides mejorar/pulir/endurecer una app, o lo invocas explícitamente.
Uso
Basta con pedirlo en lenguaje natural:
mejora esta app de forma continua
qué puedo mejorar de esto, hazlo un monstruo
audita y arregla en bucle, mantén la esencia
harden this and keep iterating
El ciclo (lo que se repite)
1. ELEGIR LENTE → rota o sigue prioridad; nunca dos veces seguidas la misma
2. INTERROGAR → preguntas afiladas de esa lente, buscadas en el código real
3. EVIDENCIAR → cada hallazgo con archivo:línea y por qué importa
4. PRIORIZAR → severidad × esfuerzo; quédate con el top que mueve la aguja
5. GUARDIÁN → ¿preserva la esencia? si no, reformula o descarta
6. APLICAR+VERIFICAR+ANOTAR → cambio, prueba, entrada en el ledger
Las 9 lentes
| Lente | Pregunta central |
|---|---|
| UX & Producto | ¿Dónde duda, retrocede o abandona el usuario? |
| Calidad de código | ¿Se lee como prosa o hay que descifrarlo? |
| Seguridad | ¿Qué línea borraría un atacante para entrar? |
| Eficiencia | ¿Cuál es el hot path y cuánto cuesta de verdad? |
| Escalabilidad | ¿Y a 10×, 100×, 1000× del uso actual? |
| Fiabilidad & Bugs | ¿Qué pasa si falla a la mitad? |
| Accesibilidad | ¿Se puede usar todo sin ratón, con lector de pantalla? |
| Mantenibilidad | ¿Lo entiendes tú mismo en 6 meses? |
| Observabilidad | ¿Puedes diagnosticar un fallo en prod sin reproducirlo? |
El banco completo de preguntas adversariales por lente está en
references/lenses.md.
Consejos y recomendaciones
1. Fija bien la esencia en la Fase 0. Es lo más importante. Si no le dices a Claude qué hace único a tu producto y qué NO puede cambiar, el loop deriva hacia "lo que cualquier app debería ser" y mata lo que lo hace especial. Sé concreto: "respuesta <100 ms", "cero configuración", "funciona offline", "tono irreverente".
2. Define anti-objetivos explícitos. Decir lo que NO quieres es tan valioso como lo que sí. "No convertirse en otra suite empresarial", "no añadir login", "no telemetría". Eso le da al guardián de la esencia algo que defender.
3. Empieza por la lente donde más duele. Si tienes incidentes en prod → Fiabilidad u Observabilidad. Si nadie entiende la app → UX. Si manejas datos de usuarios → Seguridad primero, sin discusión.
4. Confía en el ledger. IMPROVE-LOG.md es la memoria del proceso. Versionalo
en git: el diff del ledger a lo largo del tiempo es la historia de cómo tu app se
volvió robusta. No lo borres.
5. Una lente por vuelta. Profundidad sobre amplitud. Resistir la tentación de "revisar todo de golpe". El valor está en la repetición disciplinada, no en una vuelta heroica que se queda en la superficie.
6. Verifica de verdad antes de cantar victoria. Corre tests, linter, build, o el propio app. Si no hay forma de verificar un cambio, que Claude lo diga explícito en vez de afirmar que funciona.
7. Automatízalo para que corra solo. Combínalo con otros skills:
/loop improve-loop→ una vuelta cada intervalo./schedule→ ejecuciones programadas (ej. cada mañana).- En sesión, pídele "autopiloto": encadena vueltas sin confirmar entre ellas, parando solo en cambios irreversibles.
8. Deja que delegue lo pesado. El improve-loop es el director de orquesta:
para auditorías profundas reutiliza /security-review, /code-review o skills de
CRO. No reimplementa lo que ya existe.
9. Gates en lo irreversible. Borrar datos, push a main, migrar esquema, romper API pública → siempre confirma primero. El resto, déjalo avanzar.
10. Sabe cuándo es madurez, no cansancio. El loop solo "termina" cuando una vuelta completa no produce ningún hallazgo accionable. Si las preguntas que quedan son de bajo valor, llegaste. Si te cansaste de buscar, no.
Estructura
improve-loop/
├── SKILL.md # metodología del loop (lo que Claude lee)
├── references/
│ └── lenses.md # banco de preguntas adversariales (9 lentes)
└── assets/
└── IMPROVE-LOG.template.md # plantilla del ledger acumulativo
Licencia
MIT — ver LICENSE. Úsalo, fórkealo, mejóralo (en bucle 😉).