From 7b119fbfcd228f2f05f8bd7744d9db721cd3f726 Mon Sep 17 00:00:00 2001 From: Arjun <6592213+arkml@users.noreply.github.com> Date: Tue, 5 May 2026 19:56:57 +0530 Subject: [PATCH] refine note-writing instructions for self-reference and relationship phrasing --- .../core/src/knowledge/note_creation.ts | 37 +++++++++++++++++++ .../core/src/knowledge/note_system.ts | 6 +-- 2 files changed, 40 insertions(+), 3 deletions(-) diff --git a/apps/x/packages/core/src/knowledge/note_creation.ts b/apps/x/packages/core/src/knowledge/note_creation.ts index 0a4d8981..2f58bf64 100644 --- a/apps/x/packages/core/src/knowledge/note_creation.ts +++ b/apps/x/packages/core/src/knowledge/note_creation.ts @@ -807,6 +807,43 @@ The summary should answer: **"Who is this person and why do I know them?"** **Focus on the relationship, not the communication method.** +## Knowing Vs Meeting + +Distinguish between **knowing someone** and **having met or heard from them once**. + +- Use **"I know X through Y"** only when there is an actual ongoing relationship +- In that construction, **Y** should be a person, organization, or recurring context such as YC, an investor relationship, a customer relationship, or an ongoing project +- For one-off encounters, use **"I met X at/on/during..."** or lead with what they did, such as **"X reached out about..."**, **"X joined..."**, or **"X was part of..."** +- Do **not** use **"I know X through [an event]"** when the thing is a specific meeting, dinner, conference, demo day, call, or other one-off event +- Events are **when or where I met someone**, not **how I know them** +- If the source only shows a single meeting, a single inbound email, or a one-time introduction, do not imply an ongoing relationship unless the broader context clearly supports it + +Examples: + +- Incorrect: \`I know him through a YC dinner.\` +- Correct: \`I met him at a YC dinner.\` +- Incorrect: \`I know her through a call about pricing.\` +- Correct: \`She reached out about pricing.\` +- Correct: \`I know her through YC and ongoing investor conversations.\` + +## Perspective And Self-Reference + +These knowledge notes are written from the **user's first-person perspective**. + +- When the user's identity is known, **"I / me / my" refer to the user** +- When the company or team is the actor, use **"we / us / our"** when natural +- Name other participants normally +- **Do not refer to the user by name, email, or in third person inside first-person narration** +- Do not write broken combinations like **"I know him ... that met with Arjun"** when Arjun is the user +- Apply this consistently across **all note types and sections**: summaries, activity entries, timelines, decisions, open items, and any narrative prose + +Examples: + +- Incorrect: \`I know him as part of the Standard Capital team that met with Arjun and Ramnique.\` +- Correct: \`I know him as part of the Standard Capital team that met with me and Ramnique.\` +- Incorrect: \`Arjun discussed pricing with [[People/Sarah Chen]].\` +- Correct: \`I discussed pricing with [[People/Sarah Chen]].\` + ## Activity Summary One line summarizing this source's relevance to the entity: diff --git a/apps/x/packages/core/src/knowledge/note_system.ts b/apps/x/packages/core/src/knowledge/note_system.ts index a62a4e37..b7becb3f 100644 --- a/apps/x/packages/core/src/knowledge/note_system.ts +++ b/apps/x/packages/core/src/knowledge/note_system.ts @@ -26,7 +26,7 @@ const DEFAULT_NOTE_TYPE_DEFINITIONS: NoteTypeDefinition[] = [ **Last update:** {YYYY-MM-DD} ## Summary -{2-3 sentences: Who they are, why you know them, what you're working on together.} +{2-3 sentences: Who they are, whether I know them through an ongoing relationship or met them in a specific encounter, and what we're discussing or working on together if applicable.} ## Connected to - [[Organizations/{Organization}]] — works at @@ -59,7 +59,7 @@ const DEFAULT_NOTE_TYPE_DEFINITIONS: NoteTypeDefinition[] = [ **Last update:** {YYYY-MM-DD} ## Summary -{2-3 sentences: What this org is, what your relationship is.} +{2-3 sentences: What this org is, how I know or work with them.} ## People - [[People/{Person}]] — {role} @@ -93,7 +93,7 @@ const DEFAULT_NOTE_TYPE_DEFINITIONS: NoteTypeDefinition[] = [ **Last update:** {YYYY-MM-DD} ## Summary -{2-3 sentences: What this project is, goal, current state.} +{2-3 sentences: What this project is, the goal, current state, and my/our involvement where relevant.} ## People - [[People/{Person}]] — {role}