Course Plan — Dominio de la Terminal de Comandos
Estado: Plan de producción aprobado
Fecha: 2026-06-01
Basado en:
course.brief.md,course.intent.md,.courseconductor/profile.mdVersión: 1.0
1. Estructura Definitiva de 8 Unidades con Justificación de Secuencia
| # | Unidad | Justificación de secuencia |
|---|---|---|
| 1 | Introducción y motivación profesional | Punto de partida obligatorio. Construye el por qué antes del cómo. Sin esta unidad, el estudiante no tiene contexto ni motivación para invertir tiempo en la terminal. La instalación de WSL es el primer paso técnico real. |
| 2 | Comandos básicos y navegación | Primera habilidad motora: moverse y manipular el sistema de archivos. Es la base de todas las unidades siguientes. Sin cd, ls, cp, mv, no se puede hacer nada más. |
| 3 | Manipulación de archivos de texto | Inmediatamente después de navegar, el estudiante necesita leer y modificar el contenido de los archivos. Texto plano es el formato universal en Unix. |
| 4 | Búsqueda en la terminal | Una vez que se tienen archivos y se sabe navegarlos, surge la necesidad de encontrar información. Wildcards, grep y find son la respuesta. |
| 5 | Funcionamiento interno de la shell | Hito conceptual. Después de 4 unidades de uso práctico, el estudiante tiene suficiente experiencia para comprender cómo funciona la shell: tipos de comandos, redirecciones, pipes. Esto evita que sea abstracto. |
| 6 | Interacción con el sistema operativo | Permisos, variables de entorno, procesos. Requiere entender la shell (unidad 5) para comprender cómo el usuario se relaciona con el SO. Es la unidad más densa. |
| 7 | Utilidades profesionales | Herramientas que extienden y refinan el uso diario: compresión, multiplexor, red, personalización. Asume fluidez en unidades 2-6. Es una "caja de herramientas" profesional. |
| 8 | Cierre y proyección | Síntesis, buenas prácticas, errores comunes, rutas futuras. Depende de todas las unidades anteriores. No introduce comandos nuevos. |
Principio de secuencia
La progresión sigue tres fases:
| Fase | Unidades | Característica |
|---|---|---|
| Fase 1 — Fundación | 1, 2, 3, 4 | El estudiante hace cosas en la terminal sin necesitar entender el funcionamiento interno. |
| Fase 2 — Comprensión | 5, 6 | El estudiante entiende cómo funciona lo que ya sabe hacer. |
| Fase 3 — Proyección | 7, 8 | El estudiante extiende y consolida su dominio hacia herramientas profesionales y aprendizaje futuro. |
2. Formato por Unidad con Razón Pedagógica
| Unidad | Formato | Razón pedagógica |
|---|---|---|
| 1 | .md | Contenido conceptual e instalación. El estudiante necesita leer explicaciones detalladas, ver diagramas textuales y seguir pasos de instalación. Un notebook añadiría fricción innecesaria. |
| 2 | .md | Comandos de navegación y archivos. El estudiante debe escribir los comandos en su propia terminal, no en un notebook. La práctica auténtica ocurre en la terminal real. El .md sirve como guía de referencia. |
| 3 | .ipynb | Comandos de texto con salidas largas (cat, less, head, tail, wc, sort, uniq, diff). El notebook permite mostrar salidas y que el estudiante las compare visualmente. Además, la edición con Nano/Vim se explica por separado. |
| 4 | .ipynb | Búsquedas con grep y find. Los patrones de búsqueda y sus resultados se benefician de celdas ejecutables con salidas visibles. El estudiante puede modificar patrones y ver resultados inmediatos. |
| 5 | .md | Contenido conceptual (tipos de comandos, redirecciones, pipes, alias). La comprensión teórica es tan importante como la práctica. El .md permite explicaciones detalladas con ejemplos que el estudiante copia a su terminal. |
| 6 | .ipynb | Permisos, variables de entorno, procesos, apt, ps, top, kill. Hay múltiples comandos con salidas cambiantes. El notebook captura salidas de referencia y permite ejecutar verificaciones. |
| 7 | .md | tar, gzip, tmux, red, personalización ZSH, Warp. Contenido mixto: instalación/configuración (mejor en .md) y comandos. La personalización requiere editar archivos de configuración, no celdas de notebook. |
| 8 | .md | Cierre y proyección. Sin comandos nuevos. Listas, tablas, referencias. El .md es el formato natural para contenido de síntesis y enlaces. |
Criterio general de asignación
.mdcuando el valor principal está en la explicación, la referencia o la configuración..ipynbcuando el valor principal está en la ejecución interactiva, la visualización de salidas o la validación automatizada.
3. Dependencias y Progresión entre Unidades
Grafo de dependencias
Unit 1 ──► Unit 2 ──► Unit 3 ──► Unit 4 ──► Unit 5 ──► Unit 6 ──► Unit 7 ──► Unit 8
│
└── Unit 8No hay dependencias saltadas ni laterales. Cada unidad presupone fluidez en todas las anteriores.
Mapa de conceptos que cada unidad recibe y entrega
| Unidad | Recibe de anterior(es) | Entrega a siguiente |
|---|---|---|
| 1 | — | Concepto de terminal, shell funcional (WSL), espacio de trabajo ~/terminal-course/ |
| 2 | Unidad 1: terminal lista, motivación | Navegación fluida, manipulación de archivos, estructura de proyecto |
| 3 | Unidad 2: saber navegar y manipular archivos | Lectura/exploración de texto, edición básica, combinación de contenido |
| 4 | Unidad 2+3: archivos con contenido, saber navegar | Búsqueda por patrón, búsqueda por criterios de archivo, wildcards |
| 5 | Unidad 2-4: experiencia práctica con comandos | Comprensión de tipos de comando, redirecciones, pipes, alias |
| 6 | Unidad 5: entender pipes, redirecciones, comandos | Gestión de permisos, variables de entorno, instalación, procesos |
| 7 | Unidad 2-6: base sólida | Compresión, multiplexor, verificación de red, personalización |
| 8 | Todas | Síntesis, buenas prácticas, autonomía para aprendizaje futuro |
Progresión de dificultad
Unidad 1: ●○○○○○○○ (muy fácil, conceptual)
Unidad 2: ●●○○○○○○ (fácil, mucha práctica)
Unidad 3: ●●●○○○○○ (fácil-media, comandos nuevos)
Unidad 4: ●●●●○○○○ (media, patrones de búsqueda)
Unidad 5: ●●●●●○○○ (media, conceptos abstractos)
Unidad 6: ●●●●●●○○ (media-alta, conceptos + comandos)
Unidad 7: ●●●●●○○○ (media, herramientas variadas)
Unidad 8: ●●○○○○○○ (fácil, síntesis)4. Prácticas Acumulativas como Hilo Conductor
Narrativa del curso: "Construye y gestiona tu proyecto desde la terminal"
Cada unidad cierra con una práctica que contribuye a un mismo escenario: un profesional técnico que organiza, documenta, busca, procesa, asegura, comprime y entrega un proyecto de trabajo.
| Unidad | Práctica final | Conecta con unidades anteriores |
|---|---|---|
| 1 | "Prepara tu estación de trabajo" — Instalar WSL/macOS/Linux, abrir terminal, crear directorio ~/terminal-course/, verificar funcionamiento con echo "hola terminal". | — (primera práctica) |
| 2 | "Organiza tu proyecto" — Dentro de ~/terminal-course/, crear estructura: datos/, scripts/, docs/, backups/, logs/. Copiar archivos de ejemplo. Mover y renombrar. | Retoma el directorio creado en unidad 1. |
| 3 | "Documenta y analiza" — Crear archivos README.md, notas.txt, datos.csv con Nano. Usar cat, head, tail, wc, sort para explorarlos. | Trabaja sobre los archivos en la estructura de unidad 2. |
| 4 | "Encuentra lo que necesitas" — Buscar patrones en datos.csv y notas.txt con grep. Encontrar archivos específicos con find. Combinar búsquedas con pipes. | Opera sobre los archivos creados en unidad 3 dentro de la estructura de unidad 2. |
| 5 | "Automatiza tu flujo" — Crear alias temporales y permanentes. Usar pipes y redirecciones para procesar datos: filtrado → ordenamiento → guardado. Redirigir errores a logs/. | Procesa los datos de unidades 3-4 usando pipes. |
| 6 | "Asegura y gestiona" — Ajustar permisos de scripts. Crear variable PROYECTO con ruta. Instalar tree o htop con apt. Lanzar proceso en background, verificar con ps, terminarlo con kill. | Opera sobre la estructura completa de unidades 2-5. |
| 7 | "Empaqueta y personaliza" — Comprimir ~/terminal-course/ con tar + gzip. Verificar conectividad con ping. Personalizar prompt con variable PS1. Explorar tmux (abrir sesión, dividir panel). | Empaqueta todo el proyecto construido en unidades 1-6. |
| 8 | "Presenta tu trabajo" — Limpiar archivos temporales, documentar los alias usados, generar un resumen de lo aprendido, listar comandos nuevos descubiertos. Identificar 3 áreas para seguir aprendiendo. | Integra y reflexiona sobre todo el curso. |
Principio de diseño
Cada práctica es autónoma (se puede hacer sin depender del resultado exacto de la práctica anterior), pero significativamente más fácil si se tienen los archivos y la estructura de las prácticas anteriores. Esto permite:
- Estudiantes que se saltan una unidad pueden recuperarse rápidamente.
- La sensación de "crear algo propio" aumenta la motivación.
- El producto final (
~/terminal-course/) es un portafolio tangible del progreso.
5. Hitos de Producción
| Hito | Artefactos | Criterio de aceptación | Dependencias |
|---|---|---|---|
| H-0 | course.intent.md, .courseconductor/profile.md | Aprobado por ConductorBrain | — |
| H-1 | course.brief.md, course.plan.md, decisions.md, worklog.md | Brief con 8 secciones completas, plan con 7 secciones | H-0 |
| H-2 | syllabus.md, README.md | Syllabus con temario, objetivos, cronograma; README con presentación del curso | H-1 |
| H-3 | source/units/unit-1.md, source/units/unit-2.md | Redactadas, revisadas (quality/reviews/unit-1.md, unit-2.md), corregidas | H-2 |
| H-4 | source/units/unit-3.ipynb, source/units/unit-4.ipynb | Redactadas, validadas (notebook_validate), ejecutadas (artifacts/notebooks/unit-3.executed.ipynb), revisadas | H-3 |
| H-5 | source/units/unit-5.md, source/units/unit-6.ipynb | Redactadas, revisadas, unidad 6 ejecutada y validada | H-4 |
| H-6 | source/units/unit-7.md, source/units/unit-8.md | Redactadas, revisadas | H-5 |
| H-7 | quality/reviews/*.md (todas las unidades), quality/final-review.md | Todas las revisiones completadas, revisión final aprobada | H-3 a H-6 |
| H-8 | artifacts/notebooks/*.executed.ipynb, artifacts/syllabus.pdf (opcional) | Notebooks ejecutados limpios, PDF generado si aplica | H-4, H-5 |
| H-9 | research/*.md (notas de investigación) | Investigaciones registradas para unidades que lo requieren | H-3 a H-7 |
Secuencia recomendada de ejecución
H-1 (brief + plan) → H-2 (syllabus + README) → H-3 (units 1-2) → H-4 (units 3-4)
→ H-5 (units 5-6) → H-6 (units 7-8) → H-7 (revisiones) → H-8 (artefactos) → H-9 (investigación)Nota: La investigación (H-9) puede ocurrir antes o durante la redacción de cada unidad. Se recomienda hacerla por unidad justo antes de redactar.
6. Riesgos Específicos por Unidad
Cada riesgo se mapea a los riesgos del perfil (.courseconductor/profile.md):
| ID | Riesgo | Unidades afectadas | Mitigación |
|---|---|---|---|
| R-TA | technical_accuracy: Comandos, flags o rutas incorrectas. | 1–7 | Verificar cada comando contra man o --help en el runtime ALI antes de publicar. Especial atención en flags de grep (GNU vs BSD en macOS). |
| R-EC | executable_code: Código en notebooks no ejecutable o con errores. | 3, 4, 6 | Ejecutar notebooks completos (no celdas sueltas) antes de la revisión. Usar notebook_execute con timeout suficiente. |
| R-TV | technical_versioning: Versiones de herramientas (WSL, apt, tmux, ZSH) cambian. | 1, 6, 7 | Indicar versiones mínimas (ej. WSL2, Ubuntu 22.04+, tmux 3.x). Usar comandos estables. Marcar secciones cuyo versionado puede cambiar (Warp, Oh My ZSH). |
| R-CD | conceptual_depth: Unidad se convierte en lista de comandos sin contexto. | 2, 3, 4, 6 | Cada sección de comando comienza con un caso de uso profesional ("Esto te sirve cuando…"). Las prácticas finales son situadas. |
| R-LT | learner_transfer: El estudiante no puede aplicar lo aprendido en su contexto real. | 2–8 | Las prácticas finales modelan situaciones reales (organizar proyecto, buscar logs, instalar herramientas, empaquetar entregables). Incluir "misiones rápidas" adicionales. |
Matriz de riesgos por unidad
| Unidad | R-TA | R-EC | R-TV | R-CD | R-LT | Comentario |
|---|---|---|---|---|---|---|
| 1 | Bajo | — | Medio (WSL) | Bajo | Bajo | Solo instalación. Riesgo TV si cambia WSL. |
| 2 | Medio | — | Bajo | Alto | Alto | Riesgo CD alto: fácil caer en lista de comandos. Practicar cada comando inmediatamente. |
| 3 | Medio | Alto | Bajo | Medio | Medio | R-EC crítico: notebook con comandos de texto debe ejecutarse sin errores. |
| 4 | Alto (grep flags) | Alto | Bajo | Medio | Alto | R-TA alto: grep tiene diferencias GNU/BSD. R-EC alto: patrones deben funcionar. |
| 5 | Medio | — | Bajo | Alto | Medio | R-CD alto: redirecciones y pipes son conceptualmente desafiantes. Usar diagramas textuales. |
| 6 | Alto (chmod, apt) | Alto | Medio (apt, Homebrew) | Alto | Alto | Unidad más densa. R-TA alto en permisos (octal vs simbólico). R-EC alto por procesos. |
| 7 | Medio | — | Medio (tmux, ZSH, Warp) | Medio | Medio | R-TV medio: temas ZSH y Warp pueden cambiar. |
| 8 | Bajo | — | Bajo | Bajo | Medio | Riesgo principal: que sea solo una lista de enlaces. Asegurar que invite a la acción. |
7. Investigación Necesaria Previa por Unidad
Nivel de investigación:
- light — Verificación rápida de comandos, flags o sintaxis. 5-10 minutos.
- targeted — Investigación específica sobre comportamiento en distintas plataformas (Linux vs macOS), versiones o herramientas. 15-30 minutos.
- deep — Investigación más amplia sobre conceptos, mejores prácticas o herramientas modernas. 30-60 minutos.
| Unidad | Nivel | Temas a investigar | Fuentes sugeridas |
|---|---|---|---|
| 1 | light | Estado actual de WSL2 (guía de instalación 2025-2026), requisitos de Windows, alternativas si WSL no está disponible. | Microsoft Learn (WSL docs), foros de Ubuntu. |
| 2 | light | Verificar flags comunes de ls (-la, -lh, -lt), comportamiento de rm -i vs rm -rf. | man pages, GNU coreutils docs. |
| 3 | targeted | Diferencias de cat, head, tail entre GNU y BSD (macOS). Flags de sort (numérico, humano). Comandos básicos de Nano y Vim (modos, guardar, salir). | GNU coreutils, Nano manual, vimtutor reference. |
| 4 | targeted | grep GNU vs BSD (flag -E, -P, -o). find con -exec y -delete. Wildcards y globbing en Bash. Patrones comunes de búsqueda. | GNU grep docs, GNU findutils, Bash reference manual (glob). |
| 5 | targeted | Comportamiento de redirecciones (>, >>, 2>, &>), pipes y subshells. Tipos de comandos (type, which, command). Alias en .bashrc vs .bash_aliases. | Bash manual (redirections, shell builtins). |
| 6 | targeted | chmod octal vs simbólico. Variables de entorno (PATH, HOME, USER). apt básico (update, upgrade, install, search). Homebrew instalación básica. ps vs top vs htop. Señales de kill (SIGTERM, SIGKILL). | chmod man page, apt docs, Homebrew docs, ps/top man pages. |
| 7 | deep | tar con compresión (-czf, -xzf), gzip/gunzip. tmux comandos básicos (sesiones, ventanas, paneles). ping, curl básico. Instalación y configuración de Oh My ZSH y powerlevel10k. Warp características actuales (2026). | tar manual, tmux cheat sheet, Oh My ZSH docs, Warp docs. |
| 8 | light | Recursos actualizados para aprendizaje continuo (libros, cursos, laboratorios). Comunidades (r/commandline, r/bash, r/linux4noobs). | Google, Reddit, Linux Journey, BashGuide. |
Investigación prioritaria (recomendada antes de redactar)
| Prioridad | Unidad | Razón |
|---|---|---|
| 🔴 Alta | 4 | Diferencias grep GNU/BSD pueden causar errores en macOS. Validar flags en el runtime. |
| 🔴 Alta | 6 | Permisos y chmod tienen alta probabilidad de error si no se verifican octales exactos. |
| 🟡 Media | 3 | Verificar que sort, uniq, diff funcionan igual en GNU y BSD. |
| 🟡 Media | 7 | tmux y Oh My ZSH pueden tener cambios recientes. Verificar comandos exactos. |
| 🟢 Baja | 1, 2, 5, 8 | Contenido estable. Investigación principalmente para confirmar y enriquecer. |
Apéndice: Resumen de Artefactos Esperados
| Ruta | Formato | Hito |
|---|---|---|
README.md | .md | H-2 |
syllabus.md | .md | H-2 |
source/units/unit-1.md | .md | H-3 |
source/units/unit-2.md | .md | H-3 |
source/units/unit-3.ipynb | .ipynb (sin outputs) | H-4 |
source/units/unit-4.ipynb | .ipynb (sin outputs) | H-4 |
source/units/unit-5.md | .md | H-5 |
source/units/unit-6.ipynb | .ipynb (sin outputs) | H-5 |
source/units/unit-7.md | .md | H-6 |
source/units/unit-8.md | .md | H-6 |
quality/reviews/unit-1.md a unit-8.md | .md | H-7 |
quality/final-review.md | .md | H-7 |
artifacts/notebooks/unit-3.executed.ipynb | .ipynb (con outputs) | H-8 |
artifacts/notebooks/unit-4.executed.ipynb | .ipynb (con outputs) | H-8 |
artifacts/notebooks/unit-6.executed.ipynb | .ipynb (con outputs) | H-8 |
research/*.md (según investigación realizada) | .md | H-9 |
Recomendación de Continuación
Siguiente paso recomendado: Crear syllabus.md (H-2).
Fundamento:
- El syllabus es la traducción del plan a contenido visible para el estudiante.
- Define objetivos específicos por unidad, evaluación formativa y carga horaria estimada.
- Con brief y plan ya aprobados, el syllabus cierra la fase de diseño antes de empezar a redactar unidades.
- El
README.mdpuede crearse junto al syllabus o inmediatamente después.
No recomiendo comenzar la investigación (H-9) antes del syllabus, porque el syllabus define el alcance preciso de cada unidad y eso evita investigar temas que luego no se usan.