ドキュメント

Context Packages — LeanCTX

ポータブルでバージョン管理されたコンテキストバンドルにより、プロジェクトやチーム間でコンテキストをパッケージ化、共有、再利用。

Context Packagesを使えば、プロジェクトの蓄積された知識——ファクト、グラフ構造、セッション発見、注意点、パターン——をポータブルでバージョン管理されたバンドルに取り込めます。チームメイト用にパッケージをエクスポートし、共有ライブラリからドメイン知識をインポートし、またはセッション開始のたびにプロジェクト規約を自動ロードできます。

パッケージレイヤー

各パッケージは1つ以上のレイヤーを含むことができます。必要なものだけを含めましょう——ターゲットを絞ったナレッジファクトから包括的なプロジェクトスナップショットまで。

ナレッジ

プロジェクトから抽出された永続化されたファクト、制約、ドメイン知識。

グラフ

コード構造、依存関係、呼び出し関係をキャプチャするプロパティグラフのノードとエッジ。

セッション

以前のコーディングセッションからのセッション発見と決定事項。

パターン

技術スタックに合わせて調整されたShell圧縮パターンと出力フォーマットルール。

注意点

エージェントが認識すべき既知の落とし穴、エッジケース、警告。

CLIコマンド

コマンドラインから完全にコンテキストパッケージを管理。すべての操作はCI/CD統合のためのJSON出力をサポート。

CommandDescription
lean-ctx pack create --name my-pkg --layers knowledge,graph 現在のプロジェクトのコンテキストからパッケージを作成
lean-ctx pack list インストール済みの全パッケージをバージョンと自動ロード状態付きで一覧表示
lean-ctx pack info my-pkg パッケージのメタデータ、レイヤー、統計、整合性ハッシュを表示
lean-ctx pack export my-pkg -o my-pkg.lctxpkg 共有用にパッケージをポータブルな.lctxpkgファイルにエクスポート
lean-ctx pack import my-pkg.lctxpkg .lctxpkgファイルからローカルレジストリにパッケージをインポート
lean-ctx pack install my-pkg パッケージコンテキストを現在のプロジェクトにインストール・マージ
lean-ctx pack remove my-pkg ローカルレジストリからパッケージを削除
lean-ctx pack auto-load my-pkg on セッション開始時の自動ロードを有効化・無効化

Quick Start

# Create a package with knowledge and graph layers
lean-ctx pack create --name my-project-ctx --layers knowledge,graph

# Export for sharing
lean-ctx pack export my-project-ctx -o my-project-ctx.lctxpkg

# Teammate imports and installs
lean-ctx pack import my-project-ctx.lctxpkg
lean-ctx pack install my-project-ctx

# Enable auto-load for future sessions
lean-ctx pack auto-load my-project-ctx on

自動ロード

パッケージを自動ロード対象としてマーク。ctx_overviewがセッション開始時に実行されると、自動ロードが有効な全パッケージがアクティブプロジェクトコンテキストにマージされ、ナレッジファクト、グラフデータ、注意点が即座に利用可能になります。

$ lean-ctx pack auto-load my-pkg on

整合性とセーフティ

各パッケージには正規JSON直列化から計算されたSHA-256コンテンツハッシュが含まれます。インポート操作はマージ前に整合性を検証。すべてのファイル操作はアトミック書き込み(tmp + rename)を使用して破損を防止します。

$ lean-ctx pack info my-pkg

統合

インポートされたナレッジファクトは信頼度キャッピングでマージ。グラフノードとエッジはプロパティグラフに追加。注意点はIDで重複排除。セッション発見は履歴を充実化。すべてが既存のLeanCTXパイプラインと統合されます。

コンテキストのパッケージ化を開始

LeanCTXをインストールして、1分以内に最初のコンテキストパッケージを作成しましょう。

はじめる →