stepstone

O stepstone é uma ferramenta de CLI que armazena o roadmap de um projeto como um arquivo commitado no próprio repositório. As metas são adicionadas via terminal e gravadas em `.worklist/worklist.json` na raiz do repo, onde podem ser lidas e alteradas tanto por pessoas quanto por agentes de codificação através dos mesmos comandos. É distribuído via npm e pode ser executado sem instalação através de `npx -y stepstone@latest`. Cada Meta de Projeto possui um título, uma descrição opcional, um status e um slug ID gerado a partir do título e congelado posteriormente, para que referências em mensagens de commit ou pull requests sobrevivam a renomeações futuras. Os status são `open`, `active`, `done` e `archived`; no máximo uma meta fica ativa, e o comando `set_active` rebaixa o detentor anterior. Concluir, reabrir, arquivar ou excluir uma meta requer confirmação explícita, fornecida seja por uma flag `--confirm` ou por uma tecla. As arestas de dependência registram quais metas devem ser finalizadas primeiro. O estado de bloqueio é derivado dessas arestas a cada leitura, em vez de ser armazenado. O comando `ready` reporta toda a fronteira paralela, `next` nomeia a primeira meta a ser iniciada e `waves` organiza as metas não finalizadas na camada mais precoce em que cada uma poderia começar, com base nas dependências e não na ordem dos arquivos. Qualquer comando aceita `--json` para um envelope de resultado determinístico voltado a agentes e scripts em vez de prosa. O README descreve um único serviço de aplicação, um lock entre processos e uma substituição de arquivo atômica por trás de cada interface, permitindo que uma chamada de CLI, um terminal board aberto e uma sessão ao vivo compartilhem um repositório sem corromper o arquivo. Pré-condições opcionais, uma revisão de todo o arquivo e o `updatedAt` de uma meta transformam uma leitura obsoleta em um conflito reportado em vez de uma sobrescrita silenciosa. O comando `project ui` abre um terminal board em tela cheia sobre as mesmas metas. Para uso de agentes, uma Agent Skill independente pode ser instalada com a CLI `skills` e ensina ao agente o fluxo de trabalho, invocando a CLI npm conforme necessário. Uma extensão Pi adiciona Session Tasks (uma fila de fragmentos de sessão concretos e cientes de branch, mantida separadamente do roadmap), um dashboard `/tasks` sobre ambas as listas, um widget nomeando a meta ativa e as próximas tarefas não finalizadas, e uma ferramenta `worklist` voltada ao modelo. Checkouts preparados carregam uma meta em um arquivo `STEPSTONE_GOAL.md` ignorado na raiz, para que o trabalho possa ser retomado sem que o Stepstone inicie o harness; o projeto afirma que nenhum código de CLI carregado importa um pacote Pi e que a CI empacota o tarball e executa os binários instalados sem a presença do Pi. A documentação abrange o uso da CLI, o modelo de metas, dependências, despacho e reivindicação de workspace, esquema de armazenamento e migrações, o terminal board, a Agent Skill e a extensão Pi. O projeto foi publicado como `pi-worklist` até a versão 0.17.0 e continua sob o nome atual. Possui licença MIT.