このプロジェクトについて

stepstoneは、プロジェクトのロードマップをリポジトリ内のコミット済みファイルとして保存するCLIツールです。ゴールはターミナルから追加され、リポジトリルートの`.worklist/worklist.json`に書き込まれます。これにより、人間とコーディングエージェントの両方が同じコマンドを通じて内容を読み書きできます。npmで配布されており、`npx -y stepstone@latest`を使用してインストールなしで実行可能です。 各プロジェクトゴールには、タイトル、任意の詳細説明、ステータス、およびタイトルから生成され以降固定されるスラッグIDが付与されます。これにより、コミットメッセージやプルリクエスト内の参照は、後のリネーム後も維持されます。ステータスには`open`、`active`、`done`、`archived`があり、アクティブなゴールは最大で1つのみです。`set_active`を実行すると、以前のアクティブなゴールは降格されます。ゴールの完了、再開、アーカイブ、または削除には、`--confirm`フラグまたはキーストロークによる明示的な確認が必要です。 依存関係のエッジにより、どのゴールを先に完了させるべきかが記録されます。ブロック状態は保存されるのではなく、読み取り時にこれらのエッジから導出されます。`ready`コマンドは並列的に着手可能な全フロンティアを報告し、`next`は最初に着手すべきゴールを提示し、`waves`は未完了のゴールをファイル順ではなく依存関係に基づいた最短のレイヤー順に表示します。すべてのコマンドは`--json`フラグを受け取り、散文ではなくエージェントやスクリプト向けの決定論的な結果エンベロープを返します。 READMEによると、すべてのインターフェースの背後には単一のアプリケーションサービス、プロセス間ロック、およびアトミックなファイル置換が実装されており、CLI呼び出し、オープンなターミナルボード、ライブセッションがファイルを破損させることなくリポジトリを共有できます。オプションの前置条件、ファイル全体のリビジョン、およびゴールの`updatedAt`により、古い読み取りによるサイレントな上書きではなく、競合として報告されます。`project ui`を実行すると、同じゴールを管理するフルスクリーンのターミナルボードが開きます。 エージェントでの利用向けに、`skills` CLIでインストール可能なスタンドアロンのAgent Skillが提供されており、必要に応じてnpm CLIを呼び出すワークフローをエージェントに学習させます。Pi拡張機能は、セッションタスク(ロードマップとは別に管理される、ブランチを意識した具体的なセッションチャンクのキュー)、両方のリストを管理する`/tasks`ダッシュボード、アクティブなゴールと次の未完了タスクを表示するウィジェット、およびモデル向け`worklist`ツールを追加します。準備済みのチェックアウトには、無視設定されたルートの`STEPSTONE_GOAL.md`にゴールが含まれているため、Stepstoneがハーネスを起動することなく作業を再開できます。プロジェクト側は、ロードされたCLIコードはPiパッケージをインポートせず、CIがtarballをパックし、Piが存在しない状態でインストール済みバイナリを駆動することを明記しています。 ドキュメントには、CLIの使用法、ゴールモデル、依存関係、ディスパッチとワークスペースの占有、ストレージスキーマとマイグレーション、ターミナルボード、Agent Skill、およびPi拡張機能について記載されています。本プロジェクトはバージョン0.17.0まで`pi-worklist`として公開されており、現在は現在の名称で継続されています。ライセンスはMITライセンスです。