Codificación

¿Qué hace Codificación?

Usa esta habilidad como punto de entrada para el trabajo de software. Mantén este archivo en contexto, luego carga el conjunto de referencias más pequeño y relevante para la tarea.

Enrutamiento

• Para escribir código nuevo o extender comportamiento, lee ./references/implementation.md.
• Para trabajo de refactorización, limpieza, simplificación, extracción, reestructuración o reescritura, lee ./references/refactoring.md.
• Para revisión de código, revisión de PR, crítica de diff o evaluación de riesgos, lee ./references/review.md.
• Para depuración, pruebas fallidas, regresiones, errores en tiempo de ejecución, fallos de CI o corrección de errores, lee ./references/debugging.md.
• Para arquitectura, diseño de API, límites de módulos, dirección de dependencias o discusión solo de diseño, lee ./references/design.md.
• Para reglas compartidas de calidad de código, lee ./references/standards.md siempre que escribas o modifiques código, y según sea necesario durante la revisión/diseño.
• Para estrategia de aserciones (comprobaciones invariantes, decisiones de assert en depuración vs. producción y contratos de fallo rápido), lee ./references/assertions.md al escribir o revisar código que valide suposiciones internas.

Carga solo las referencias necesarias para la solicitud actual del usuario. Si la tarea tiene múltiples fases, carga la siguiente referencia cuando comience esa fase.

Reglas Base

• La corrección, la seguridad y la intención del usuario tienen prioridad sobre las preferencias de estilo.
• El formateador del proyecto, el linter, las pruebas, el sistema de compilación, las convenciones del framework y los patrones locales sistémicos tienen prioridad sobre los estándares predeterminados de esta habilidad.
• Un patrón local es sistémico cuando aparece en múltiples archivos cercanos, está impuesto por herramientas o forma parte de una convención clara de framework/aplicación. No copies código débil y puntual solo porque está adyacente.
• Cuando no exista un patrón de proyecto sistémico, usa ./references/standards.md.
• Preserva el comportamiento público, las API, los contratos de datos, las migraciones y la semántica operativa a menos que el usuario solicite explícitamente cambiarlos.
• Mantén las ediciones limitadas a la tarea. Mejora el código tocado lo suficiente para obtener un resultado coherente, pero no normalices código heredado no relacionado.

Búsqueda de Ejemplos

Usa ejemplos solo cuando una decisión de regla no esté clara.

• ./examples/README.md indexa ejemplos enfocados.
• Abre un archivo de ejemplo coincidente a la vez.