Repo Tokens: el nuevo badge que mide si tu código cabe en la mente de una IA

La revolución de los agentes de código impulsados por inteligencia artificial está transformando la forma en que los desarrolladores piensan sobre la arquitectura de sus proyectos. Ya no se trata solo de optimizar la velocidad de ejecución o reducir el tamaño del bundle: ahora hay un nuevo parámetro crítico que determina la eficiencia de estos sistemas: el tamaño del código medido en tokens. Repo Tokens es una acción de GitHub que automatiza la medición del volumen de un repositorio en tokens, utilizando la librería tiktoken de OpenAI, y actualiza un badge visual en el archivo README del proyecto. Este indicador, similar a los badges de tamaño de bundle que llevan años siendo estándar en librerías JavaScript, refleja qué porcentaje de la ventana de contexto de un modelo de lenguaje ocupa el código completo del proyecto. El sistema de colores es intuitivo: verde cuando el código ocupa menos del 30% de la ventana de contexto, amarillo entre el 50 y 70%, y rojo cuando supera el 70%. La ventana de contexto es configurable, aunque por defecto utiliza 200.000 tokens, correspondiéndose con la capacidad de modelos como Claude de Anthropic. La implementación es elegante en su simplicidad. Se trata de una acción compuesta que instala tiktoken, ejecuta aproximadamente 60 líneas de código Python inline, y completa su tarea en alrededor de 10 segundos. Un aspecto importante es que la acción actualiza el README sin hacer commit automático, permitiendo que sea el flujo de trabajo del desarrollador quien controle la estrategia de versionado. Esta innovación refleja un cambio paradigmático en el desarrollo de software moderno. Durante años, el objetivo ha sido crear código eficiente y modular. Pero con la llegada de agentes de IA capaces de analizar y modificar código de manera autónoma, mantener codebases compactas se ha convertido en una ventaja competitiva tangible. Un agente que puede procesar el código completo de un proyecto en un único contexto puede tomar decisiones mejor informadas, evitar inconsistencias y realizar cambios más coherentes. La propuesta de hacer visible esta métrica mediante un badge busca incentivar una cultura de desarrollo más consciente del tamaño de los proyectos. Así como los developers de librerías JavaScript celebran mantener sus bundles por debajo de ciertos umbrales, los creadores de herramientas y frameworks podrían empezar a optimizar deliberadamente para que sus codebases sean "agent-friendly". Esta tendencia podría tener implicaciones profundas en cómo estructuramos los proyectos software. Los equipos podrían dividir monolitos no solo por razones arquitectónicas tradicionales, sino porque un microservicio pequeño es más manejable para un agente de IA. Los estándares de código podrían evolucionar para priorizar no solo la legibilidad humana, sino también la digestibilidad por parte de modelos de lenguaje. El proyecto ha generado interés en la comunidad de desarrolladores, acumulando 79 puntos en Hacker News con 40 comentarios que exploran las implicaciones de esta métrica. Algunos ven en ello una herramienta valiosa para mantener proyectos mantenibles en la era de los agentes de IA, mientras que otros plantean preguntas sobre si optimizar para caber en una ventana de contexto podría fomentar una fragmentación excesiva del código.