Об этом проекте

stepstone — это CLI-инструмент, который хранит дорожную карту проекта в виде зафиксированного файла в самом репозитории. Цели добавляются из терминала и записываются в `.worklist/worklist.json` в корне репозитория, где они могут считываться и изменяться как людьми, так и кодинг-агентами с помощью одних и тех же команд. Инструмент распространяется через npm и может быть запущен без установки с помощью `npx -y stepstone@latest`. Каждая цель проекта (Project Goal) имеет заголовок, необязательное описание, статус и slug ID, создаваемый на основе заголовка и фиксируемый впоследствии, чтобы ссылки в сообщениях коммитов или pull-запросах сохранялись после переименований. Статусы включают `open`, `active`, `done` и `archived`; активной может быть только одна цель, и команда `set_active` понижает статус предыдущего владельца. Завершение, повторное открытие, архивация или удаление цели требуют явного подтверждения через флаг `--confirm` или нажатие клавиши. Ребра зависимостей фиксируют, какие цели должны быть реализованы первыми. Состояние блокировки вычисляется на основе этих ребер при каждом чтении, а не хранится статически. Команда `ready` сообщает о всем параллельном фронте работ, `next` называет первую цель для начала, а `waves` распределяет незавершенные цели по earliest layer (самым ранним слоям), в которых они могут быть начаты, основываясь на зависимостях, а не на порядке файлов. Любая команда принимает флаг `--json` для получения детерминированного результата, предназначенного для агентов и скриптов вместо обычного текста. В README описываются единый сервис приложения, один межпроцессный замок (lock) и одна атомарная замена файла за каждым интерфейсом, что позволяет вызову CLI, открытой терминальной доске и живой сессии совместно использовать репозиторий без повреждения файла. Необязательные предварительные условия, ревизия всего файла и `updatedAt` цели превращают устаревшее чтение в сообщаемый конфликт вместо тихого перезаписывания. Команда `project ui` открывает полноэкранную терминальную доску для управления теми же целями. Для использования агентами может быть установлен автономный Agent Skill с помощью CLI `skills`, который обучает агента рабочему процессу, вызывая npm CLI по мере необходимости. Расширение Pi добавляет Session Tasks (очередь конкретных фрагментов сессии с учетом веток, хранящуюся отдельно от дорожной карты), панель `/tasks` для обоих списков, виджет с указанием активной цели и следующих незавершенных задач, а также инструмент `worklist` для модели. Подготовленные чекауты содержат цель в игнорируемом корневом файле `STEPSTONE_GOAL.md`, чтобы работа могла быть продолжена без запуска обвязки Stepstone; в проекте указано, что загруженный код CLI не импортирует пакет Pi, а CI упаковывает tarball и запускает установленные бинарные файлы без присутствия Pi. Документация охватывает использование CLI, модель целей, зависимости, диспетчеризацию и захват рабочего пространства, схему хранения и миграции, терминальную доску, Agent Skill и расширение Pi. Проект публиковался под названием `pi-worklist` до версии 0.17.0 и продолжает развиваться под текущим именем. Лицензия MIT.