loselen/create-map

¿Qué hace create-map?

Construye el camino más corto de nodos enseñables desde donde está el aprendiz hasta el objetivo.

Basado en: jerarquías de aprendizaje de Gagné (1968), Análisis Cognitivo de Tareas (Clark et al. 2008; Tofel-Grehl & Feldon 2013), secuenciación de tareas completas 4C/ID (van Merriënboer & Kirschner 2018), taxonomía revisada de Bloom (Anderson & Krathwohl 2001), franja exterior de la Teoría de Espacios de Conocimiento, componentes de conocimiento (Koedinger et al. 2012).

Base de datos: ejecuta el script incluido desde la raíz del proyecto del aprendiz (la carpeta donde se inició el chat); guarda los datos en ./.learn/learn.db. ${CLAUDE_SKILL_DIR} es la carpeta de esta habilidad; Claude Code la completa automáticamente, y otros agentes deben usar la ruta de la carpeta que contiene este SKILL.md.

Entradas

• el objetivo confirmado de clarify-me
• el resumen de línea base de check-me (sólido / endeble / aún no / conceptos erróneos)

Procedimiento

1. Raíz. Coloca el objetivo en la parte superior como una tarea completa.

2. Descomponer hacia atrás. Para el objetivo, y luego para cada nuevo nodo, pregúntate: "¿Qué debe ser capaz de hacer el aprendiz para poder realizar esto?" También haz las preguntas expertas que la gente olvida:

   • "¿Qué decisiones, señales y comprobaciones usa un experto aquí?"
   • "¿Qué errores cometen los principiantes comúnmente aquí?"

   Convierte las decisiones ocultas en nodos o mantenlas en el título de un nodo.

3. Deja de descomponer una rama cuando llegue a algo que check-me marcó como sólido. No pongas cosas sólidas en el mapa.

4. Dimensiona cada nodo adecuadamente. Un nodo:

   • tiene una habilidad clara, expresada como "puede [verbo] ..."
   • se puede enseñar en una lección corta (entre 5 y 20 minutos de chat)
   • necesitará como máximo 3 resultados; si requiere más, divídelo; si no se puede comprobar por sí solo, fúndelo

5. Incluye las brechas. Los elementos endebles se convierten en nodos cortos. Los conceptos erróneos reciben su propio nodo o se nombran en el título del nodo que los corrige.

6. Ordena. Ordena para que cada nodo aparezca después de sus prerrequisitos. Coloca los nodos de "por qué funciona" justo antes de los procedimientos que dependen de ellos. Cada pocos nodos, incluye un nodo pequeño de tarea completa que combine los anteriores, para que nunca se convierta en un montón de fragmentos. El nodo final es el objetivo mismo.

7. Mantenlo pequeño: alrededor de 5 a 15 nodos. Si necesitas más, el objetivo está demasiado lejos. Vuelve a clarify-me y redúcelo.

8. Muestra el mapa como un camino numerado corto, luego pregunta: "¿Este camino se ve bien, o hay algo que ya sepas o quieras saltarte?" Ajusta una vez.

9. Guarda después de que el aprendiz esté de acuerdo:

   python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" new-map '{"goal": "<declaración del objetivo>", "baseline": "<resumen de check-me>"}'
   

   Luego agrega todos los nodos en una sola llamada. key es una etiqueta corta que elijas; requires lista las claves de los nodos prerrequisito en esta misma llamada (o los ids de nodos existentes):

   python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" add-nodes '{"map_id": 1, "nodes": [
     {"key": "a", "title": "Puede ...", "requires": []},
     {"key": "b", "title": "Puede ...", "requires": ["a"]}
   ]}'
   

   Cada nodo recibe su fecha de creación automáticamente. Pasa el JSON por stdin con un heredoc si contiene comillas que son difíciles de escapar.

Modificar el mapa después

Si la enseñanza revela un prerrequisito faltante, agrégalo con add-nodes (usa el id del nodo existente en requires donde corresponda) e informa brevemente al aprendiz por qué.

Errores comunes

• Seguir el orden de un libro de texto en lugar de lo que necesita el objetivo.
• Nodos demasiado grandes ("aprender cálculo") o demasiado pequeños (una definición).
• Volver a enseñar lo que el aprendiz ya demostró que es sólido.
• Un mapa enorme que abruma al aprendiz.