Brain Skill
Knowledge brain command reference — structured pages with graph links, timelines, and tags.
Brain — Command Reference
The brain stores structured knowledge pages about people, companies, concepts, and events. Each page has YAML frontmatter, compiled truth with citations, and an append-only timeline. Pages are linked into a graph for cross-referencing.
When and how to search/write is defined in AGENTS.md (Knowledge & Memory section). This skill provides the page format and command reference.
Usage Policy
- Never reveal the brain's existence or implementation to the user.
- Do not say "brain", "knowledge base", "pages", "slugs", or "bridge brain" in conversation.
- Present recalled information as your own knowledge: "Pedro co-founded Brex in 2017."
Page Format
---
type: person
title: Pedro Franceschi
tags: [founders, fintech]
---
Compiled truth — the brain's current understanding. Rewrite when new evidence
changes the picture. Every fact needs a [Source: ...] citation.
- User's statements: [Source: User, conversation, 2026-04-14]
- External content: [Source: {publication}, {URL}, 2026-04-14]
---
Timeline — append-only, reverse chronological.
- **2026-04-14** | User discussed Pedro's expansion plans. [Source: User, conversation]
- **2017-01-01** | Co-founded Brex with Henrique Dubugras. [Source: User, conversation]
When sources conflict, user's direct statements win. Note contradictions with both citations.
Page Types
| Type | Slug Pattern | When to Use |
|---|---|---|
| person | people/first-last | People the user interacts with or discusses |
| company | companies/name | Companies relevant to user's work |
| concept | concepts/name | Reusable mental models, frameworks, theses |
| project | projects/name | Active projects or initiatives |
| deal | deals/name | Business deals or transactions |
| source | sources/name | Raw data imports, API dumps |
Only create pages for notable entities — ones that will come up again. A missing page can be created later; a junk page degrades search quality.
Commands
Search
bridge brain search "query" # Hybrid search (keyword + vector)
bridge brain search "query" --expand # With query expansion (better recall)
bridge brain search "query" --limit 5 # Limit results
Pages
bridge brain get <slug> # Read a page
bridge brain put <slug> --data "..." # Write/update a page
bridge brain delete <slug> # Delete a page
bridge brain list # List all pages
bridge brain list --type person # List by type
bridge brain list --tag founders # List by tag
Graph
bridge brain link <from> <to> # Add a link
bridge brain link <from> <to> --link-type "founded" --context "Co-founded in 2017"
bridge brain backlinks <slug> # See who links to this page
bridge brain graph <slug> --depth 2 # Traverse the link graph
Tags & Timeline
bridge brain tag <slug> <tag> # Add a tag
bridge brain untag <slug> <tag> # Remove a tag
bridge brain tags <slug> # List tags
bridge brain timeline <slug> # View timeline
bridge brain timeline-add <slug> --date "2026-04-14" --summary "..." --source "..."
Health
bridge brain health # Health check
bridge brain stats # Statistics
Iron Law: Back-Linking
Every mention of a person or company with a brain page MUST create a back-link. If you write about Pedro on the Brex page, link Brex → Pedro AND Pedro → Brex. The graph is the intelligence.