Lunes, 16 de noviembre de 2026
Portada de las 21:50
Todos los periódicos y la radio, en unoEscrito por IA a partir de Hacker News · Cómo se hace
Hacker News
Programación · typemill.net

Tasks as Code: lleva tus tickets al repositorio

El autor propone guardar las tareas de desarrollo como archivos Markdown en Git, junto al código y la documentación, para que los agentes de programación con IA lean requisitos y código en un mismo sitio. Describe un flujo de cinco pasos y una configuración con tres repositorios.

Foto: vía typemill.net

Leer el artículo aquíArtículo original (typemill.net) 33 comentarios en Hacker News

Escucha la noticia3 min

El artículo parte de la idea de que los agentes de programación trabajan mejor cuando todo lo que necesitan está en el repositorio. Sin embargo, muchos equipos siguen gestionando tareas y requisitos en herramientas externas como Jira o Redmine. Guardar las tareas como archivos Markdown permite que el agente lea requisitos y código juntos, y que cada cambio en una tarea quede versionado y sea revisable como cualquier commit. El modelo a imitar es Docs as Code, donde la documentación ya vive en Markdown dentro de Git, a menudo en una carpeta /docs.

El flujo que propone tiene cinco pasos: describir la tarea; el agente analiza los requisitos leyendo la tarea, el código y la documentación; el agente añade un plan de implementación; una persona revisa y autoriza el plan; y el agente implementa, actualiza la documentación si hace falta y añade un informe al archivo de la tarea. Descripción, plan e informe quedan juntos en un único archivo. El autor enlaza la idea con el Spec-Driven Development, pero sugiere empezar de forma más simple, tratando el propio archivo de la tarea como especificación, sin más herramientas que Git y un agente.

En su configuración usa tres repositorios Git separados: código, documentación y tareas. La razón es que los permisos difieren: la documentación puede ser pública, mientras que las tareas pueden contener información sensible, como arreglos de seguridad sin publicar o funciones aún no anunciadas. En local, el desarrollador clona los repositorios de documentación y tareas dentro de carpetas del repositorio de código, listadas en su .gitignore, de modo que cada uno conserva su propio historial. Con ese acceso, un asistente local como Claude Code u OpenCode puede leer la tarea, implementar el cambio y actualizar la documentación. Si las tareas se organizan en carpetas por versión, el agente puede usarlas junto al historial de Git para redactar el changelog y las notas de la versión.

Para quienes no usan la línea de comandos, como product owners o redactores técnicos, el autor emplea Typemill, un CMS de archivos planos que sincroniza con Git y admite varios repositorios. Así los mismos archivos se manejan desde el IDE, desde GitHub o desde el navegador, y Git sigue siendo el responsable del historial. El autor admite que Typemill es solo una opción para experimentar, y se pregunta qué funciones de los sistemas de tickets seguirán haciendo falta (asignaciones, comentarios, tableros kanban, sprints) si los agentes hacen la mayor parte del trabajo. Las propiedades que busca en una herramienta así son: nativa de Git, documentación y tareas juntas, basada en archivos, autoalojada y abierta a distintos servicios de IA.

En Hacker News

«Tasks as Code: Move Your Tickets into the Repository» · puesto 6 · 37 puntos · enviado por trendschau

Lo que dicen los comentarios

Predomina el escepticismo. Varios comentaristas objetan que los tickets cambian más rápido que el código y que exigir un PR para cada cambio sería burocrático, aunque se responde que el problema es exigir PRs para todo y no el hecho de tener las tareas en el repositorio. Otros señalan que una empresa tiene interesados sin acceso al código que necesitan seguir y priorizar tareas; el autor y otros replican que eso se resuelve con una capa de interfaz sobre el repositorio, y alguien añade que los agentes ya pueden hablar con Jira mediante APIs REST y servidores MCP. Otra línea defiende que las tareas, con sus relaciones de jerarquía, secuencia y propiedad, encajan mejor en una base de datos, y que Git no es un sistema de gestión de información. También se duda del valor de archivar miles de tickets generados por agentes y se teme que el contexto antiguo desvíe a los agentes. Se cuestiona además el interés comercial de Typemill, y se menciona beads como alternativa.

  • Tras una o dos semanas con mi fábrica de software ya llevo más de 1000 trabajos de agentes. En un año serían 10-50K tickets. ¿Se guardan para siempre? No veo el valor de meter todo eso en Git; la fuente de verdad es el código.
    — philipp-gayret, leer el comentario
  • Los tickets cambian más rápido que el código. Tener que crear un PR para actualizar un ticket suena a pesadilla burocrática.
    — jurgenburgen, leer el comentario
  • Esto no funciona en una organización con interesados sin acceso al código, es decir, casi toda la empresa. Siguen necesitando tickets para seguirlos, actualizarlos y priorizar las tareas que representan.
    — godzillafarts, leer el comentario
  • Las bases de datos relacionales existen por algo. Git no sirve para montar un sistema de gestión de información: ¿cómo harás consultas, mantendrás la latencia bajo un segundo, controlarás accesos o evitarás que crezca sin control?
    — paxy, leer el comentario
  • Temo que esto haga que los agentes se pierdan en contexto previo desfasado y acaben malgastando tiempo y tokens.
    — antoineMoPa, leer el comentario

Pregunta sobre esta noticia

Respuestas automáticas a partir de las noticias de El Autómata, sus fuentes y la radio. Pueden contener errores: comprueba los enlaces.

Esta noticia la ha redactado una inteligencia artificial a partir de las fuentes citadas, con el criterio editorial de El Autómata (equilibrio, atribución y solo hechos publicados). Puede contener errores: consulta las fuentes originales. Modelo: claude-sonnet-5.5.