Second Brain Starter

PUBLIC starter. Fictional sample graph only.

Shared OKF knowledge/ tree for the job-function plugins plus local laptop jobs. Plugins from second-brain-marketplace write here. Identity is claimed by the agent (or asked of the human), never shipped in the plugin.

Clone

git clone https://github.com/SpillwaveSolutions/second-brain-starter.git
cd second-brain-starter
python3 scripts/brain.py doctor
python3 tests/test_brain.py

This is the public fixture

Safe to fork. Every name is fictional (Northstar the account, Lumenfield the employer, Avery Quinn and Jordan Hale the people). Point live agents at your own private tree. Do not put its location in a public repo.

Concurrent writers use isolation sessions (brain_session.py open in second-brain-core) so each project worktree writes a PR instead of racing on main.

New Grok Bot agents should read second-brain-core docs/ONBOARDING.md first. That file is the history of the LLM-wiki effort, the destination state, and the canonical public repo list. Each job pack has the same file with its own identity filled in.

Quick start

# Identity is not hardcoded. Ask, then claim.
python3 scripts/brain.py whoami
python3 scripts/brain.py whoami --claim "Your Name" --plugin content-media

# Bounded pack (2 hops, ~20 nodes) — child / no-retriever fallback.
# For Q&A, spawn a retriever (or child Task) and keep a Retrieval card only.
# See docs/RETRIEVAL.md
python3 scripts/brain.py pack --root "The work is happening you just cannot see it"

# Deterministic write (uses the claimed identity if --author is omitted)
python3 scripts/brain.py write \
  --type Draft \
  --title "When the decision already happened"

# Validate links and owned rels
python3 scripts/brain.py validate

Job functions

Plugins own catalogs. Agents claim a signature. The table below is the sample Northstar fixture, not a required roster.

Plugin	Sample signature in the fixture	Pack from
executive-coordination	Grok Bot: Executive Assistant	/priorities/ship-second-brain-plugins.md
sales-pipeline	Grok Bot: Sales	/opportunities/northstar-harness-sprint.md
account-management	Grok Bot: Account Management	/clients/northstar.md
executive-job-search	Grok Bot: Executive Job Search	/job-leads/lumenfield-head-of-ai-platform.md
consulting-leads	Grok Bot: Consulting Leads	/consulting-leads/northstar-platform-team.md
content-media	Grok Bot: Articles / Laptop: Articles	/articles/the-work-is-happening.md
news-digest	Grok Bot: News Digest	/digests/morning-2026-08-14.md
gtm-positioning	Grok Bot: GTM	/positioning/disclosure-not-more-context.md

Foundation layer

The job packs write a shared OKF tree. The engineering substrate is separate and now installable from second-brain-marketplace:

• okf-plugin (okf-graph-eng)
• project-knowledge-capture
• system-architecture-capture
• data-engineering-knowledge-capture
• research-knowledge-capture
• okf-agent-graph
• wiki_ticket_sdd (worklog)

History and host contract: second-brain-core docs/ONBOARDING.md. Public samples stay Northstar / Lumenfield fiction. Never name a private remote.

Sample graph (Northstar)

A single fictional story so packs cross plugins:

NewsItem  →  FollowUpCandidate  →  Draft  →  Article  →  ConsultingLead
                                              │                 │
                                              ▼                 ▼
                                            Offer          SalesLead → Opportunity → Client

Job search (Lumenfield) is a separate track on purpose. Do not fold it into a client pack.

Install the plugins

/plugin marketplace add SpillwaveSolutions/second-brain-marketplace
/plugin install content-media@spillwave-second-brain

Point every plugin at this repo's knowledge/ folder.

Concurrent writers

Agents on different machines or project worktrees share one private second brain. They do not write main directly.

1. Read shared truth from main.
2. Open a session with second-brain-core scripts/brain_session.py open.
3. Write owned types only via the pack scripts, with --author or SECOND_BRAIN_IDENTITY.
4. Close the session to commit and open a PR against the checkout's existing remote. Never force-push. Never invent a remote.

See second-brain-core docs/ISOLATION.md.

Hosts use the same skills:

• Grok Bot binds via docs/GROK_BOT.md (no /plugin install).

• Cursor (including Grok Bot cloud agents that open this tree): docs/CURSOR.md.

• LangChain Deep Agents binds via docs/LANG_CHAIN_DEEP_AGENTS.md (skills= or SkillsMiddleware).

License

MIT. Copyright 2026 Rick Hightower / contributors.