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
 
✓ 10 herramientas verificadas
✓ GitHub + Firebase autenticados
✓ 4 MCPs + 8 plugins instalados
✓ 3 hooks, 5 workflows, 13 guidelines
 
Entorno listo!
Monorepo — tres paquetes, un ecosistema

Arquitectura modular

Los tres paquetes viven en un unico monorepo pnpm. 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.

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

Wizard

Configuracion automatica del entorno global. Instala MCPs, configura Karajan y deja todo listo para trabajar.

  • 4 MCPs + 8 plugins de Claude Code
  • Karajan + BecarIA configurados
  • Comando create: scaffold completo
  • Comando sync: regenerar config
  • 15 proyectos en catalogo
  • 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
→
MCPs
→
Plugins
→
Workspace
→
Clone + Hooks
→
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, no force push. Aplicado automaticamente.

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.

HO

Houston Override

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

GH

5 GitHub Actions

CI, automerge, becaria-gateway, houston-override, no-ai-refs. Copiados automaticamente con create.

HK

3 Hooks, 8 Checks

Pre-commit (lint, regression, AI refs), commit-msg, pre-push (SSH, identity, rebase, diff). Todo via Husky.

GL

13 Guidelines

Estilo, naming, errores, testing, seguridad, UI/UX, commits, deps, plan, proteccion, Firebase, Astro+Lit, identidad.

AI

5 Agentes IA

Guidelines auto-generados para Claude, Copilot, Codex, Gemini y Cursor. Actualizados con cada init.

PG

Planning Game

MCP para tareas, sprints, bugs, estimaciones (devPoints/businessPoints), ADRs. Desde el IDE.

KJ

Karajan

Orquestacion AI: Coder, Reviewer, Solomon, Tester, Security. Local con keys del developer.

PL

8 Plugins

frontend-design, impeccable, code-review, pr-review-toolkit, code-simplifier, security-guidance y mas.

CR

Scaffold + Create

Comando create: repo GitHub + scaffold (Astro/Next/Node) + hooks + actions + protection en un wizard.

Empezar

Quick Start

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

1

Ejecuta el bootstrapper

Verifica 10 herramientas, autenticacion, instala 4 MCPs + 8 plugins, crea workspace con guidelines. Todo interactivo.

npx @geniova/developer-kit init
2

Clona un proyecto existente

El wizard te permite seleccionar proyectos del catalogo. Tambien puedes clonar manualmente:

gh repo clone Geniova-Technologies/{proyecto}
npx @geniova/git-hooks init
✶

O crea un proyecto nuevo

Scaffold completo: repo en GitHub, estructura segun stack (Astro+Lit / Next / Node), hooks, 5 GitHub Actions, branch protection y .env con config de Firebase/Vercel.

npx @geniova-technologies/geniova-kit create

Stacks: Astro + Lit · Next.js · Node.js puro

↻

Sincroniza un proyecto existente

Re-genera guidelines, verifica hooks, MCPs y .env de un proyecto ya configurado.

npx @geniova-technologies/geniova-kit sync [directorio]
Alternativa

Deja que la IA lo haga

Si usas Claude Code, pega este prompt y el se encarga de todo. Necesitas tener Claude Code instalado y pertenecer a la org.

Configura mi entorno de desarrollo para Geniova Technologies:
1. Verifica que tengo instalado: node >= 18, git, gh (GitHub CLI), pnpm, firebase-tools y claude
2. Si falta algo, instalalo (Linux: apt/npm, macOS: brew/npm)
3. Autentica gh con SSH y scope read:packages
4. Configura ~/.npmrc para @geniova-technologies en GitHub Packages
5. Ejecuta: npx @geniova/developer-kit init
6. Responde a las preguntas del wizard con los valores por defecto
7. Si algo falla, diagnostica el error y reintenta
Como trabajar

Workflow obligatorio

Todo cambio sigue este flujo. Sin excepciones. Nunca push directo a main.

Card en PG
→
In Progress
→
Rama feat/fix
→
Commits
→
Push + PR
→
kj review
→
To Validate
1

Planning Game

Toda tarea necesita card (task/bug). Marcar "In Progress" con startDate al empezar. devPoints + businessPoints para prioridad automatica.

2

Desarrollo

Rama feat/CARD-ID-desc. Conventional Commits. Test-first (TDD). Max ~300 lineas por PR. Implementation Plan si devPoints ≥ 3.

3

Review + Merge

Push + PR + kj review. BecarIA publica review. Label automerge para merge automatico. Marcar "To Validate" con commits.

Proteccion automatica

Hooks y reglas

3 hooks de git con 8 checks automaticos. Mas 13 guidelines embebidos en todos los agentes IA.

✎
pre-commit

4 checks al commitear

Se ejecuta automaticamente antes de cada commit.

  • Strip Comments — limpia indicadores IA
  • Lint (ESLint + Stylelint) — bloquea
  • Regression — detecta codigo re-anadido
  • No AI Refs — bloquea menciones a IA
✉
commit-msg

Mensaje sin IA

Valida que el mensaje de commit no contenga referencias a herramientas de IA.

  • Co-Authored-By: Claude/GPT — bloqueado
  • "Generated by AI" — bloqueado
  • "AI-assisted" — bloqueado
  • Conventional Commits recomendado
⇧
pre-push

4 checks al pushear

Solo en ramas feat/* y fix/*. Verifica antes de enviar.

  • SSH Remote — no HTTPS, bloquea
  • Git Identity — email @geniova.com
  • Rebase Check — rebasado sobre main
  • Diff Summary — warn si >300 lineas
13 guidelines de codigo

1. Estilo

SOLID, DRY, KISS, YAGNI. const por defecto.

2. Naming

kebab-case archivos, camelCase funciones, PascalCase clases.

3. Errores

Explicitos, nunca silenciosos. No || para datos criticos.

4. Testing

Test-first. Vitest + Playwright. Coverage 80/90/70%.

5. Seguridad

Validar inputs, XSS, SQL injection. No secrets en git.

6. UI/UX

No alert() nativo. ModalService. Loading, toast, a11y.

7. Commits

Conventional Commits. Max 300 lineas. Sin refs IA.

8. Deps

Solo si no se puede en <50 lineas. npm audit regular.

9. Plan

Obligatorio si devPoints ≥ 3 o >2 ficheros.

10. Archivos

Nunca sobreescribir sin leer. Edit puntual, no Write.

11. Firebase

Modelado Firestore, security rules, no Admin en cliente.

12. Astro+Lit

SSG vs SPA. Web Components. Hidratacion selectiva.

+ 13. Git & Firebase Identity — SSH obligatorio, verificar cuenta antes de deploy

Diseno

Arquitectura

Un monorepo pnpm con tres paquetes. 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 automatico. Configura MCPs, Karajan y BecarIA.

→
Publico (npm)
@geniova/git-hooks

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