ppl

ppl: People Manager for the Brain Vault

you works with a lot of people. This skill turns "Alice Perl is a Security Researcher in my team" into a permanent, cross-referenced wiki entity. Once filed, every future synthesis, daily sync, save, or ingest links the mention to the person's page.

The wiki compounds. People compound too.

---

Vault Layout

• Vault root: ~/digital-brain/
• People folder: wiki/entities/people/ (create if missing)
• People index: wiki/entities/people/_index.md (create if missing — the canonical roster)
• Wiki index: wiki/index.md — has an ## Entities section; person rows live there too
• Log: wiki/log.md — append a ppl entry at the TOP after every add/edit
• Hot cache: wiki/hot.md — touch only if the person is currently active in recent threads

Why a sub-folder under entities/? Existing entity pages (Your Organization.md) live in wiki/entities/ directly. Keep organizations and tools there; group people under wiki/entities/people/ so the roster is greppable as one set.

---

Invocation Forms

Form	Action
/ppl <Name> <free-text role / context>	add (default) — create new person page
/ppl add <Name> <free-text>	same as above, explicit
/ppl edit <Name>	update existing person page
/ppl list	show the roster from _index.md
/ppl lookup <Name or alias>	display the person's page

If $ARGUMENTS is empty, show the four forms and ask which one.

---

Parsing /ppl <Name> <tail>

1. Split tokens. The Name is the leading run of [A-Z][a-z']+ tokens (capitalized words). Take the first 2 capitalized tokens by default. If only one capitalized token, take 1. If 3+ consecutive capitalized tokens before a lowercase word (e.g. Mary Jane Watson), take 3.
2. The tail is everything after the name — that's role + relationship + free context.
3. Heuristics on the tail (do not over-fit, but capture what's obvious):
   • Role — the noun phrase before "in/at/on/of" or before "my". Examples: Security Researcher in my team → role Security Researcher; head of engineering → role Head of Engineering.
   • Relationship to you — look for: my manager, my team, co founder / cofounder / co-founder, cpo, cto, ceo, head of …, peer, report, direct report, reports to me. Map to a short relationship value: manager, teammate, direct-report, cofounder, executive, peer, external. If multiple apply, store the closest to you (e.g. cofounder over executive).
   • Team — capture <role> in my team → team Your Organization unless tail says otherwise.
   • Company — default Your Organization if no other company is named; if the tail names a different company, use that.
4. Anything unparsed stays as free-form context in the page body. Don't drop it.