From bc232d878476cbe678d492f3e7102e687f16c737 Mon Sep 17 00:00:00 2001 From: Arjun <6592213+arkml@users.noreply.github.com> Date: Wed, 15 Apr 2026 23:13:49 +0530 Subject: [PATCH] improve instructions for assistant creating notes --- .../x/apps/renderer/src/components/sidebar-content.tsx | 4 +--- .../core/src/application/assistant/instructions.ts | 3 ++- .../application/assistant/skills/doc-collab/skill.ts | 10 +++++----- 3 files changed, 8 insertions(+), 9 deletions(-) diff --git a/apps/x/apps/renderer/src/components/sidebar-content.tsx b/apps/x/apps/renderer/src/components/sidebar-content.tsx index 9c578dd1..fe9e9111 100644 --- a/apps/x/apps/renderer/src/components/sidebar-content.tsx +++ b/apps/x/apps/renderer/src/components/sidebar-content.tsx @@ -1097,9 +1097,7 @@ function countFiles(node: TreeNode): number { } /** Display name overrides for top-level knowledge folders */ -const FOLDER_DISPLAY_NAMES: Record = { - Notes: 'My Notes', -} +const FOLDER_DISPLAY_NAMES: Record = {} // Tree component for file browser function Tree({ diff --git a/apps/x/packages/core/src/application/assistant/instructions.ts b/apps/x/packages/core/src/application/assistant/instructions.ts index 32d22fd9..70bf5bb8 100644 --- a/apps/x/packages/core/src/application/assistant/instructions.ts +++ b/apps/x/packages/core/src/application/assistant/instructions.ts @@ -104,7 +104,8 @@ Unlike other AI assistants that start cold every session, you have access to a l When a user asks you to prep them for a call with someone, you already know every prior decision, concerns they've raised, and commitments on both sides - because memory has been accumulating across every email and call, not reconstructed on demand. ## The Knowledge Graph -The knowledge graph is stored as plain markdown with Obsidian-style backlinks in \`knowledge/\` (inside the workspace). The folder is organized into four categories: +The knowledge graph is stored as plain markdown with Obsidian-style backlinks in \`knowledge/\` (inside the workspace). The folder is organized into these categories: +- **Notes/** - Default location for user-authored notes. Create new notes here unless the user specifies a different folder. - **People/** - Notes on individuals, tracking relationships, decisions, and commitments - **Organizations/** - Notes on companies and teams - **Projects/** - Notes on ongoing initiatives and workstreams diff --git a/apps/x/packages/core/src/application/assistant/skills/doc-collab/skill.ts b/apps/x/packages/core/src/application/assistant/skills/doc-collab/skill.ts index f5f63c17..917f1153 100644 --- a/apps/x/packages/core/src/application/assistant/skills/doc-collab/skill.ts +++ b/apps/x/packages/core/src/application/assistant/skills/doc-collab/skill.ts @@ -71,24 +71,24 @@ workspace-grep({ pattern: "[name]", path: "knowledge/" }) - Ask: "Which document would you like to work on?" **Creating new documents:** -1. Ask simply: "Shall I create [filename]?" (don't ask about location - default to \`knowledge/\` root) +1. Ask simply: "Shall I create [filename]?" (don't ask about location - default to \`knowledge/Notes/\` unless the user specifies a different folder) 2. Create it with just a title - don't pre-populate with structure or outlines 3. Ask: "What would you like in this?" \`\`\` workspace-createFile({ - path: "knowledge/[Document Name].md", + path: "knowledge/Notes/[Document Name].md", content: "# [Document Title]\n\n" }) \`\`\` **WRONG approach:** -- "Should this be in Projects/ or Topics/?" - don't ask, just use root +- "Should this be in Projects/ or Topics/?" - don't ask, just use \`knowledge/Notes/\` - "Here's a proposed outline..." - don't propose, let the user guide - "I'll create a structure with sections for X, Y, Z" - don't assume structure **RIGHT approach:** -- "Shall I create knowledge/roadmap.md?" +- "Shall I create knowledge/Notes/roadmap.md?" - *creates file with just the title* - "Created. What would you like in this?" @@ -167,11 +167,11 @@ workspace-readFile("knowledge/Projects/[Project].md") ## Document Locations Documents are stored in \`knowledge/\` within the workspace root, with subfolders: +- \`Notes/\` - **Default location for user notes. Create new notes here unless the user specifies a different folder.** - \`People/\` - Notes about individuals - \`Organizations/\` - Notes about companies, teams - \`Projects/\` - Project documentation - \`Topics/\` - Subject matter notes -- Root level for general documents ## Rich Blocks