Todo lo que necesitas para preparar tu entorno de desarrollo en Geniova Technologies. Herramientas, autenticacion, MCPs y configuracion global.
Necesitas estas herramientas instaladas y configuradas en tu maquina antes de ejecutar el bootstrapper.
Control de versiones. git-scm.com. En Linux: sudo apt install git. En macOS: xcode-select --install.
Instalar con nvm para que todos los entornos sean consistentes: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash y luego nvm install 22.
Gestor de paquetes rapido y eficiente. Obligatorio para todos los proyectos Geniova.
Instalar desde cli.github.com. Debe estar autenticado con acceso a la org Geniova-Technologies.
Herramientas de Firebase. Autenticar con firebase login usando la cuenta Geniova.
Agente de IA para desarrollo. Requiere licencia proporcionada por Geniova Technologies.
Orquestador de agentes IA. Requiere Claude (obligatorio). Codex y Gemini son opcionales (cuentas personales gratuitas).
Un unico comando inicia todo el proceso. El kit prepara tu entorno de desarrollo global, no un proyecto especifico.
El punto de entrada publico verifica que tu maquina cumple todos los prerrequisitos (7 herramientas), valida la autenticacion con GitHub y Firebase, confirma la pertenencia a la organizacion Geniova-Technologies, y verifica el scope read:packages para acceder a los paquetes privados. Si falta el scope, lo solicita automaticamente via gh auth refresh.
Los MCPs conectan las herramientas de IA con los servicios de Geniova. El wizard comprueba si ya estan instalados y solo configura los que falten.
El wizard instala plugins globales para todos los proyectos: frontend-design, impeccable (suite de diseno), code-review, pr-review-toolkit, code-simplifier, security-guidance, commit-commands y claude-code-setup.
El wizard pregunta donde tienes los proyectos de Geniova (ej: ~/ws_geniova) y genera ahi un CLAUDE.md con las guidelines comunes + .ai/guidelines/ con la referencia completa. Aplican a todos los proyectos dentro de ese directorio, sin afectar a proyectos personales fuera de el.
El wizard te pregunta si quieres configurar un proyecto. Si dices que si, selecciona del catalogo, clona, instala dependencias, hooks y genera ficheros de config. Puedes repetir para varios proyectos o saltar este paso.
Con el entorno preparado, este es el flujo que seguiras para cada tarea o bug en cualquier proyecto. Todas las tareas pasan por Planning Game y Pull Request.
Toda tarea debe tener una card antes de empezar a trabajar. Puede ser una task o un bug. Si no existe, crearla con titulo, descripcion estructurada y criterios de aceptacion.
Siempre trabajar en una rama dedicada. Nunca hacer push directo a main.
Seguir Conventional Commits (feat:, fix:, refactor:, test:, docs:, chore:). Ejecutar tests despues de cada cambio significativo. Maximo 300 lineas por PR.
La PR debe ser atomica: un solo proposito. Incluir descripcion clara de los cambios y referencia a la card del Planning Game.
Karajan ejecuta el review en local y BecarIA publica el resultado como GitHub App. Un companero del equipo debe aprobar tambien antes del merge.
Con la aprobacion de BecarIA y un companero, y el CI en verde, la PR se mergea a main. Si tiene el label automerge, se mergea automaticamente.