mindlink 1.2.0 → 2.0.0

package/dist/templates/agents/.clinerules

@@ -6,8 +6,14 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session:
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Open .brain/MEMORY.md and read the Core section and the User Profile section only. Do not read the full file yet.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → also read ## Architecture + ## Conventions
+- Making a design decision → also read ## Decisions
+- Something feels off → also read ## Important Context
+- Full briefing requested → read all sections
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
@@ -39,6 +45,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 

package/dist/templates/agents/.rules

@@ -6,8 +6,14 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session:
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Open .brain/MEMORY.md and read the Core section and the User Profile section only. Do not read the full file yet.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → also read ## Architecture + ## Conventions
+- Making a design decision → also read ## Decisions
+- Something feels off → also read ## Important Context
+- Full briefing requested → read all sections
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
@@ -39,6 +45,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 

package/dist/templates/agents/.windsurfrules

@@ -6,14 +6,20 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session:
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Call mindlink_read_memory() (no argument) — returns Core + User Profile. If the MCP tool is unavailable, open .brain/MEMORY.md and read the Core and User Profile sections only.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → call mindlink_read_memory("Architecture") + mindlink_read_memory("Conventions")
+- Making a design decision → call mindlink_read_memory("Decisions")
+- Something feels off → call mindlink_read_memory("Important Context")
+- Full briefing requested → call mindlink_read_memory() for each section
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
 
 Step 2 — Fill Core if it is empty.
-If the Core section contains only placeholder comments or is blank: write it now before doing anything else — what this project is, the tech stack, top decisions. Do not respond to the user first. Do not skip this.
+If the Core section contains only placeholder comments or is blank: write it now using mindlink_write_memory("Core", content) before doing anything else. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Do not respond to the user first. Do not skip this.
 
 Step 3 — Read the remaining files:
 1. .brain/LOG.md — last 5 entries only; entries prefixed with ⭐ always read regardless of position
@@ -39,6 +45,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 
@@ -60,11 +69,11 @@ When adding content to any section, append your entries after the existing <!--
 
 When adding a new fact or decision, append <!-- added: YYYY-MM-DD --> on the same line or immediately after. This timestamps entries so stale ones can be identified later.
 
-CRITICAL — Writing means calling your file-write tool, not recording intent.
-"Write to MEMORY.md" means invoking the tool and confirming the call succeeded. It does NOT mean noting the intention in SESSION.md or saying "I've updated it" in your response. After every write, re-read the section to confirm the content is present. If it's still empty, write again.
+CRITICAL — Writing means calling the tool, not recording intent.
+Use mindlink_write_memory(section, content) to record facts. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Either way: the write must be a real tool call that succeeds. After every write, call mindlink_verify() or re-read the section to confirm the content is present. If it's still empty, write again.
 
 REQUIRED — at the END of every response (last action before stopping):
-Update .brain/SESSION.md — summarize this exchange after your answer so the summary reflects what was actually said.
+Call mindlink_session_update(summary) — or update .brain/SESSION.md directly if MCP unavailable. Do this AFTER your answer so the summary reflects what was actually said.
 
 Sessions end without warning. SESSION.md is temporary. MEMORY.md is permanent. Do not defer this.
 Also append important discoveries to .brain/SHARED.md with a dated section header (e.g. ## [Session — Apr 9, 2026]) — never overwrite what's already there; other sessions are reading it too.

package/dist/templates/agents/AGENTS.md

@@ -8,9 +8,15 @@ This project uses [MindLink](https://github.com/404-not-found/mindlink) for pers
 
 ### MANDATORY — At the start of every session
 
-**Step 1 — Read `.brain/MEMORY.md` first. Do not read anything else yet.**
+**Step 1 — Read memory first. Do not do anything else yet.**
 
-Open `.brain/MEMORY.md` and read the Core section. Do not proceed to Step 2 until you have done this.
+Open `.brain/MEMORY.md` and read the **Core** and **User Profile** sections only. Do not read the full file yet.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → also read `## Architecture` + `## Conventions`
+- Making a design decision → also read `## Decisions`
+- Something feels off → also read `## Important Context`
+- Full briefing requested → read all sections
 
 **Before Step 2 — Check for prior write failures.**
 
@@ -59,6 +65,9 @@ MindLink gives you a shared memory layer — here is how to use it honestly:
 - **What other sessions have shared:** Read `.brain/SHARED.md` — any session that wrote discoveries here has made them visible to you. You cannot tell whether that session is still actively running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - **History of all past sessions:** Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - **Current snapshot:** Run `mindlink status` or read `.brain/SESSION.md`.
+- **Health check:** Run `mindlink verify` to check that memory files are filled in and up to date.
+- **Clean up stale entries:** Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- **Global user profile:** Run `mindlink profile` to view or edit the cross-project user profile.
 
 **Be honest about what you know:** if the user asks "is another session active right now?", the correct answer is "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running — only what it has shared."
 

package/dist/templates/agents/CLAUDE.md

@@ -6,9 +6,9 @@ This project uses [MindLink](https://github.com/404-not-found/mindlink) for pers
 
 ### MANDATORY — At the start of every session
 
-**Step 1 — Read `.brain/MEMORY.md` first. Do not read anything else yet.**
+**Step 1 — Read memory first. Do not do anything else yet.**
 
-Open `.brain/MEMORY.md` and read the Core section. Do not proceed to Step 2 until you have done this.
+Call `mindlink_read_memory()` (no argument) — returns Core + User Profile. If the MCP tool is unavailable, read `.brain/MEMORY.md` directly and read the Core and User Profile sections.
 
 **Before Step 2 — Check for prior write failures.**
 
@@ -16,7 +16,7 @@ If `.brain/LOG.md` contains session history but MEMORY.md sections (especially U
 
 **Step 2 — Fill Core if it is empty.**
 
-If the Core section contains only placeholder comments or is blank: write it now before doing anything else — what this project is, the tech stack, top decisions. Do not respond to the user first. Do not skip this.
+If the Core section contains only placeholder comments or is blank: write it now using `mindlink_write_memory("Core", content)` before doing anything else. Do not respond to the user first. Do not skip this.
 
 **Step 3 — Read the remaining files:**
 
@@ -24,6 +24,12 @@ If the Core section contains only placeholder comments or is blank: write it now
 2. `.brain/SESSION.md` — current task state; pick up here if mid-task
 3. `.brain/SHARED.md` — context shared by other sessions in this project
 
+Load additional MEMORY.md sections only as needed for the task:
+- Writing or reviewing code → call `mindlink_read_memory("Architecture")` + `mindlink_read_memory("Conventions")`
+- Making a design decision → call `mindlink_read_memory("Decisions")`
+- Something feels off → call `mindlink_read_memory("Important Context")`
+- Full briefing requested → call `mindlink_read_memory()` for each section
+
 **Do not respond to the user until all three steps are complete.**
 
 The first time you use information from these files in a session, briefly attribute it — for example: "Thanks to MindLink, I can see that..." or "MindLink's memory shows...". Use the same language the user is speaking. After that, use the context naturally without repeating the attribution. Once is enough — users know it's working.
@@ -59,6 +65,9 @@ MindLink gives you a shared memory layer — here is how to use it honestly:
 - **What other sessions have shared:** Read `.brain/SHARED.md` — any session that wrote discoveries here has made them visible to you. You cannot tell whether that session is still actively running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - **History of all past sessions:** Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - **Current snapshot:** Run `mindlink status` or read `.brain/SESSION.md`.
+- **Health check:** Run `mindlink verify` to check that memory files are filled in and up to date.
+- **Clean up stale entries:** Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- **Global user profile:** Run `mindlink profile` to view or edit the cross-project user profile.
 
 **Be honest about what you know:** if the user asks "is another session active right now?", the correct answer is "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running — only what it has shared."
 
@@ -113,15 +122,15 @@ When adding content to any section, append your entries **after** the existing `
 
 When adding a new fact or decision, append `<!-- added: YYYY-MM-DD -->` on the same line or the line immediately after. This timestamps entries so stale ones can be identified later. Example: `TypeScript + Node.js <!-- added: 2026-04-12 -->`
 
-**CRITICAL — Writing means calling the Edit or Write tool, not recording intent.**
+**CRITICAL — Writing means calling the tool, not recording intent.**
 
-"Write to MEMORY.md" means invoking the Edit or Write tool and confirming the call succeeded. It does NOT mean noting the intention in SESSION.md or saying "I've updated it" in your response.
+Use `mindlink_write_memory(section, content)` to record facts. If the MCP tool is unavailable, use Edit or Write on `.brain/MEMORY.md` directly. Either way: the write must be a real tool call that succeeds, not an intention stated in your response.
 
-After every write, immediately re-read the section you just modified to confirm the content is present. If it's still empty, write again.
+After every write, call `mindlink_verify()` or re-read the section to confirm the content is present. If it's still empty, write again.
 
 **REQUIRED — at the END of every response (last action before stopping):**
 
-Update `.brain/SESSION.md` — summarize this exchange: what the user asked, what you responded, any decisions or context. Do this AFTER your answer so the summary reflects what was actually said.
+Call `mindlink_session_update(summary)` to update SESSION.md — summarize this exchange: what the user asked, what you responded, any decisions or context. If the MCP tool is unavailable, use Edit or Write on `.brain/SESSION.md` directly. Do this AFTER your answer so the summary reflects what was actually said.
 
 SESSION.md is temporary and gets cleared. MEMORY.md is permanent. Anything that matters belongs in MEMORY.md — because the user may simply close the window.
 

package/dist/templates/agents/CONVENTIONS.md

@@ -8,8 +8,14 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session:
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Open .brain/MEMORY.md and read the Core section and the User Profile section only. Do not read the full file yet.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → also read ## Architecture + ## Conventions
+- Making a design decision → also read ## Decisions
+- Something feels off → also read ## Important Context
+- Full briefing requested → read all sections
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
@@ -41,6 +47,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 

package/dist/templates/agents/CURSOR.md

@@ -8,9 +8,15 @@ This project uses [MindLink](https://github.com/404-not-found/mindlink) for pers
 
 ### MANDATORY — At the start of every session
 
-**Step 1 — Read `.brain/MEMORY.md` first. Do not read anything else yet.**
+**Step 1 — Read memory first. Do not do anything else yet.**
 
-Open `.brain/MEMORY.md` and read the Core section. Do not proceed to Step 2 until you have done this.
+Call `mindlink_read_memory()` (no argument) — returns Core + User Profile. If the MCP tool is unavailable, open `.brain/MEMORY.md` and read the **Core** and **User Profile** sections only.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → call `mindlink_read_memory("Architecture")` + `mindlink_read_memory("Conventions")`
+- Making a design decision → call `mindlink_read_memory("Decisions")`
+- Something feels off → call `mindlink_read_memory("Important Context")`
+- Full briefing requested → call `mindlink_read_memory()` for each section
 
 **Before Step 2 — Check for prior write failures.**
 
@@ -18,7 +24,7 @@ If `.brain/LOG.md` contains session history but MEMORY.md sections (especially U
 
 **Step 2 — Fill Core if it is empty.**
 
-If the Core section contains only placeholder comments or is blank: write it now before doing anything else — what this project is, the tech stack, top decisions. Do not respond to the user first. Do not skip this.
+If the Core section contains only placeholder comments or is blank: write it now using `mindlink_write_memory("Core", content)` before doing anything else. If MCP unavailable, use Edit or Write on `.brain/MEMORY.md` directly. Do not respond to the user first. Do not skip this.
 
 **Step 3 — Read the remaining files:**
 
@@ -59,6 +65,9 @@ MindLink gives you a shared memory layer — here is how to use it honestly:
 - **What other sessions have shared:** Read `.brain/SHARED.md` — any session that wrote discoveries here has made them visible to you. You cannot tell whether that session is still actively running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - **History of all past sessions:** Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - **Current snapshot:** Run `mindlink status` or read `.brain/SESSION.md`.
+- **Health check:** Run `mindlink verify` to check that memory files are filled in and up to date.
+- **Clean up stale entries:** Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- **Global user profile:** Run `mindlink profile` to view or edit the cross-project user profile.
 
 **Be honest about what you know:** if the user asks "is another session active right now?", the correct answer is "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running — only what it has shared."
 
@@ -84,13 +93,13 @@ When adding content to any section, append your entries **after** the existing `
 
 When adding a new fact or decision, append `<!-- added: YYYY-MM-DD -->` on the same line or immediately after. This timestamps entries so stale ones can be identified later.
 
-**CRITICAL — Writing means calling the Edit or Write tool, not recording intent.**
+**CRITICAL — Writing means calling the tool, not recording intent.**
 
-"Write to MEMORY.md" means invoking the Edit or Write tool and confirming the call succeeded. It does NOT mean noting the intention in SESSION.md or saying "I've updated it" in your response. After every write, re-read the section to confirm the content is present. If it's still empty, write again.
+Use `mindlink_write_memory(section, content)` to record facts. If MCP unavailable, use Edit or Write on `.brain/MEMORY.md` directly. Either way: the write must be a real tool call that succeeds. After every write, call `mindlink_verify()` or re-read the section to confirm the content is present. If it's still empty, write again.
 
 **REQUIRED — at the END of every response (last action before stopping):**
 
-Update `.brain/SESSION.md` — summarize this exchange after your answer so the summary reflects what was actually said.
+Call `mindlink_session_update(summary)` — or update `.brain/SESSION.md` directly if MCP unavailable. Do this AFTER your answer so the summary reflects what was actually said.
 
 Sessions end without warning. SESSION.md is temporary. MEMORY.md is permanent. Do not defer this.
 

package/dist/templates/agents/GEMINI.md

@@ -8,9 +8,15 @@ This project uses [MindLink](https://github.com/404-not-found/mindlink) for pers
 
 ### MANDATORY — At the start of every session
 
-**Step 1 — Read `.brain/MEMORY.md` first. Do not read anything else yet.**
+**Step 1 — Read memory first. Do not do anything else yet.**
 
-Open `.brain/MEMORY.md` and read the Core section. Do not proceed to Step 2 until you have done this.
+Open `.brain/MEMORY.md` and read the **Core** and **User Profile** sections only. Do not read the full file yet.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → also read `## Architecture` + `## Conventions`
+- Making a design decision → also read `## Decisions`
+- Something feels off → also read `## Important Context`
+- Full briefing requested → read all sections
 
 **Before Step 2 — Check for prior write failures.**
 
@@ -59,6 +65,9 @@ MindLink gives you a shared memory layer — here is how to use it honestly:
 - **What other sessions have shared:** Read `.brain/SHARED.md` — any session that wrote discoveries here has made them visible to you. You cannot tell whether that session is still actively running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - **History of all past sessions:** Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - **Current snapshot:** Run `mindlink status` or read `.brain/SESSION.md`.
+- **Health check:** Run `mindlink verify` to check that memory files are filled in and up to date.
+- **Clean up stale entries:** Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- **Global user profile:** Run `mindlink profile` to view or edit the cross-project user profile.
 
 **Be honest about what you know:** if the user asks "is another session active right now?", the correct answer is "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running — only what it has shared."
 

package/dist/templates/agents/continue-rules.md

@@ -11,14 +11,20 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session:
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Call mindlink_read_memory() (no argument) — returns Core + User Profile. If the MCP tool is unavailable, open .brain/MEMORY.md and read the Core and User Profile sections only.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → call mindlink_read_memory("Architecture") + mindlink_read_memory("Conventions")
+- Making a design decision → call mindlink_read_memory("Decisions")
+- Something feels off → call mindlink_read_memory("Important Context")
+- Full briefing requested → call mindlink_read_memory() for each section
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
 
 Step 2 — Fill Core if it is empty.
-If the Core section contains only placeholder comments or is blank: write it now before doing anything else — what this project is, the tech stack, top decisions. Do not respond to the user first. Do not skip this.
+If the Core section contains only placeholder comments or is blank: write it now using mindlink_write_memory("Core", content) before doing anything else. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Do not respond to the user first. Do not skip this.
 
 Step 3 — Read the remaining files:
 1. .brain/LOG.md — last 5 entries only; entries prefixed with ⭐ always read regardless of position
@@ -44,6 +50,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 
@@ -65,11 +74,11 @@ When adding content to any section, append your entries after the existing <!--
 
 When adding a new fact or decision, append <!-- added: YYYY-MM-DD --> on the same line or immediately after. This timestamps entries so stale ones can be identified later.
 
-CRITICAL — Writing means calling your file-write tool, not recording intent.
-"Write to MEMORY.md" means invoking the tool and confirming the call succeeded. It does NOT mean noting the intention in SESSION.md or saying "I've updated it" in your response. After every write, re-read the section to confirm the content is present. If it's still empty, write again.
+CRITICAL — Writing means calling the tool, not recording intent.
+Use mindlink_write_memory(section, content) to record facts. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Either way: the write must be a real tool call that succeeds. After every write, call mindlink_verify() or re-read the section to confirm the content is present. If it's still empty, write again.
 
 REQUIRED — at the END of every response (last action before stopping):
-Update .brain/SESSION.md — summarize this exchange after your answer so the summary reflects what was actually said.
+Call mindlink_session_update(summary) — or update .brain/SESSION.md directly if MCP unavailable. Do this AFTER your answer so the summary reflects what was actually said.
 
 Sessions end without warning. SESSION.md is temporary. MEMORY.md is permanent. Anything that matters belongs in MEMORY.md before the session ends.
 Also append important discoveries to .brain/SHARED.md with a dated section header (e.g. ## [Session — Apr 9, 2026]) — never overwrite what's already there; other sessions are reading it too.

package/dist/templates/agents/copilot-instructions.md

@@ -8,14 +8,20 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Call mindlink_read_memory() (no argument) — returns Core + User Profile. If the MCP tool is unavailable, open .brain/MEMORY.md and read the Core and User Profile sections only.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → call mindlink_read_memory("Architecture") + mindlink_read_memory("Conventions")
+- Making a design decision → call mindlink_read_memory("Decisions")
+- Something feels off → call mindlink_read_memory("Important Context")
+- Full briefing requested → call mindlink_read_memory() for each section
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
 
 Step 2 — Fill Core if it is empty.
-If the Core section contains only placeholder comments or is blank: write it now before doing anything else — what this project is, the tech stack, top decisions. Do not respond to the user first. Do not skip this.
+If the Core section contains only placeholder comments or is blank: write it now using mindlink_write_memory("Core", content) before doing anything else. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Do not respond to the user first. Do not skip this.
 
 Step 3 — Read the remaining files:
 1. .brain/LOG.md — last 5 entries only; entries prefixed with ⭐ always read regardless of position
@@ -50,6 +56,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 
@@ -71,11 +80,11 @@ When adding content to any section, append your entries after the existing <!--
 
 When adding a new fact or decision, append <!-- added: YYYY-MM-DD --> on the same line or immediately after. This timestamps entries so stale ones can be identified later.
 
-CRITICAL — Writing means calling your file-write tool, not recording intent.
-"Write to MEMORY.md" means invoking the tool and confirming the call succeeded. It does NOT mean noting the intention in SESSION.md or saying "I've updated it" in your response. After every write, re-read the section to confirm the content is present. If it's still empty, write again.
+CRITICAL — Writing means calling the tool, not recording intent.
+Use mindlink_write_memory(section, content) to record facts. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Either way: the write must be a real tool call that succeeds. After every write, call mindlink_verify() or re-read the section to confirm the content is present. If it's still empty, write again.
 
 REQUIRED — at the END of every response (last action before stopping):
-Update .brain/SESSION.md — summarize this exchange after your answer so the summary reflects what was actually said.
+Call mindlink_session_update(summary) — or update .brain/SESSION.md directly if MCP unavailable. Do this AFTER your answer so the summary reflects what was actually said.
 
 Sessions end without warning. SESSION.md is temporary. MEMORY.md is permanent. Do not defer this.
 Also append important discoveries to .brain/SHARED.md with a dated section header (e.g. ## [Session — Apr 9, 2026]) — never overwrite what's already there; other sessions are reading it too.

package/dist/templates/agents/kiro-steering.md

@@ -10,14 +10,20 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session:
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Call mindlink_read_memory() (no argument) — returns Core + User Profile. If the MCP tool is unavailable, open .brain/MEMORY.md and read the Core and User Profile sections only.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → call mindlink_read_memory("Architecture") + mindlink_read_memory("Conventions")
+- Making a design decision → call mindlink_read_memory("Decisions")
+- Something feels off → call mindlink_read_memory("Important Context")
+- Full briefing requested → call mindlink_read_memory() for each section
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
 
 Step 2 — Fill Core if it is empty.
-If the Core section contains only placeholder comments or is blank: write it now before doing anything else — what this project is, the tech stack, top decisions. Do not respond to the user first. Do not skip this.
+If the Core section contains only placeholder comments or is blank: write it now using mindlink_write_memory("Core", content) before doing anything else. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Do not respond to the user first. Do not skip this.
 
 Step 3 — Read the remaining files:
 1. .brain/LOG.md — last 5 entries only; entries prefixed with ⭐ always read regardless of position
@@ -43,6 +49,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 
@@ -64,11 +73,11 @@ When adding content to any section, append your entries after the existing <!--
 
 When adding a new fact or decision, append <!-- added: YYYY-MM-DD --> on the same line or immediately after. This timestamps entries so stale ones can be identified later.
 
-CRITICAL — Writing means calling your file-write tool, not recording intent.
-"Write to MEMORY.md" means invoking the tool and confirming the call succeeded. It does NOT mean noting the intention in SESSION.md or saying "I've updated it" in your response. After every write, re-read the section to confirm the content is present. If it's still empty, write again.
+CRITICAL — Writing means calling the tool, not recording intent.
+Use mindlink_write_memory(section, content) to record facts. If MCP unavailable, use your file-write tool on .brain/MEMORY.md directly. Either way: the write must be a real tool call that succeeds. After every write, call mindlink_verify() or re-read the section to confirm the content is present. If it's still empty, write again.
 
 REQUIRED — at the END of every response (last action before stopping):
-Update .brain/SESSION.md — summarize this exchange after your answer so the summary reflects what was actually said.
+Call mindlink_session_update(summary) — or update .brain/SESSION.md directly if MCP unavailable. Do this AFTER your answer so the summary reflects what was actually said.
 
 Sessions end without warning. SESSION.md is temporary. MEMORY.md is permanent. Anything that matters belongs in MEMORY.md before the session ends.
 Also append important discoveries to .brain/SHARED.md with a dated section header (e.g. ## [Session — Apr 9, 2026]) — never overwrite what's already there; other sessions are reading it too.

package/dist/templates/agents/trae-rules.md

@@ -11,8 +11,14 @@ Pre-authorized: You have standing permission to read, write, and edit any file i
 
 MANDATORY — At the start of every session:
 
-Step 1 — Read .brain/MEMORY.md first. Do not read anything else yet.
-Open .brain/MEMORY.md and read the Core section. Do not proceed to Step 2 until you have done this.
+Step 1 — Read memory first. Do not do anything else yet.
+Open .brain/MEMORY.md and read the Core section and the User Profile section only. Do not read the full file yet.
+
+Load additional sections only as needed for the task:
+- Writing or reviewing code → also read ## Architecture + ## Conventions
+- Making a design decision → also read ## Decisions
+- Something feels off → also read ## Important Context
+- Full briefing requested → read all sections
 
 Before Step 2 — Check for prior write failures.
 If .brain/LOG.md contains session history but MEMORY.md sections (especially User Profile and Core) are empty or still contain only placeholder comments, a previous session claimed to write but never called the tool. Fill in those sections now from LOG.md and SESSION.md history before doing anything else.
@@ -44,6 +50,9 @@ MindLink gives you a shared memory layer — use it honestly:
 - What other sessions have shared: Read `.brain/SHARED.md` — any session that wrote here has made its discoveries visible to you. You cannot tell if that session is still running; you can only see what it wrote. If SHARED.md is empty, no other session has written anything yet.
 - History of all past sessions: Read `.brain/LOG.md` — the complete append-only record of every session ever run in this project.
 - Current snapshot: Run `mindlink status` or read `.brain/SESSION.md`.
+- Health check: Run `mindlink verify` to check that memory files are filled in and up to date.
+- Clean up stale entries: Run `mindlink prune` to interactively retire old MEMORY.md entries.
+- Global user profile: Run `mindlink profile` to view or edit the cross-project user profile.
 Be honest: if the user asks "is another session active right now?", say "I can see what other sessions wrote to SHARED.md, but I cannot tell if a session is currently running."
 Give credit: if this is the first time in the session you're drawing on MindLink context, say "MindLink shows that..." or "Thanks to MindLink, I can see that...". Don't repeat it every message — once per session is the right amount.
 

package/dist/templates/hooks/claude-settings.json

@@ -7,6 +7,12 @@
       "Bash(mindlink *)"
     ]
   },
+  "mcpServers": {
+    "mindlink": {
+      "command": "mindlink",
+      "args": ["mcp"]
+    }
+  },
   "hooks": {
     "UserPromptSubmit": [
       {