Geniova Technologies

Developer Kit

Tu entorno de desarrollo, listo en un comando. Prerrequisitos, MCPs, git hooks, guidelines y AI review configurados en minutos.

Terminal
$ npx @geniova/developer-kit init
 
✓ Prerrequisitos verificados
✓ Autenticacion correcta
✓ Proyecto clonado
✓ MCPs configurados
✓ Hooks y guidelines instalados
 
Configuracion completada!
Tres paquetes, un ecosistema

Arquitectura modular

Cada pieza tiene una responsabilidad clara. El bootstrapper verifica, el wizard configura, los hooks protegen.

01
@geniova/developer-kit

Bootstrapper

Punto de entrada publico. Verifica que tu maquina tiene todo lo necesario y lanza el wizard privado.

  • Node.js >= 18
  • pnpm, gh, firebase-tools
  • Claude Code + Karajan
  • Auth GitHub y Firebase
  • Pertenencia a la org
02
@geniova-technologies/geniova-kit

Wizard

Setup interactivo del proyecto. Selecciona, clona, instala y configura todo el entorno de desarrollo.

  • Catalogo de 18 proyectos
  • Clonar repo + dependencias
  • MCPs obligatorios y opcionales
  • Generar .env y configuracion
  • Paquete privado (GitHub Packages)
03
@geniova/git-hooks

Git Hooks

Proteccion del repositorio. Checks automaticos en cada commit, push y PR. Guidelines para 5 agentes IA.

  • 8 checks (lint, AI refs, SSH...)
  • 13 guidelines de codigo
  • 5 agentes: Claude, Copilot, Codex, Gemini, Cursor
  • MCP Server con 8 tools
  • GitHub Action no-ai-refs
De cero a productivo

Pipeline de setup

Un unico comando ejecuta todo el pipeline. Cada paso verifica el anterior antes de continuar.

Prerequisites
→
Auth
→
Proyecto
→
Clone
→
Deps
→
MCPs
→
Hooks
→
Guidelines
→
Ready
Incluido en el kit

Todo lo que necesitas

Herramientas, integraciones y automatizaciones para que el equipo se enfoque en construir, no en configurar.

BP

Branch Protection

PRs obligatorias, 1 aprobacion minima, dismiss stale reviews. Aplicable a todos los repos.

BR

BecarIA Review

AI Code Review via GitHub App. Karajan ejecuta en local, BecarIA publica APPROVE o REQUEST_CHANGES.

AM

Automerge

Label automerge + aprobacion de BecarIA + CI verde = merge automatico por squash.

HO

Houston Override

Override de emergencia para IT. Label houston + comentario con razon = merge inmediato con audit trail.

KJ

Karajan

Pipeline AI completo: Coder, Reviewer, Solomon, Sonar. Todo en local con las keys del developer.

PG

Planning Game

MCP integrado para gestion de tareas, sprints, bugs y estimaciones directamente desde el IDE.

SQ

SonarQube

Analisis de calidad integrado. Quality gates, coverage, code smells. Opcional pero recomendado.

18

18 Proyectos

Catalogo completo de Geniova: Extranet, Intranet, Visor 3D, PlanningGame, Auth, y mas.

Empezar

Quick Start

Tres pasos para tener tu entorno listo. Necesitas pertenecer a la organizacion Geniova-Technologies en GitHub.

1

Ejecuta el bootstrapper

Verifica prerrequisitos, autenticacion y lanza el wizard automaticamente.

npx @geniova/developer-kit init
2

Selecciona tu proyecto

El wizard muestra el catalogo de proyectos. Elige el tuyo y se clona, instala deps, configura MCPs y hooks.

? Selecciona proyecto: Extranet V2
3

Empieza a trabajar

Revisa el .env generado, completa los valores pendientes y comienza a desarrollar con todo configurado.

cd extranet-v2 && pnpm dev
Diseno

Arquitectura

El bootstrapper publico es la puerta de entrada. El wizard privado hace el trabajo. Los hooks protegen el resultado.

Publico (npm)
@geniova/developer-kit

Verifica entorno y auth. Configura registry de GitHub Packages. Lanza el wizard.

→
Privado (GitHub Packages)
@geniova-technologies/geniova-kit

Wizard interactivo. Setup completo del proyecto seleccionado.

→
Privado (GitHub)
@geniova/git-hooks

Hooks, checks, guidelines para todos los agentes IA. MCP Server.