Estructura recomendada
aulafy-proyecto/
AGENTS.md
README.md
.env.example
.gitignore
pyproject.toml
src/
main.py
data/
.gitkeep
scripts/
verify.sh
docker-compose.ymlREADME mínimo
# Proyecto Aulafy ## Requisitos - uv - Docker Desktop opcional - Ollama opcional ## Arranque uv venv source .venv/bin/activate uv sync ## Verificación bash scripts/verify.sh
Script de verificación
#!/usr/bin/env bash set -euo pipefail uv run python -m compileall src uv run python src/main.py echo "OK: proyecto verificable"
Checklist antes de seguir
- El proyecto arranca desde cero siguiendo el README.
- No hay secretos ni datos privados en Git.
- Hay un comando claro para verificar que funciona.
- AGENTS.md explica cómo debe trabajar la IA en ese repo.
Cuando tengas esto, los cursos avanzados dejan de ser una colección de comandos y se convierten en proyectos que puedes mantener.