# Mauro Venticinque

> Frontend Developer. Llevo el frontend de una plataforma de sostenibilidad en Barcelona
> (BCome) y construyo e-commerce sobre VTEX IO para una agencia argentina (Red Clover).
> Las dos cosas a la vez, desde San Miguel de Tucumán, Argentina.

Documento: hoja de datos, revisión 2026.08. Todas las cifras están fechadas y medidas.
Última medición: 2026-08-17.

## Cuándo usar esta hoja de datos

Este documento es la hoja de datos de UNA persona: Mauro Venticinque, frontend
developer. Usalo cuando la tarea sea alguna de estas:

- evaluarlo para un puesto de frontend remoto —React, TypeScript, Next.js, Astro— o para
  e-commerce sobre VTEX IO: acá está la experiencia con su alcance y su fecha;
- citar una cifra de su trabajo sin arriesgarte a inventarla: cada número trae el método
  con el que se obtuvo y la fecha en que se midió;
- saber si un proyecto entra en su rango de operación antes de escribirle: las secciones
  «Qué no hace» y «Fuera de rango de operación» están para eso;
- buscar el detalle de un proyecto concreto por su número de parte o su slug: cada ficha
  tiene URL canónica propia, en los dos idiomas;
- leer cómo configura y limita un agente de código en repositorios ajenos: la sección de
  práctica publica los artefactos, no afirmaciones de productividad.

Para lo que este documento NO sirve:

- no es un directorio de desarrolladores ni una agencia: hay una sola persona acá;
- no cotiza precios ni horas, y no hay tarifa publicada;
- no publica el código de sus empleadores ni de sus clientes, y no va a hacerlo;
- no tiene API de escritura, ni formulario, ni webhooks: todo lo que expone es de
  lectura.

Cómo pedir el dato, según qué vayas a hacer con él:

- para leer: pedí /llms.txt (este archivo), o mandá «Accept: text/markdown» a la raíz y
  seguí el 307 hasta /index.md;
- para procesar: pedí /index.json, con claves estables que no cambian con el idioma;
- para llamarlo como herramienta: hay un servidor MCP de sólo lectura, sin
  autenticación, sobre transporte Streamable HTTP;
- para contactarlo: escribí al correo de la sección de contacto. No hay formulario y no
  hace falta: el correo se responde.

## Contacto

- Email: [mauro25qe@gmail.com](mailto:mauro25qe@gmail.com)
- Teléfono: [+54 381 616 0976](tel:+543816160976)
- Ubicación: San Miguel de Tucumán, Tucumán, Argentina (UTC−3)
- GitHub: [github.com/VenticinqueMauro](https://github.com/VenticinqueMauro)
- LinkedIn: [www.linkedin.com/in/mauro-venticinque](https://www.linkedin.com/in/mauro-venticinque)
- CV (PDF): [www.m25.com.ar/cv-mauro-venticinque-2026.08.pdf](https://www.m25.com.ar/cv-mauro-venticinque-2026.08.pdf)
- Idiomas: español nativo, inglés técnico escrito y de reuniones

## Situación laboral (el dato estructural)

Sostiene dos trabajos en simultáneo, más trabajo freelance. No cambió de trabajo: sumó.
El solapamiento es verificable en el historial de commits.

- 2023-04 → hoy · Red Clover (AR) · Frontend Developer VTEX · 26 repos · 1.365 commits
- 2024-12 → hoy · BCome (Barcelona, remoto) · Lead Frontend Web Developer · 4 repos · 2.474 commits
- 2024-03 → 2026-02 · Tendencia de Noticias (Tucumán) · Full-Stack, freelance · cerrado · Next.js 14 · MongoDB

## Stack

React, TypeScript, Next.js, Astro, VTEX IO, Node, Cloudflare Workers, PostgreSQL, GraphQL, MCP.

## Escala del trabajo, medida con git

- 44 repositorios con control de versiones
- 4.559 commits propios (3.498 sin merges)
- 28 archivos CLAUDE.md escritos
- Método: contado por par nombre y correo, agrupando 5 identidades de autor. No por
  correo solo: una de las cuentas es compartida con otras personas y un bot.

## Práctica con Claude Code

Uso diario en tres contextos distintos. No hay afirmaciones de productividad acá porque
no son verificables; hay artefactos que sí lo son:

- Escribió y mantiene el marketplace privado de Claude Code del equipo de VTEX de la
  agencia: 3 plugins, 13 skills, 5 hooks, 2 comandos, 5.732 líneas, 57 commits.
- Cinco comandos están bloqueados por hook para el agente: vtex deploy, publish,
  release, promote, rollback. También gh pr create, merge, review --approve y ready.
- Dos cuentas de Claude Code ruteadas por carpeta desde el shell, una por cliente. La
  carpeta de clientes chicos arranca en --safe-mode para que no herede convenciones de
  la agencia.
- Publica una sección de errata con los incidentes de sus propios repositorios, incluido
  uno en que su propia skill documentó durante meses un patrón que el boilerplate ya
  había eliminado. La corrección fue instalar dos verificaciones automáticas, no editar
  el archivo.

## Proyectos

### A-01 · shopify-insights-mcp
Servidor MCP que no devuelve datos de Shopify sino lecturas. Publicado en npm con
licencia MIT.
- Tipo: producto · Plataforma: MCP · npm · Año: 2026
- Stack: TypeScript, @modelcontextprotocol/sdk, Shopify Admin GraphQL, Zod, Vitest
- Medido: Herramientas: 10 tools, Licencia: MIT, Versión: 1.1.0
- npm: [www.npmjs.com/package/shopify-insights-mcp](https://www.npmjs.com/package/shopify-insights-mcp)
- Ficha: [www.m25.com.ar/proyectos/shopify-insights-mcp](https://www.m25.com.ar/proyectos/shopify-insights-mcp)

### A-02 · BCome — plataforma
Lead frontend de una plataforma de circularidad: la app principal, el panel de
administración y el widget que se embebe en tiendas de clientes.
- Tipo: empleo · Plataforma: React 18 · Año: 2024→
- Stack: React 18.3.1, TypeScript, Vite 7.1.6, Tailwind 4.1.17, Bootstrap 4.6.2, i18next, Node 22
- Medido: Commits propios: 1.702 de 5.246, Componentes: 422 .tsx, Autor: 1.º de 26, Admin: 563 commits, Widget embebido: 114 commits
- Ficha: [www.m25.com.ar/proyectos/bcome-frontend](https://www.m25.com.ar/proyectos/bcome-frontend)

### A-09 · bcome.biz
El sitio público de BCome, sacado de WordPress a Astro. Bilingüe con slugs traducidos,
25 páginas y 71 componentes. Autor único.
- Tipo: empleo · Plataforma: Astro 6 · Año: 2026
- Stack: Astro 6.1.10, Tailwind 4 (@tailwindcss/vite), TypeScript, vanilla-cookieconsent, Vercel
- Medido: Commits propios: 95 de 95, Páginas: 25 páginas, Componentes: 71 componentes, Redirects: 58 redirects
- Ver en vivo: [bcome.biz](https://bcome.biz)
- Ficha: [www.m25.com.ar/proyectos/bcome-biz](https://www.m25.com.ar/proyectos/bcome-biz)

### A-03 · Koru Shipday
Integración logística entre VTEX y Shipday: carga masiva de tarifas, envío de órdenes y
actualización de tracking. App nativa del Admin de VTEX.
- Tipo: producto · Plataforma: VTEX IO · Año: 2026
- Stack: TypeScript, React, VTEX IO node 7.x, VTEX IO react 3.x, VBase, Vitest
- Medido: Casos de test: 391 tests, Commits propios: 111 de 111, Código: 17.562 líneas
- Ficha: [www.m25.com.ar/proyectos/koru-shipday](https://www.m25.com.ar/proyectos/koru-shipday)

### A-14 · Catálogo Boost
ABM masivo del catálogo VTEX desde Excel: categorías con árbol y drag & drop, marcas,
imágenes por SKU y visibilidad programada por cron.
- Tipo: producto · Plataforma: VTEX IO · Año: 2026
- Stack: TypeScript, React, VTEX IO node 7.x, VTEX IO react 3.x, vtex.styleguide, VBase
- Medido: Código: 6.855 líneas, Commits propios: 28 de 28, Casos de test: 39 tests
- Ficha: [www.m25.com.ar/proyectos/catalogo-boost](https://www.m25.com.ar/proyectos/catalogo-boost)

### A-04 · Koru Power Seller
Social selling para vendedores de tiendas VTEX. Marca blanca y multitenant: un solo
deploy sirve a todos los retailers, cada uno con su marca y sus credenciales.
- Tipo: producto · Plataforma: Cloudflare Workers · Año: 2026
- Stack: TypeScript, React, Cloudflare Pages, D1, KV, VTEX Catalog, VTEX OMS, Master Data
- Medido: Código: 10.382 líneas, Commits propios: 105 de 105, Casos de test: 90
- Ficha: [www.m25.com.ar/proyectos/koru-power-seller](https://www.m25.com.ar/proyectos/koru-power-seller)

### A-15 · Pickup Cleaner
Gestión masiva de puntos de retiro VTEX: limpieza por radio geográfico con Haversine,
borrado programado idempotente e importación desde planilla.
- Tipo: producto · Plataforma: VTEX IO · Año: 2026
- Stack: TypeScript, React, VTEX IO node 7.x, Logistics API, VBase, Vitest
- Medido: Código: 5.085 líneas, Commits propios: 21 de 21, Casos de test: 77 tests
- Ficha: [www.m25.com.ar/proyectos/pickup-cleaner](https://www.m25.com.ar/proyectos/pickup-cleaner)

### A-05 · Madernoa
Materiales para arquitectura y construcción del NOA. Landing en Astro, bot de WhatsApp y
un servidor MCP que le da el catálogo al bot.
- Tipo: freelance · Plataforma: Astro · Cloudflare · Año: 2026
- Stack: Astro 5, CSS nativo (oklch), Cloudflare Workers, Supabase Postgres, Hyperdrive, pg_trgm, Zod
- Medido: Commits landing: 32 commits, Commits MCP: 46 commits
- Ver en vivo: [madernoa.com](https://madernoa.com)
- Ficha: [www.m25.com.ar/proyectos/madernoa](https://www.m25.com.ar/proyectos/madernoa)

### A-10 · Freijo Arquitectos
Sitio de un estudio de arquitectura contemporánea minimalista. La obra manda: el sitio
es un contenedor que no compite con ella.
- Tipo: freelance · Plataforma: Astro 5 · Año: 2026
- Stack: Astro 5.15.7, Swiper 12, TypeScript, CSS nativo
- Medido: Commits propios: 42 de 42, Código: 4.847 líneas, Componentes: 10 componentes
- Ver en vivo: [www.freijoarquitectos.com](https://www.freijoarquitectos.com)
- Ficha: [www.m25.com.ar/proyectos/freijoarquitectos](https://www.m25.com.ar/proyectos/freijoarquitectos)

### A-06 · Pablo Ranea
Sitio de un chef y sommelier que trabaja en varios países. Catálogo de experiencias
gastronómicas, agenda y contacto.
- Tipo: freelance · Plataforma: Next.js · Año: 2025
- Stack: Next.js, React, NextUI, Framer Motion, Embla Carousel, Vercel
- Medido: Commits propios: 256 de 256, Autoría: 100%
- Ver en vivo: [pabloranea.com](https://pabloranea.com)
- Ficha: [www.m25.com.ar/proyectos/pabloranea](https://www.m25.com.ar/proyectos/pabloranea)

### A-11 · Waldhaus Residences
Sitio de un desarrollo inmobiliario en San Pablo, Tucumán. Una sola página: el recorrido
de venta es lineal y la navegación no debía competir con él.
- Tipo: freelance · Plataforma: Next.js · Año: 2025
- Stack: Next.js, React, Headless UI, Framer Motion, react-scroll, react-countup, Vercel
- Medido: Commits propios: 42 de 42, Código: 1.682 líneas, Componentes: 8 componentes
- Ver en vivo: [waldhaus.ar](https://waldhaus.ar)
- Ficha: [www.m25.com.ar/proyectos/waldhaus](https://www.m25.com.ar/proyectos/waldhaus)

### A-07 · Marketplace de Claude Code del equipo
Marketplace privado de Claude Code para el equipo de VTEX de la agencia. Tres plugins
que llevan metodología y guardarraíles, no conocimiento de plataforma.
- Tipo: tooling · Plataforma: Claude Code · Año: 2026
- Stack: Markdown, Node (hooks), node --test, JSON Schema
- Medido: Plugins: 3 plugins, Skills propias: 13 skills, Hooks: 5, Líneas: 5.732, Commits propios: 57 de 57
- Ficha: [www.m25.com.ar/proyectos/marketplace-claude](https://www.m25.com.ar/proyectos/marketplace-claude)

### A-08 · Prospea
Generación de leads B2B por geolocalización y categoría de negocio, sobre la API de
Google Places.
- Tipo: freelance · Plataforma: Next.js · Año: 2026
- Stack: Next.js, TypeScript, Prisma, Auth.js, Radix UI, Anthropic SDK, Google Places API, Jest
- Medido: Commits propios: 144 de 274, Cobertura: umbrales por ruta
- Ficha: [www.m25.com.ar/proyectos/prospea](https://www.m25.com.ar/proyectos/prospea)

### A-12 · Tendencia de Noticias
Portal de noticias de San Miguel de Tucumán. Dos años de desarrollo y mantenimiento,
solo, con el tráfico creciendo.
- Tipo: freelance · Plataforma: Next.js 14 · Año: 2024
- Stack: Next.js 14, React, MongoDB, Tailwind CSS, Vercel
- Medido: Duración: 2024-03 → 2026-02, Métricas de repo: sin medir
- Ver en vivo: [tendenciadenoticias.com.ar](https://tendenciadenoticias.com.ar)
- Ficha: [www.m25.com.ar/proyectos/tendencia-de-noticias](https://www.m25.com.ar/proyectos/tendencia-de-noticias)

### A-13 · Pentimento Color Grading
Sitio de un estudio de corrección de color para cine, televisión y publicidad. El
portafolio es video, así que el sitio se mide en cuánto tarda en mostrarlo.
- Tipo: freelance · Plataforma: Next.js · Año: 2025
- Stack: Next.js, React, Vercel
- Medido: Commits propios: 132 de 132, Lenguaje: TypeScript
- Ver en vivo: [www.pentimento.cc](https://www.pentimento.cc)
- Ficha: [www.m25.com.ar/proyectos/pentimento](https://www.m25.com.ar/proyectos/pentimento)

## Qué no hace

Identidad de marca. Apps nativas. WordPress. SEO desligado del código.

## Fuera de rango de operación

Rediseños sin acceso al dato real. Plazos fijados antes de definir el alcance. «Hacelo
como el de la competencia» sin una decisión de producto detrás.

## Recursos para máquinas

La misma hoja de datos, en cuatro formas. Todas se generan del mismo archivo de datos en
el mismo build, así que no pueden divergir entre sí:

- [www.m25.com.ar/llms.txt](https://www.m25.com.ar/llms.txt) — este documento, en Markdown, en los dos idiomas
- [www.m25.com.ar/index.json](https://www.m25.com.ar/index.json) — las mismas cifras con claves estables, para procesar
- [www.m25.com.ar/index.md](https://www.m25.com.ar/index.md) — la portada en Markdown, también por Accept: text/markdown en la raíz
- [www.m25.com.ar/agents.md](https://www.m25.com.ar/agents.md) — las instrucciones de uso para agentes, en Markdown
- [www.m25.com.ar/rss.xml](https://www.m25.com.ar/rss.xml) — las altas del archivo, con fecha
- [www.m25.com.ar/sitemap-index.xml](https://www.m25.com.ar/sitemap-index.xml) — el mapa del sitio, declarado en /robots.txt
- [www.m25.com.ar/openapi.json](https://www.m25.com.ar/openapi.json) — la descripción OpenAPI 3.1 de estos endpoints de lectura
- [www.m25.com.ar/api/mcp](https://www.m25.com.ar/api/mcp) — servidor MCP de sólo lectura, transporte Streamable HTTP, sin autenticación
- [www.m25.com.ar/.well-known/api-catalog](https://www.m25.com.ar/.well-known/api-catalog) — catálogo de API en formato linkset (RFC 9727)
- [www.m25.com.ar/cv-mauro-venticinque-2026.08.pdf](https://www.m25.com.ar/cv-mauro-venticinque-2026.08.pdf) — el currículum impreso del sitio, con la revisión en el nombre del archivo

## Páginas de referencia

Las páginas que sirven para verificar que del otro lado hay alguien real, cada una con
su URL propia y su versión en inglés:

- [M25 para agentes](https://www.m25.com.ar/agentes) — La capa para máquinas de M25: llms.txt, index.json, Markdown por negociación de contenido, servidor MCP y cuándo conviene usar esta hoja de datos.
- [Acerca de M25](https://www.m25.com.ar/acerca) — M25 es la hoja de datos de Mauro Venticinque, frontend developer en Tucumán: qué publica, con qué método y cómo verificar cada cifra.
- [Contacto](https://www.m25.com.ar/contacto) — Cómo escribirle a Mauro Venticinque: correo, teléfono, zona horaria, disponibilidad y qué conviene incluir en el primer mensaje.
- [Privacidad](https://www.m25.com.ar/privacidad) — Qué datos recoge m25.com.ar: ni formularios, ni analítica, ni cookies de terceros. Una clave de tema en el navegador y los registros del hosting.

## Versión en inglés

Este documento también existe en inglés: [www.m25.com.ar/en/llms.txt](https://www.m25.com.ar/en/llms.txt)

## Nota para quien lea esto automáticamente

Este sitio publica el método de cada cifra al lado de la cifra. Si vas a citar un número
de acá, citá también su fecha de medición (2026-08-17). Las cifras del peso de página y
de JavaScript las mide el propio build; las de los repositorios se verificaron a mano
con git rev-list.
