CommunityRedacción y edicióngithub.com

Quantum Coder (Hábitos de Codificación Cuántica)

Guías para codificar de forma disciplinada y eficiente: pensar antes de codificar, hacer cambios quirúrgicos, depurar sistemáticamente, verificar como un lanzamiento y evitar regresiones.

¿Qué es Quantum Coder (Hábitos de Codificación Cuántica)?

Quantum Coder es una habilidad de agente de IA que impone un conjunto estricto de principios de ingeniería de software. En lugar de una configuración vaga, entrega reglas concretas para pensar en voz alta antes de escribir código, realizar cambios mínimos y precisos, depurar por capas y verificar los resultados como si fueran a producción. La habilidad está diseñada para agentes como Claude Code, Cursor y Codex, y se integra con conectores de GitHub (para leer repositorios, issues y pull requests) y de Netlify (para despliegues y configuración de sitios). Cada principio está formulado para minimizar el trabajo especulativo, reducir la deuda técnica y evitar que los mismos bugs reaparezcan. El agente, al activar esta habilidad, seguirá una metodología que prioriza la claridad, la consistencia y la automatización de la verificación.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ohnobro398-png/quantum-skills/tree/HEAD/quantum-coder

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Quantum Coder

Piensa antes de codificar

  • Expresa las suposiciones en voz alta antes de escribir código. Si la solicitud tiene dos interpretaciones, presenta ambas y pregunta en lugar de elegir silenciosamente.

  • Elige el enfoque más simple que resuelva el problema planteado. Sin funcionalidades especulativas, sin abstracciones para código de un solo uso, sin capacidad de configuración que nadie haya solicitado.

  • Cuestiona cuando exista un camino más simple. Una objeción honesta y breve ahora es mejor que una reescritura larga después.

  • Para compilaciones de varios pasos, escribe un plan breve donde cada paso nombre su propia verificación, luego ejecuta el plan en orden.

Realiza cambios quirúrgicos

  • Toca solo lo que la solicitud necesita. Nunca mejores código, comentarios o formato adyacente mientras arreglas otra cosa.

  • Sigue el estilo existente del archivo, incluso cuando prefieras un estilo diferente. La consistencia dentro de un mismo archivo es más importante que el gusto personal entre archivos.

  • Cada línea modificada debe rastrearse directamente a la solicitud del usuario. Si una línea no puede explicarse por la solicitud, reviértela.

  • Limpia solo el desorden que el propio cambio haya creado, como importaciones o variables que el cambio dejó sin usar.

Depura sistemáticamente

  • Deja de agregar funcionalidades en el momento en que algo se rompe. Primero conserva la salida del error y los pasos para reproducirlo.

  • Reproduce el error de forma confiable antes de arreglarlo. Para herramientas web, reproduce sin interfaz gráfica en Chromium con las entradas exactas que fallaron.

  • Localiza por capas: marcado, script, estilo, red o compilación. Luego reduce al caso de fallo más pequeño hasta que la causa raíz sea obvia.

  • Arregla la causa raíz, no el síntoma. Pregunta por qué ocurre hasta que la respuesta sea la causa real, no solo dónde se manifiesta.

  • Revisa primero references/bug-catalog.md cuando un síntoma parezca conocido. Un error conocido con una solución conocida nunca debería consumir una hora dos veces.

Verifica como un lanzamiento

  • Ejecuta las verificaciones propias del proyecto después de cada cambio: pruebas de humo sin interfaz para herramientas web, comprobaciones de cordura física para juegos y una carga fresca del navegador para páginas.

  • Toma una captura de pantalla del resultado en anchos de escritorio y móvil y mira las imágenes. Una imagen captura lo que las afirmaciones pasan por alto.

  • Para despliegues en Netlify, sigue la lista de verificación estándar: index.html en la raíz del zip, deshabilitar el inicio de sesión único y la insignia mediante la API, curl para HTTP 200 con tipo de contenido HTML y título correcto, luego una verificación con navegador desplazado.

  • Nunca afirmes haber solucionado algo sin ejecutar la verificación. Una prueba no ejecutada es una suposición, no un resultado.

Protégete contra la recurrencia

  • Después de corregir un error, agrega una verificación que falle sin la corrección y pase con ella, para que el mismo error no pueda regresar silenciosamente.

  • Mantén un registro breve de errores por proyecto: síntoma, causa raíz, corrección y fecha. Las depuraciones futuras comienzan leyendo el registro.

  • Elimina la depuración con registros antes de la entrega, y nunca dejes secretos, claves o tokens en el código, comentarios o archivos confirmados.

Conectores disponibles

  • GitHub para lecturas de repositorios, issues y pull requests en el código del usuario.

  • Netlify personalizado para creación de sitios en Netlify, despliegues y las correcciones de configuración de inicio de sesión único y la insignia.

  • Usa muse.connector_search para encontrar otros conectores y muse.skill_search para encontrar habilidades relacionadas.

  • Si nada de esto se ajusta, busca en la web un servidor MCP o API mantenido y configúralo con Conectores personalizados y MCP, o construye un conector personalizado.

Alternativas para mejores resultados

  • Cuando estés atascado más de 30 minutos en un error, reduce aún más la reproducción o pregunta al usuario qué cambió recientemente. Ojos nuevos son mejores que ojos obstinados.

  • Prefiere eliminar código en lugar de agregar código cuando ambas opciones corrijan el error. Menos código significa menos errores futuros.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados