MÓDULO 2.2 / 4 DE 8
Carpetas, Markdown y secretos
Construye la casa digital y separa conocimiento de credenciales.
1Una carpeta representa un contexto
Qué es
El símbolo ~ representa la carpeta personal en Bash. Dentro de ella, proyectos reúne trabajos independientes. Usa nombres claros y evita mezclar documentos de clientes diferentes. La carpeta config guarda conocimiento transversal; cada proyecto mantiene sus propias entradas y resultados.
Por qué aprender
Los contextos separados ayudan a limitar lo que la IA necesita leer. Una carpeta llena de asuntos no relacionados aumenta el ruido y dificulta explicar de dónde provino una conclusión.
Conceptos clave
Carpeta personal; proyectos; contexto; entradas y salidas.
En la práctica
En ~/projetos/website se encuentran los archivos del sitio. En ~/projetos/estudos están los experimentos. En Windows, el gestor puede mostrar rutas como C:\Users\SeuNome\projetos.
✓ Hazlo
Dibuja el árbol antes de crear archivos. Elige un único proyecto de entrenamiento y una única carpeta global config.
✗ Evita
Aceptar una conclusión sin comprobar la entrada que la sustenta.
2Markdown es texto organizado
Qué es
Markdown usa señales simples para organizar texto: # crea título, ## crea subtítulo y un guion inicia un ítem de lista. El archivo sigue siendo texto, legible incluso sin un editor especial. El nombre termina en .md. No necesitas escribir código para registrar instrucciones claras.
Por qué aprender
Archivos pequeños, nombrados y fáciles de editar duran más que una conversación perdida. Pueden ser revisados por personas y consultados por agentes. El valor proviene de la claridad, no de un formato elaborado.
Conceptos clave
Título; lista; bloque de código; enlace; texto simple.
En la práctica
Un README puede contener: propósito, archivos de entrada, resultado esperado y cómo verificar. Quien llegue después entiende la tarea sin depender de la conversación original.
3Cada archivo tiene un trabajo
Qué es
memoria.md registra preferencias estables; decisoes.md explica elecciones; dicas.md guarda procedimientos útiles; falhas.md documenta problemas y correcciones. No coloque todo en un documento gigante. Cuando una decisión cambia, registre fecha y motivo para no mantener reglas contradictorias.
Por qué aprender
Separar funciones facilita consultar solo lo necesario. Un historial de fallas no debería convertirse en una lista de comandos obligatorios en toda tarea. Conocimiento consultable e instrucciones permanentes son cosas diferentes.
Conceptos clave
Memoria selectiva; decisiones fechadas; procedimiento; historial.
En la práctica
“Prefiero informes cortos” es una preferencia. “Elegimos CSV por ser compatible con la hoja de cálculo del equipo” es una decisión. “El servicio se detuvo sin supervisión” pertenece a los fallos.
Secuencia para experimentar
- Prepara una copia de entrenamiento.
- Distribuya cinco notas ficticias entre los cuatro archivos. Para cada una, explique por qué ese es el lugar adecuado.
- Registra el resultado observado y la próxima corrección.
4Los secretos no son conocimiento compartible
Qué es
Un archivo .env puede guardar variables como TELEGRAM_BOT_TOKEN o DATABASE_URL. No está cifrado: cualquier persona con acceso al archivo puede leerlo. Use permisos adecuados y nunca incluya valores reales en capturas de pantalla, ejemplos de curso o archivos enviados a la IA sin necesidad.
Por qué aprender
Las credenciales permiten actuar en nombre de una cuenta. Separar el modelo .env.example, sin valores reales, del .env local permite compartir la estructura sin distribuir acceso.
Conceptos clave
Variable; secreto; .env.example; lectura en tiempo de ejecución.
En la práctica
El kit incluye TELEGRAM_BOT_TOKEN=rellene_localmente. El alumno sustituye eso solo en su copia privada. Ningún bot queda autenticado con este ejemplo.
✓ Hazlo
Cree .env.example con nombres de variables y valores ficticios. Mantenga .env fuera del repositorio y nunca pegue su clave en el chat.
✗ Evita
Mezclar la copia de entrenamiento con archivos privados o trabajo en producción.
5Ignorar antes del primer commit
Qué es
El .gitignore lista archivos que Git debe ignorar cuando aún no son rastreados. Incluya .env, variantes privadas y carpetas temporales. Mantenga una excepción explícita para .env.example. Antes de guardar una versión, examine git status y los archivos preparados.
Por qué aprender
Ignorar después no borra un secreto del historial. Si la clave se filtró, la primera corrección es revocar o rotar en la fuente; eliminar la línea del archivo no invalida una copia ya vista.
Conceptos clave
Archivos rastreados; patrones de exclusión; revisión de cambios; revocación.
En la práctica
Patrones útiles: .env, .env.*, !.env.example, __pycache__/. Para descubrir qué regla se aplica, use git check-ignore -v .env.
6Haga una limpieza de contexto
Qué es
La IA no lee automáticamente todo archivo Markdown existente en el ordenador. Indique qué documentos consultar y mantenga referencias en AGENTS.md cuando sean necesarias. Antes de una tarea, elimine datos irrelevantes de la copia de trabajo y actualice decisiones vencidas.
Por qué aprender
La memoria útil necesita ser encontrada y estar correcta. Un archivo antiguo puede entorpecer más que no tener memoria si trae una dirección de servicio o proceso que ya cambió.
Conceptos clave
Selección de contexto; fecha; fuente de verdad; revisión periódica.
En la práctica
Al iniciar un informe, solicite lectura de README.md y de la decisión sobre formato. No cargue listas de contactos ni credenciales porque están en la misma carpeta.
Criterios para revisar su entrega
Use esta rúbrica después del laboratorio. Cada línea pide una evidencia; marcar lectura no significa que la práctica se haya ejecutado.
| Criterio | Evidencia esperada | Si no pasó |
|---|---|---|
| Alcance | La entrega corresponde al objetivo de esta clase. | Reduzca la tarea y nombre un único resultado. |
| Entradas | Usted sabe qué archivos o datos se usaron. | Liste las fuentes y elimine material sin relación. |
| Ejecución | El procedimiento se realizó en el entorno de entrenamiento. | Diferencie lo que se planificó de lo que se hizo. |
| Conferencia | Un resultado se comparó con una referencia. | Abra el archivo o repita la consulta verificable. |
| Secretos | No se compartió ningún token, contraseña o dato privado. | Revise la copia de trabajo antes de cualquier envío. |
| Continuidad | Otra persona puede encontrar el siguiente paso. | Actualice el README y registre una pendiente concreta. |
MANOS A LA OBRA / ~15 MIN O EN ETAPAS
Organice su segundo cerebro operacional
Use archivos ficticios y una carpeta de entrenamiento. Las prácticas con instalación, Telegram o VPS pueden requerir tiempo adicional para registro y configuración.
Estructura de trabajo
Lea el bloque antes de usar. Campos como Su Nombre y usuario@ip-de-vps son ejemplos para adaptar; los comandos administrativos pertenecen solo a su entorno de entrenamiento.
~/projetos/
├── config/
│ ├── memoria.md
│ ├── falhas.md
│ ├── dicas.md
│ └── decisoes.md
└── meu-primeiro-projeto/
├── AGENTS.md
├── README.md
├── .gitignore
├── entradas/
└── saidas/
Criterio de listo
Montar la casa digital y separar conocimiento de credenciales. Registre el archivo producido, la prueba ejecutada y el resultado observado.
Abrir archivos y modelos del laboratorioCompruebe lo que quedó
¿Agregar .env al .gitignore elimina automáticamente una clave ya publicada?
Ver respuesta comentada
No. Revoca la clave expuesta y corrige el historial según el caso; ignorar solo previene nuevos archivos no rastreados.
Si su respuesta fue diferente, vuelva al tema correspondiente y escriba la diferencia en una frase. La verificación no bloquea su estudio.
Resumen del módulo
- Carpeta personal; proyectos; contexto; entradas y salidas.
- Título; lista; bloque de código; enlace; texto simple.
- Memoria selectiva; decisiones fechadas; procedimiento; historial.
- Variable; secreto; .env.example; lectura en tiempo de ejecución.
- Archivos rastreados; patrones de exclusión; revisión de cambios; revocación.
- Selección de contexto; fecha; fuente de verdad; revisión periódica.
Consulte la fuente
Herramientas verificadas el 20/09/2026; los nombres de pantallas y la disponibilidad pueden cambiar.