Comment Intent Assistant

Resalta comentarios genéricos y promueve documentación basada en intención real.

Comment Intent Assistant analiza comentarios en código en tiempo real y ayuda a los desarrolladores a escribir documentación significativa, enfocada en el por qué, no solo en el qué.

Demo

¿Por qué existe esta extensión?

Muchos comentarios describen lo que hace el código, pero no explican por qué existe. Esta extensión detecta comentarios de bajo valor e incentiva documentar:

• Intención
• Decisiones técnicas
• Restricciones
• Contexto real
• Trade-offs
• Motivo del diseño

El objetivo es mejor mantenibilidad y documentación humana real.

Funcionalidades

• Detecta comentarios vagos o genéricos
• Resalta comentarios con bajo valor informativo
• Promueve documentación basada en intención
• Análisis en tiempo real (sin servicios externos)
• Ligera y rápida
• Funciona completamente offline
• Permite ignorar comentarios específicos
• Guía para reescribir comentarios con intención

Qué detecta

El analizador identifica patrones como:

Comentarios genéricos "Básicamente este módulo procesa la información..."

Estilo tutorial / IA "Puedes modificar este valor..."

Comentarios que solo repiten el código "Retorna el valor si es válido"

Baja densidad semántica

Verbos vagos sin contexto "Maneja / Procesa / Gestiona"

Qué NO marca

La extensión reconoce señales reales de ingeniería y evita falsos positivos cuando el comentario incluye:

• Decisión técnica real
• Trade-offs
• Restricciones
• Bugs o incidentes
• Decisiones de performance
• Notas de legacy
• Casos límite
• Contexto humano real

Ejemplo de buen comentario:

Hotfix: evita condición de carrera cuando múltiples escrituras concurrentes modifican el cache.
Se eligió esta solución en lugar de locking por latencia en dispositivos móviles.

Filosofía

Un buen comentario explica:

Por qué existe el código — no qué hace el código.

La documentación basada en intención mejora:

• Mantenibilidad a largo plazo
• Comprensión del equipo
• Velocidad de debugging
• Calidad de code review
• Claridad arquitectónica

Comandos

Rewrite Comment with Intent

Reescribe comentarios genéricos usando una plantilla basada en intención real.

Ignore Comment Intent Warning

Ignora el comentario seleccionado para que no vuelva a analizarse.

Rendimiento

• Análisis incremental
• Debounce inteligente
• Cache por documento
• Diseñado para proyectos grandes

Roadmap

• Reducción avanzada de falsos positivos
• Mejora del scoring semántico
• Ajuste fino de heurísticas
• Sugerencias inteligentes de intención
• Métricas de calidad de comentarios (futuro)

Autor

Exist Code

Herramientas de desarrollo centradas en ingeniería real.

Licencia

MIT