🎯 Fundamentos

Qué es
“Organizar mi trabajo” describe una intención, pero no dice qué archivo debe existir al terminar.

Por qué aprender
Una salida concreta permite comparar la solicitud con el resultado. Sin esa comparación, una respuesta bien escrita puede parecer concluida incluso cuando faltan datos importantes.

Conceptos clave
Entrada · Salida · Unidad · Alcance

Qué es
Una ficha breve funciona como un acuerdo de trabajo.

Por qué aprender
La ficha reduce ida y vuelta y ayuda a identificar cambios de alcance. Una nueva función entra en una lista futura en lugar de alterar silenciosamente el trabajo en curso.

Conceptos clave
Objetivo · Exclusión · Aceptación · Pendiente

Qué es
Una buena solicitud informa qué campos deben preservarse, qué formato debe usarse y cómo tratar la información ausente.

Por qué aprender
La calidad de la salida depende de la claridad de la transformación. Especificar el tratamiento de los vacíos suele ser más útil que añadir adjetivos como perfecto, completo o profesional.

Conceptos clave
Formato · Fidelidad · Vacío · Separación

Qué es
Haz una comparación línea por línea.

Por qué aprender
La comprobación convierte una impresión en evidencia. También muestra dónde corregir: en la extracción, en el formato o en la regla de negocio, sin reconstruir todo el proceso.

Conceptos clave
Conteo · Correspondencia · Regresión · Evidencia

Qué es
Una etapa termina cuando entrega lo acordado y pasa las verificaciones.

Por qué aprender
Limitar el trabajo en curso reduce la sensación de tener muchos proyectos casi listos. Empiezas a acumular entregas pequeñas que funcionan y que se pueden combinar.

Conceptos clave
Etapa · Límite · Bloqueo · Mejora

¿Qué es
Crea una carpeta para el ejercicio y guarda el texto de entrada antes de usar el asistente.

Por qué aprender
La práctica enseña a cerrar una tarea pequeña e introduce una idea central del curso: variar la entrada para descubrir si la solución entendió la regla o solo imitó el ejemplo.

Conceptos clave
Caso común · Caso incompleto · Variación · Conclusión

¿Qué es
Una skill reúne instrucciones y, a veces, scripts y archivos auxiliares para orientar una tarea.

Por qué aprender
Reconocer las piezas te permite estimar el esfuerzo y saber dónde ocurre una falla. Evitas buscar un comando que nunca se instaló o atribuir a una skill una capacidad que depende de otro servicio.

Conceptos clave
Skill · CLI · MCP · Dependencia

¿Qué es
Empieza por la descripción, por los archivos de instrucción y por el instalador.

Por qué aprender
Una inspección pequeña y rastreable es más útil que una aprobación genérica. Vincula la decisión a una revisión concreta y te permite reevaluar solo lo que cambió.

Conceptos clave
Revisión · Instalador · Destino · Registro

¿Qué es
Un hallazgo útil contiene ubicación, evidencia, impacto y contexto.

Por qué aprender
Los informes sin contexto generan muchas alertas y poca orientación. El filtro ayuda a distinguir un comportamiento necesario de un permiso excesivo o de una operación que requiere cuidado adicional.

Conceptos clave
Evidencia · Impacto · Contexto · Filtro

¿Qué es
Las herramientas automáticas identifican patrones; necesitas interpretar el resultado.

Por qué aprender
La calidad de la inspección no se mide por la cantidad de alertas eliminadas. Depende de decisiones reproducibles y de limitaciones visibles, incluso cuando no es posible concluir.

Conceptos clave
Confirmado · Falso positivo · Inconcluso · Prueba enfocada

¿Qué es
Instala solo después de entender qué se va a modificar.

Por qué aprender
La prueba reduce el costo de descubrir incompatibilidades. Aprendes el comportamiento del conjunto antes de permitir que participe en tareas más grandes o use documentos importantes.

Conceptos clave
Aislamiento · Fixture · Reversión · Promoción

¿Qué es
Usa el ejemplo ficticio de abajo como si fuera parte de una skill.

Por qué aprender
Una decisión bien escrita puede ser revisada por otra persona. También muestra que la inspección no es un sello definitivo: los comportamientos nuevos exigen un análisis nuevo.

Conceptos clave
Declaración · Observación · Condición · Decisión

¿Qué es
Una revisión empieza con el cambio que quieres evaluar y con el comportamiento esperado.

Por qué aprender
El contexto reduce los comentarios genéricos y evita que el revisor proponga cambios que contradigan el objetivo. También limita el costo y el alcance de la revisión.

Conceptos clave
Contrato · Diff · Hipótesis · Reproducción

¿Qué es
En un proyecto Git, el diff muestra lo que cambió.

Por qué aprender
Una base clara evita que el revisor compare archivos incorrectos o trate código antiguo como parte del cambio actual. La inspección del estado también evita publicar datos de preparación por error.

Conceptos clave
Base · Estado · Alcance · Ayuda local

¿Qué es
Pide que cada hallazgo describa gatillo, efecto, ubicación y forma de reproducirlo.

Por qué aprender
Los hallazgos accionables convierten la revisión en una herramienta de decisión. Puedes priorizar por impacto y verificar si el cambio más pequeño realmente resolvió el caso.

Conceptos clave
Gatillo · Efecto · Prioridad · Corrección mínima

¿Qué es
Muchos errores aparecen en la segunda ejecución.

Por qué aprender
Estos escenarios son fáciles de olvidar en las demostraciones. Probar repetición e interrupción revela problemas que una lectura superficial o una sola ejecución no muestran.

Conceptos clave
Retry · Idempotencia · Atomicidad · Interrupción

¿Qué es
Cuando una corrección falle repetidamente, registra lo que ya se intentó y el resultado de cada intento.

Por qué aprender
Un caso mínimo reduce la cantidad de explicaciones posibles. Te permite distinguir un problema de lógica, una configuración incompatible y una dependencia no disponible.

Conceptos clave
Caso mínimo · Historial · Única hipótesis · Parada

¿Qué es
Imagina un formulario ficticio que agrega pedidos a una lista.

Por qué aprender
La práctica conecta revisión, prueba y comportamiento del negocio. Aprendes a verificar el efecto real de la corrección y a reconocer cuándo dos entradas aparentemente iguales representan situaciones diferentes.

Conceptos clave
Identificador · Duplicación · Conflicto · Prueba de retorno