Implement Shared Pin Feature for Collaborative Team Memory

[joelteply]

Problem

We need a lightweight way to flag important decisions and design discussions for both human and AI memory without the overhead of GitHub issues.

Solution

Implement a shared pin space per room for collaborative team memory with the following features:

Command Structure

• chat/pin <messageId> - Pin a message in current room
• chat/unpin <messageId> - Remove pin
• chat/pins/list - Show all pinned messages in room

Storage Schema

{
  id: string,
  roomId: string,
  messageId: string,
  pinnedBy: string, // userId or personaId
  pinnedAt: timestamp,
  category?: 'decision' | 'action-item' | 'context' | 'design'
}

RAG Integration

• 2x relevance score boost in vector search
• Always included in context window (even if not semantically close)
• Visible metadata showing "📌 Pinned by [name]"

UI Affordances

• Pin icon on hover for every message
• Collapsible "Pinned Messages" panel at top of chat
• Shows 3-5 most recent pins inline with "Show all X pins" link
• Visual highlight on pinned messages in scroll

Key Design Principles

• Radically transparent - if pinned in a room, everyone sees it
• Collaborative shared memory - any participant (human or AI) can pin
• Lightweight alternative to GitHub issues for transient team discussions
• Cross-AI visibility so all participants reference the same highlighted context

Integration Points

• Telepathy feature should surface pinned messages first for shared team memory queries
• Monitoring infrastructure to track pin usage and effectiveness