tracker local en markdown

Tareas que viajan en tu repositorio.

Un tracker de tareas en archivos Markdown dentro de tu proyecto, pensado para que personas y agentes de programación se pasen el trabajo sin perder contexto, sin bases de datos y sin servicios externos. Cada tarea vive en su propia carpeta bajo tareas/ y Git guarda la historia.

Recorrido completo Para agentes

uv tool install oracle-task==0.2.0 Corte preparado para PyPI · Python 3.11+ · alias tasks · MIT

terminal · tasks bash

$ tasks list
20260927-182033-web    ABIERTA P80 []       La web de Oracle Task
20260911-180000-sensor ABIERTA P70 [sensor] Investigar defecto en sensor

$ tasks show web
ID:        20260927-182033-web
Título:    La web de Oracle Task
Estado:    ABIERTA
Prioridad: 80
Ruta:      tareas/20260927-182033-web/TAREA.md

en marcha

Recorrido de 60 segundos

Seis comandos esenciales para inicializar, crear, documentar, listar, inspeccionar y cerrar tareas, con salidas reales.

Inicializar el repositorio

Crea el directorio tareas/ con su archivo explicativo README.md.

tasks init

$ tasks init
Tracker de tareas inicializado en ./tareas

Crear una tarea

Crea una nueva carpeta con su plantilla TAREA.md, metadatos y sufijo determinista.

tasks new

$ tasks new "Investigar defecto en sensor" --etiqueta sensor --prioridad 70 --sufijo sensor
Tarea creada: 20260927-120000-sensor
Ruta: ./tareas/20260927-120000-sensor/TAREA.md

Asentar una nota de avance

Agrega notas de progreso fechadas en UTC de forma atómica en el cuerpo de la tarea.

tasks note

$ tasks note sensor "Medición preliminar en banco de pruebas"
Nota agregada a la tarea 20260927-120000-sensor
Documento: ./tareas/20260927-120000-sensor/TAREA.md

Listar tareas abiertas

Muestra las tareas con su ID, estado, prioridad y etiquetas, ordenadas dinámicamente.

tasks list

$ tasks list
20260927-120000-sensor ABIERTA P70 [sensor] Investigar defecto en sensor

Inspeccionar el contexto completo

Lee el estado, metadatos y todas las notas acumuladas para retomar el trabajo sin fricción.

tasks show

$ tasks show sensor
ID:        20260927-120000-sensor
Título:    Investigar defecto en sensor
Estado:    ABIERTA
Prioridad: 70
Etiquetas: sensor
Ruta:      ./tareas/20260927-120000-sensor/TAREA.md

(sin descripción adicional)

Cerrar la tarea

Actualiza el estado a CERRADA mediante reemplazo atómico, preservando el resto del archivo.

tasks close

$ tasks close sensor
Tarea cerrada: 20260927-120000-sensor

arquitectura

Diseñado para la colaboración real

Markdown La tarea es la verdad

Sin servicios en la nube ni bases de datos desconectadas. Clonás el repositorio y tenés todas las tareas, sus notas y sus adjuntos locales listos para leer con cualquier editor.

Relevo Entre personas y agentes

El contexto no se pierde cuando se reinicia una sesión de chat o se llena la ventana de un modelo. El agente lee tasks show y antes de terminar deja anotado el próximo paso con tasks note.

Git Auditoría y trazabilidad

Los commits nombran la tarea (<ID>: …) y tasks follow audita la cobertura. Además, tasks facts emite evidencia estructurada para validar contra políticas de Oracle.

documentación

Por dónde seguir

paso a paso Guía completa Recorrido con consultas TQL, adjuntos locales, referencias cruzadas y grafo en DOT. agentes Para agentes El protocolo de relevo entre sesiones, ejemplo de AGENTS.md y convención de commits. auditoría Con Oracle Exportación con tasks facts y evaluación contra el catálogo de seguimiento-tareas. cli Referencia de comandos Todos los verbos canónicos, sus opciones detalladas y sus alias en español.