| name | research |
| description | Web research that feeds the MindGraf knowledge graph. Use when the user asks to "research X", "look up Y", "summarize this URL", "deep dive on Z", "what do we know about", "enrich this entity", or wants to find and capture external information.
|
Research Skill
Research $ARGUMENTS and convert findings into linked, source-attributed graph updates.
Invocation
do shell script "export MINDGRAF_PATH=${user_config.mindgraf_path} && ${user_config.mindgraf_path}/apps/cli/bin/brain <command> 2>&1"
Non-Negotiable Rules
- Graph first: always
brain search before creating.
- Synthesis only: never copy source text verbatim.
- Source attribution: every claim maps to sources.
- Write gate: present planned mutations, get approval before writing.
- Use
--json when parsing output.
Entity Mapping
- Concepts/theories ->
note (tag concept)
- People ->
person
- Companies ->
organization
- Products/platforms ->
tool
- Articles/papers/videos ->
resource
- Tradeoff choices ->
decision
Workflows
Quick Research
Trigger: "research X", "look up Y"
brain search "<topic>" --json — check graph- Web search 2-4 angles, fetch top sources
- Present planned creates/updates/links -> get approval
- Execute approved writes
- Report entity refs + source summary
Deep Research
Trigger: "deep dive", "investigate"
- Plan scope, subtopics, source strategy -> get approval
- Per subtopic: fetch, extract, map to entities
- Present mutations -> get approval
- Execute, create synthesis note if needed
- Final report
Summarize URL
Trigger: "summarize URL", "capture URL", "save URL"
- Fetch URL, extract metadata
brain search "<url>" --type resource --json for dedup- Plan -> approve -> create/update resource with synthesis
Enrich Existing Entity
Trigger: "research more about [[X]]"
brain read "<ref>" --json — identify gaps- Gather targeted sources
brain edit "<ref>" --append "<block>" after approval
Output Contract
- Summary — 3-6 bullet synthesis
- Key Facts — with source markers [S1]
- Open Questions
- Sources — numbered with URL and date
Definition of Done
- Dedupe performed, source attribution present, writes approved, links/tags applied
