mcpField
B
braindump

braindump

github.com/mohganjiエージェントワークフロー437 回インストール37 週間前に更新
リポジトリ

braindump について

braindump は、会話をまたいで使えるローカルの検索可能なメモを保存するスキルです。長期的に役立つプロジェクト情報を記録し、関連タスクの前に検索するようエージェントを導きます。

主な機能

  1. 01タイトルとタグ付きのメモ保存
  2. 02メモの検索、一覧表示、取得
  3. 03カテゴリ別のメモ整理
  4. 04プログラム利用向けの JSON 出力
  5. 05ローカル Markdown ファイルへの保存

活用シーン

  1. 01連携機能の実装前に API 情報を確認
  2. 02プロジェクトの決定と理由を記録
  3. 03後のタスクでユーザーの好みを取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mohganji/braindump --skill braindump

インストール後、Claude Code で/braindumpを入力して読み込まれたか確認します。

同梱ファイルscripts/install.sh

詳細

braindump - エージェントメモリ

会話をまたいで保持される、ローカルで検索可能なメモです。現在のセッション終了後も残る長期メモリとして、文脈情報を目立たない形で記録します。

手動でのトリガー：

  • 「use your brain」 または 「remember anything about...」 — タスクを実行する前に、関連する文脈を braindump で検索します
  • 「braindump this」 または 「save this to memory」 — 現在の文脈や情報を、後で取得できるよう保存します

セットアップ

初めて使う前に、CLI がインストールされていることを確認してください。braindump が PATH 上に見つからない場合は、インストールしてください：

curl -fsSL https://raw.githubusercontent.com/MohGanji/braindump/main/install.sh | bash

または、同梱のインストーラーを実行してください：

bash "SKILL_DIR/scripts/install.sh"

インストール後、braindump --version で確認してください。

コマンド

# Save
braindump add <category> --title "..." --content "..." --tags "tag1,tag2"

# Retrieve
braindump search "query"
braindump list [category]
braindump get <category> "pattern"

# Manage
braindump update <id> --content "..."
braindump append <id> --content "additional info"
braindump delete <id>
braindump categories
braindump tags

プログラムから使う場合は --format json を追加してください。

自律的な動作

保存するタイミング（先回り）

会話が終了すると失われる情報を記録します：

  • ビジネス要件、ユースケース、ユーザーストーリー
  • 役立つ URL と変数（API ドキュメント、エンドポイント、環境設定）
  • API 仕様、フィールドマッピング、データ変換
  • システムの制約、前提、除外事項
  • インテグレーション固有の動作、癖、注意点
  • ドメイン用語、別名、略語
  • 根拠を伴う技術的な決定
  • 既知の問題、制限事項、回避策
  • 設定要件、しきい値、デフォルト値
  • ユーザーの好みやプロジェクトの規約
  • ユーザーが共有した外部の文脈（仕様、ドキュメント）
  • 解決済みのバグとその解決策
取得するタイミング（先回り）

過去の文脈が役立つ可能性のあるタスクを開始する際に、braindump を検索します：

  • 以前に話し合った分野の機能を実装する前
  • ユーザーが過去の会話で話した内容に言及したとき
  • 以前に記録した API、インテグレーション、システムを扱うとき
  • 過去に記録された根拠がある可能性のあるアーキテクチャ上の決定を行う前
ワークフロー
  1. 保存する前に：まず既存の内容を検索します。見つかった場合は更新または追記し、見つからなければ新しいメモを追加します
  2. 作業する前に：現在のタスクに役立つ可能性のある関連情報を検索します
  3. 可能な場合は、関連情報を既存のカテゴリやタイトルの下にまとめます
  4. 新しい情報と矛盾しない限り、既存の内容を保持します
  5. 会話の記録ではなく、長期的に役立つ知識に重点を置きます

カテゴリと構成

カテゴリは、インテグレーション、システム機能、独立したモジュール、論理的な境界など、まとまりのある分野を表します。文脈に基づいて直感的にカテゴリを選び、適切な既存カテゴリがあればそれを使い、必要に応じて新しいカテゴリを作成します。

タイトルには、文脈を効果的に絞り込める検索キーワードを使います。

内容は、簡潔で情報密度の高い段落にします。リストには箇条書きを使います。動作を明確にする場合に限り、コード例を含めます。

記録しないもの

  • 一時的なデバッグ作業や一過性の状態
  • 文脈を伴わないファイルパスやコードスニペット
  • ドキュメントで確認できる一般的なプログラミング知識
  • 会話そのものについてのメタコメント
  • 頻繁に変化し、長期的な価値のない情報

ストレージ

~/.braindump/ — YAML フロントマター付きのプレーンテキストの Markdown ファイルです。各カテゴリはディレクトリとして保存されます。高速検索には FTS5 の SQLite インデックスを使用します。

コメント

Markdown 対応