memory-research

Memory Research

外部の対象を調査し、見つかった情報をまとめ、ユーザーの承認を得て、構造化された Basic Memory エンティティを作成します。

ワークフロー

Step 1: Web Research

Basic Memory には Web 検索ツールが含まれていません。このホストにすでに検索ツールがある場合は、それを使用してください。ない場合は、ユーザーが任意の Web 検索ツールまたは MCP サーバーを追加できます。たとえば、Parallel Search MCP を利用できます。検索クエリはそのプロバイダーに送信されるため、プライベートなメモの内容を含めないでください。メモを保存する前には、必ずユーザーに確認してください。

複数の情報源から最新情報を検索します。全体像を把握するため、3〜5件の検索を目安にしてください。

[subject name] site
[subject name] overview
[subject name] news [current year]
[subject name] [relevant domain keywords]

エンティティの種類ごとに収集する情報：

エンティティの種類	主な情報
Organization	事業内容、製品・サービス、段階（スタートアップ／成長期／上場）、資金調達、経営陣、本社、従業員数、注目すべき提携や契約
Person	現在の役職、所属組織、経歴、専門知識、注目すべき実績、公開情報
Technology	機能、メンテナンス担当者、成熟度、エコシステム、代替手段、導入状況
Topic/Domain	定義、現状、主要なプレーヤー、トレンド、ユーザーの状況との関連性

Step 2: Check Existing Knowledge

新しいエンティティを提案する前に、Basic Memory を検索します。

bm_search(query="Acme Corp")
bm_search(query="acme")

名称のバリエーション（正式名称、略称、頭字語、ドメイン名）も試してください。

エンティティがすでに存在する場合：

• Basic Memory で見つかった情報を Web 調査の結果とあわせて報告します
• 新しい情報で既存のメモを更新することを提案します
• bm_edit を使用して、新たな所見を追記するか、古くなった情報を更新します

エンティティが存在しない場合は、評価に進みます。

Step 3: Evaluate and Summarize

調査結果を構造化された要約として提示します。関連する情報をすべて、セクションごとに整理して含めてください。

## [Subject Name]

**Type:** [Organization / Person / Technology / Topic]

**Summary:** [2-4 sentences: what this is, why it matters, key distinguishing facts]

**Key Details:**
- [Organized by what's relevant for the entity type]
- [Stage, funding, leadership for orgs]
- [Role, expertise, affiliations for people]
- [Maturity, ecosystem, alternatives for tech]

**Relevance:** [Why this matters to the user — connection to their work, domain, or interests.
If no obvious connection: "No specific connection identified."]

**Sources:**
- [URLs of key sources consulted]

Evaluation Guidelines

断定を避ける表現を使います。 Web 調査は一時点の情報であり、絶対的な事実ではありません。

• 「〜と思われます」「公開情報に基づくと」「推定」
• 「[日付]時点で」「[情報源]によると」
• 後日、日付で検索したときに見つけられるよう、所見に基準日を付けます （memory-notes を参照）：- [stage] @valid:2026-10 Series B, about 200 employees (public information)
• 資金調達額、従業員数、売上高は、一次情報を引用しない限り、正確な数値として記載しないでください

情報を捏造しないでください。 情報が得られない場合は、その旨を伝えます。

• 「経営陣に関する情報は公開されていません」
• 「資金調達の詳細は公開されていません」

関連性はユーザーに判断してもらいます。 固定の評価基準を押し付けず、事実を提示して、ユーザー自身が結論を導けるようにします。ユーザーが特定の評価基準（戦略的適合性、購入／提携／競合など）を持っている場合は、ユーザーから指示があります。求められた際に適用してください。

Step 4: Propose Entity Creation

要約を提示した後、承認を求めます。

Create Basic Memory entity for [Subject]?
  Location: [suggested-folder]/[entity-name].md
  Type: [entity type]

  [yes / no / modify]

ユーザーがリクエスト時に背景情報（「カンファレンスで見かけた」など）を提供している場合は、その情報を作成予定のエンティティに含めてください。

Step 5: Create the Entity

承認を得た後、構造化されたメモを作成します。エンティティの種類に合わせてテンプレートを調整してください。

Organization

bm_write(
  title="Acme Corp",
  directory="organizations",
  note_type="organization",
  tags=["organization", "relevant-tags"],
  content="""# Acme Corp

## Overview
[2-3 sentence description from research]

## Products & Services
- [Key offerings discovered in research]

## Background
**Stage:** [Startup / Growth / Public]
**Headquarters:** [Location]
**Employees:** [Estimate, hedged]
**Leadership:** [Key people if found]
**Founded:** [Year if found]

## Observations
- [relevance] Why this entity matters in user's context
- [source] Researched on YYYY-MM-DD
- [additional observations from research findings]

## Relations
- [Link to related entities already in the knowledge graph]"""
)

Person

bm_write(
  title="Jane Smith",
  directory="people",
  note_type="person",
  tags=["person", "relevant-tags"],
  content="""# Jane Smith

## Overview
[Current role and affiliation. Brief background.]

## Background
**Role:** [Title at Organization]
**Expertise:** [Key domains]
**Notable:** [Publications, talks, projects if found]

## Observations
- [role] Title at Organization
- [expertise] Key technical or domain expertise
- [source] Researched on YYYY-MM-DD

## Relations
- works_at [[Organization]]"""
)

Technology

bm_write(
  title="Technology Name",
  directory="concepts",
  note_type="concept",
  tags=["concept", "technology", "relevant-tags"],
  content="""# Technology Name

## Overview
[What it is and what problem it solves]

## Key Details
**Maintained by:** [Organization or community]
**Maturity:** [Experimental / Stable / Mature]
**License:** [If applicable]
**Alternatives:** [Comparable tools or approaches]

## Observations
- [definition] What this technology does in one sentence
- [maturity] Current state and adoption level
- [source] Researched on YYYY-MM-DD

## Relations
- [Link to related concepts, tools, or projects in the knowledge graph]"""
)

テンプレートは自由に調整してください。重要な要素は、note_type/tags パラメーター、概要、構造化された詳細、カテゴリ別の所見、関連情報です。

bm_write が類似する既存のメモを報告した場合は、新しいメモを残す前に、その中に同じエンティティがないか確認してください。重複させず、統合するかリンクしてください。

Step 6: Store Source Context

ユーザーがリクエスト時に背景情報を提供している場合は、その情報をエンティティに記録します。

# User said: "Acme Corp — saw their demo at the conference last week"
bm_edit(
  identifier="Acme Corp",
  command="insert_after_section",
  section="Observations",
  content="- [context] Saw their demo at conference, week of 2026-02-17"
)

この背景情報は、多くの場合、最も価値のある情報です。Web 調査では得られない、ユーザーとエンティティとの関係を示すものだからです。

ガイドライン

• 必ずウェブ検索してください。 学習データだけに頼らないでください。調査には、最新かつ検証可能な情報を反映してください。
• まず Basic Memory を検索してください。 新しいエンティティを作成する前に、既存のエンティティを確認してください。重複して作成するのではなく、更新してください。
• 不確かな情報には留保を付けてください。 推定、未検証の主張、推測した詳細には、条件を付けてください。
• 情報源の URL を保存してください。 ユーザーが確認し、さらに詳しく調べられるよう、参照した URL を観察事項または「情報源」セクションに記載してください。
• 作成前に承認を得てください。 調査結果を提示し、エンティティを作成するか、何を含めるかをユーザーに判断してもらってください。
• ユーザーの背景情報を記録してください。 ユーザーが調査の理由（会議で知り合った、ベンダーとして評価しているなど）を伝えた場合、その背景をエンティティに含めてください。
• 調査しすぎないでください。 通常は 3～5 回のウェブ検索で十分です。目標は、網羅的なレポートではなく、有用なナレッジグラフのエントリーを作成することです。
• 既存の知識とリンクしてください。 新しいエンティティを、ナレッジグラフにすでにある情報と関連付けてください。つながりが増えるほど、価値が高まります。