Skip to content

English · Español

Fase 00 — Fundamentos

Requiere: ninguna — esta fase es el punto de entrada Enseña: reproducibility · seeding · lockfile · pre-commit · ci · mypy Salta a cualquier capítulo desde el índice de referencia de fases.

Mapa del capítulo

Sección del spec: LYNX_CORTEX.md §4 fila 0. Objetivo: un entorno Python reproducible, higiénico y bien tipado donde pueda correr el resto del currículo. Nada más, nada menos.

Resumen. Fase de higiene: entorno reproducible (seeds, lockfile, manifiestos), tooling (ruff, mypy, pytest, pre-commit, bandit, pip-audit), CLAUDE.md + .claude/ para que toda sesión futura respete las reglas del proyecto. No tocamos NumPy ni mates aún.

Definición de hecho (DoD)

La fase está solo hecha cuando todo lo siguiente es cierto (verificado por el subagente phase-gatekeeper — ver .claude/agents/phase-gatekeeper.md):

  • just setup && just lint && just test sale en verde en un clon limpio.
  • CI pasa en un commit de prueba (badge en verde en main).
  • CLAUDE.md + .claude/settings.json + .claude/commands/ + .claude/agents/ poblados y un slash command (/phase-checkpoint) se resuelve en una nueva sesión de Claude Code.
  • learners/borja/ inicializado; la fila 00 de progress.md refleja in-flight → done al cierre.
  • theory/, lab/, solutions/ poblados.
  • lab/00-env-checklist.md completado por Borja.
  • just audit-deps (pip-audit) limpio.
  • bandit limpio sobre src/.
  • Existe la primera entrada de diario (learners/borja/journal/2026-05-22.md).
  • src/utils/BLUEPRINT.md + src/utils/README.md escritos.

Orden de lectura

  1. theory/00-motivation.md — por qué higiene antes que IA (AI).
  2. theory/01-reproducibility.md — seeds, lockfiles, manifiestos.
  3. theory/02-engineering-hygiene.md — pre-commit, ruff, mypy como política.
  4. theory/03-dev-environment.md — IDE, plugins, CLI, personalización de Claude Code.
  5. lab/00-env-checklist.md — instalar + verificar (lo corre Borja).
  6. lab/01-write-the-justfile.md — extender Justfile con una receta nueva.
  7. lab/02-write-the-pre-commit-hooks.md — añadir un hook personalizado.
  8. lab/03-seed-by-hand.md — reimplementar seed_everything sin mirar.
  9. Solo tras intentar los labs → solutions/*.md.

Estructura

docs/phase-00-foundations/
├── README.md                  (este archivo)
├── theory/
│   ├── 00-motivation.md
│   ├── 01-reproducibility.md
│   ├── 02-engineering-hygiene.md
│   └── 03-dev-environment.md
├── lab/
│   ├── 00-env-checklist.md
│   ├── 01-write-the-justfile.md
│   ├── 02-write-the-pre-commit-hooks.md
│   └── 03-seed-by-hand.md
├── solutions/
│   ├── 01-justfile-ref.md
│   ├── 02-precommit-ref.md
│   └── 03-seeding-ref.md
├── notebooks/                 (demos ejecutables)
├── diagrams/                  (mermaid + svg)
└── PHASE_00_REPORT.md         (escrito al cierre de la fase)

Informe de fase

Tras /phase-report 00, PHASE_00_REPORT.md aterriza en la raíz del repo (el informe es un artefacto de nivel superior, no dentro de este directorio, porque es la puerta a la Fase 1).

Lecturas recomendadas

Opcional — enriquece pero no es necesario para aprobar la fase.