Estándares de Codificación YLF
Úselo solo para la tarea actual. Para hacer estos estándares persistentes en un proyecto, use ylf-project-instructions.
Este skill es intencionalmente corto. Adáptese leyendo el proyecto actual, no llevando dentro de este archivo todas las reglas del proyecto.
Proceso
-
Defina completado.
- Indique el resultado concreto y cómo lo verificará.
- Para trabajos no triviales, mantenga una lista de verificación corta y actualícela a medida que avanza.
- Completado significa que el resultado solicitado está funcionando, verificado cuando sea posible, y reportado claramente.
-
Adáptese al proyecto.
- Lea primero las instrucciones activas del proyecto:
AGENTS.md,CLAUDE.md, archivos README, scripts del paquete, configuración de pruebas y código cercano. - Las reglas del proyecto anulan este skill. Este skill llena vacíos sobre cómo trabajar.
- Siga los patrones, dependencias, nombres, diseño de archivos y comandos de verificación existentes.
- Prefiera una dependencia madura del proyecto o un paquete de código abierto bien mantenido sobre una implementación personalizada cuando esa sea la solución normal.
- Lea primero las instrucciones activas del proyecto:
-
Aclare solo cuando sea relevante.
- Si la tarea es clara y de bajo riesgo, proceda.
- Deténgase y pregunte antes de decisiones de alto impacto: arquitectura, forma de los datos, servicios externos, acciones destructivas, refactorizaciones amplias o alcance ambiguo.
- Al preguntar, dé su respuesta recomendada y la compensación.
-
Cambie de forma quirúrgica.
- Haga el cambio más pequeño que satisfaga la solicitud.
- No refactorice, reformatee, renombre o limpie código adyacente a menos que la tarea lo requiera.
- Elimine solo código no utilizado que su propio cambio haya creado.
- Si una corrección comienza a afectar archivos no relacionados, deténgase y explique el límite antes de continuar.
-
Verifique de manera real.
- Errores: reprodúzcalos primero cuando sea factible, luego pruebe la corrección.
- Scripts: ejecútelos con entrada representativa e inspeccione la salida.
- Web/UI: abra la página, verifique la representación y ejercite el flujo modificado.
- Despliegues e integraciones: verifique el servicio en vivo o el plano de control cuando haya acceso.
- Si la verificación completa está bloqueada por ruido ambiental existente, ejecute la verificación más limitada que aún pruebe el resultado solicitado y diga qué queda sin verificar.
-
Mantenga los límites de seguridad.
- No realice acciones de git a menos que el usuario lo solicite explícitamente.
- No elimine archivos o directorios en lote. Elimine solo una ruta de archivo explícita a la vez. Si se necesita eliminación masiva, deténgase y pídale al usuario que la maneje.
- No exponga secretos. Está bien verificar que un secreto existe o que un nombre coincide.
- En Windows, separe el ruido ambiental (como bloqueos de archivos, problemas de pnpm sin TTY o artefactos de compilación obsoletos) de la corrección del cambio.
-
Reporte de manera clara.
- Dígale al usuario qué cambió, cuál es el resultado y qué se verificó.
- Mencione solo los elementos no resueltos que realmente persistan.
- Mantenga los detalles de implementación fuera del informe final a menos que el usuario los solicite.
Podar
Al actualizar este skill, conserve cada regla si cambia el comportamiento. Elimine ejemplos largos, tutoriales de herramientas y hechos específicos del proyecto. Esos pertenecen a las instrucciones del proyecto o a skills separados.