Imported from pedri77/ia-engineer-framework (.omp/AGENTS.md). Install upstream with npx skills add pedri77/ia-engineer-framework --skill .omp. Copyright stays with the author.

ia-engineer-framework — contexto para agentes

Framework open-source (MIT) de patrones, plantillas y scripts para construir agentes IA fiables en producción, organizado en 6 tiers (harness, eval, observe, hooks, patterns, CI). Audiencia: desarrolladores hispanohablantes que copian archivos sueltos a sus proyectos ("copy-paste to production"). Forma parte de IAcademy (iacademy.es).

Mapa del repo

• index.html — landing bilingüe ES/EN desplegada en GitHub Pages.
• harness/ — Tier 1: plantillas de control del agente (CLAUDE.md, AGENTS.md, feature_list.json, progress.md, session-handoff.md, definition-of-done.md, init.sh).
• eval/ — Tier 2: datasets JSONL (32 escenarios en datasets/), runners Python (run-evals.py, score-evals.py, ci-gate.py), plantillas de rúbrica.
• observe/ — Tier 3: logging/agent-logger.py, cost-tracker.py, dashboard Grafana, alertas.
• hooks/ — Tier 4: scripts Claude Code (pre-commit lint, security scan, cost guard, context check, post-task verify).
• patterns/ — Tier 5: 8 docs de patrones de producción (diagnostic loop, circuit breaker, model routing…).
• ci/ — Tier 6: github-action.yml (Action "AI Agent Quality Gate" en PRs a main), quality-gate.py, pre-push-check.sh.
• examples/ — proyectos ejemplo (fastapi-agent/, nextjs-assistant/, n8n-automation/).
• distribution/ — material de difusión (posts Reddit/HN/Devto, script de blog). No forma parte del framework.
• docs/ — getting-started, philosophy, faq, contributing.
• CI/deploy: solo el GitHub Action de calidad en PRs (no hay .github/workflows/; el workflow vive en ci/github-action.yml). Landing en GitHub Pages.

Stack y comandos

• Sin gestor de dependencias global (no hay package.json, pyproject ni Makefile): repositorio de contenido + scripts Python 3.11 standalone (stdlib). Sin instalación necesaria.
• Ejecutar evals: python3 eval/runners/run-evals.py; scoring: python3 eval/runners/score-evals.py; gate CI: python3 eval/runners/ci-gate.py.
• Bootstrap de ejemplo: bash harness/init.sh (editable, con INSTALL/VERIFY/START_CMD plantilla).
• Pre-push local: bash ci/pre-push-check.sh; quality gate: python3 ci/quality-gate.py.
• Sin suite de tests propia (el repositorio provee plantillas de testing, no tests de sí mismo).

Estado y últimos cambios

• Rama única main, working tree limpio. Historial (5 commits):
  • b0fef64 chore: add distribution/ to gitignore
  • 71f6561 feat: bilingual landing page (ES/EN) with IAcademy branding
  • dd03f58 feat: add GitHub Pages landing page
  • eb25268 feat: add Mermaid diagrams — architecture, diagnostic loop, diamante, eval pipeline
  • 5c1f16d feat: ia-engineer-framework v1.0.0 — 6 tiers + 8 patterns
• v1.0.0 según CHANGELOG.md. TODO/FIXME en código: ninguno (única coincidencia es la palabra "TODOS" en prosa de patterns/graph-engineering.md).

Reglas del proyecto

• Idioma: README, docs y comentarios en español; código y nombres técnicos en inglés. Commits en inglés, estilo conventional (feat:, chore:).
• Cada archivo debe funcionar standalone: nada de imports cruzados ni dependencias de framework.
• Validación mínima: python3 -m py_compile <script.py> para scripts tocados; el CI de PR ejecuta el quality gate, no duplicarlo en local salvo cambio en ci/ o eval/.

Riesgos detectados

• hooks/__pycache__/ existe en disco pero NO está versionado (git ls-files no lo lista); no añadirlo.
• Sin dependencias externas que fijar (solo stdlib): riesgo de dependencias sin fijar no aplica.
• Secretos en claro: ninguno (los scripts referencian nombres de variables de entorno, no valores). Rutas hardcodeadas a /Users/pedri77: ninguna.
• Ficheros enormes versionados: ninguno (el mayor es index.html, ~16 KB).