Saltar a contenido

Cómo contribuir

Belico Ecosystem es open source MIT y la comunidad LATAM puede adoptar, contribuir y mejorar. Esta guía resume el flujo de contribución.

Fuente canónica

La fuente única de verdad para contribuir es CONTRIBUTING.md en la raíz del repo. Esta página es un resumen orientado a la tarea — ante cualquier diferencia, gana el archivo raíz.

Qué podés contribuir

  • Código: harnesses, sub-agentes, tools, fixes.
  • Dominios: nuevos backends científicos (config/domains/ + domains/ + skill).
  • Traducciones: las páginas EN que están como 🚧 translation pending.
  • Documentación: mejoras a tutoriales, how-to y explicaciones.
  • Reportes: bugs y propuestas vía GitHub Issues.

Flujo de trabajo (SDD)

Los cambios sustanciales siguen el patrón Spec-Driven Development:

EXPLORE → PROPOSE → [SPEC ∥ DESIGN] → TASKS → IMPLEMENT → VERIFY → ARCHIVE

Cada cambio vive en openspec/changes/<nombre>/ con proposal.md, design.md, tasks.md y spec deltas. Ver SDD workflow.

Convenciones de commits

Formato conventional commits:

feat(scope): descripción corta
fix(scope): descripción corta
docs(scope): descripción corta
test(scope): descripción corta

Sin atribución de IA

No agregar Co-Authored-By ni atribución de IA en los commits. Conventional commits solamente.

Antes de abrir un PR

  1. Corré los tests: pytest tests/ (después de pip install -r requirements-dev.txt).
  2. Corré el linter: ruff check . + ruff format --check . (ver Migración a Ruff).
  3. Verificá que el build de docs pasa: mkdocs build --strict.
  4. Si tocaste el draft/pipeline/config, indicá que el Verifier debe validar.

Code review (GGA)

El pre-commit hook GGA enforza las 11 reglas de AGENTS.md en cualquier commit que toque .py, .h, .sh. Configurable vía .gga (PROVIDER="claude" | "gemini" | "openai").

Ver también