stepstone

stepstone es una herramienta de CLI que almacena la hoja de ruta de un proyecto como un archivo integrado en el propio repositorio. Los objetivos se añaden desde la terminal y se escriben en `.worklist/worklist.json` en la raíz del repositorio, donde pueden ser leídos y modificados tanto por personas como por agentes de codificación a través de los mismos comandos. Se distribuye en npm y puede ejecutarse sin instalación mediante `npx -y stepstone@latest`. Cada Objetivo de Proyecto tiene un título, una descripción opcional, un estado y un ID slug generado a partir del título y congelado posteriormente, para que las referencias en los mensajes de commit o pull requests sobrevivan a renombramientos posteriores. Los estados son `open`, `active`, `done` y `archived`; como máximo un objetivo está activo, y `set_active` degrada al poseedor anterior. Completar, reabrir, archivar o eliminar un objetivo requiere una confirmación explícita, proporcionada ya sea mediante un flag `--confirm` o una pulsación de tecla. Las aristas de dependencia registran qué objetivos deben implementarse primero. El estado de bloqueo se deriva de esas aristas en cada lectura en lugar de almacenarse. El comando `ready` informa de todo el frente paralelo, `next` nombra el primer objetivo a iniciar y `waves` organiza los objetivos no finalizados en la capa más temprana en la que cada uno podría comenzar, basándose en las dependencias en lugar del orden de los archivos. Cualquier comando acepta `--json` para un resultado determinista orientado a agentes y scripts en lugar de prosa. El README describe un único servicio de aplicación, un bloqueo entre procesos y un reemplazo de archivo atómico detrás de cada interfaz, de modo que una llamada a la CLI, un tablero de terminal abierto y una sesión en vivo pueden compartir un repositorio sin corromper el archivo. Las precondiciones opcionales, una revisión de todo el archivo y el `updatedAt` de un objetivo convierten una lectura obsoleta en un conflicto reportado en lugar de una sobrescritura silenciosa. `project ui` abre un tablero de terminal a pantalla completa sobre los mismos objetivos. Para el uso de agentes, se puede instalar un Agent Skill independiente con la CLI `skills` que enseña al agente el flujo de trabajo, invocando la CLI de npm según sea necesario. Una extensión de Pi añade Session Tasks (una cola de fragmentos de sesión concretos conscientes de la rama, mantenida separada de la hoja de ruta), un tablero `/tasks` sobre ambas listas, un widget que nombra el objetivo activo y las próximas tareas no finalizadas, y una herramienta `worklist` orientada al modelo. Los checkouts preparados llevan un objetivo en un archivo `STEPSTONE_GOAL.md` ignorado en la raíz, para que el trabajo pueda retomarse sin que Stepstone lance el arnés; el proyecto establece que ningún código de la CLI cargada importa un paquete de Pi y que la CI empaqueta el tarball y ejecuta los binarios instalados sin que Pi esté presente. La documentación cubre el uso de la CLI, el modelo de objetivos, las dependencias, el despacho y la reclamación del espacio de trabajo, el esquema de almacenamiento y las migraciones, el tablero de terminal, el Agent Skill y la extensión de Pi. El proyecto fue publicado como `pi-worklist` hasta la versión 0.17.0 y continúa bajo el nombre actual. Tiene licencia MIT.