セッションとメモリ

q がワークスペース実行間で保存、圧縮、学習、復元するものを理解します。

Markdown を表示

永続セッション

各ワークスペースは .q/sessions/ の下に複数の UUID ベースのセッションを保存できます。起動時の選択画面にはタイトルと最近の活動が表示されます。

一つのプロセスが選択中のセッションを所有します。別の q プロセスは同じワークスペースの異なるセッションを開けますが、セッションロックはリポジトリファイルの編集を直列化しません。

q は表示される会話全文とモデルへ送る圧縮コンテキストを別々に保存します。コンテキストメタデータがあれば、ユーザーに見える記録を保ちながらモデル入力を短くできます。

主要なセッションレコードは次の場所です。

text

.q/sessions/<uuid>/session.json

承認済みの計画実行は同じ場所に再開可能な plan-execution.json を追加します。

Workspace Memory は永続メッセージ、ツール活動、失敗、ライフサイクルイベント、検索インデックスを保存します。すべての過去を一つのチャットコンテキストに載せずに検索できます。

大きなツール結果は不変の Loom アーティファクトになります。プロンプトには上限付きの参照情報が届き、モデルは後から必要な部分だけ確認できます。

成功したターンの後、Thinker は確立したワークフロー、永続的なプロジェクト事実、再利用可能な解決方法、将来の作業に影響する根拠ある発見を proposition として抽出できます。

Librarian は proposition を作成、統合、破棄するか判断します。/learn off は収集とキュー処理を止めますが、すでにキューにあるデータは削除しません。

実行ごとのビルド、テスト、フォーマット、監査の結果は永続的なプロジェクト事実ではなくタスク履歴に残します。