@rembr/vscode 1.0.0

package/templates/windsurfrules

@@ -0,0 +1,141 @@
+# REMBR - Recursive Language Model with Semantic Memory
+
+You have access to REMBR, a semantic memory system via MCP tools. Use it to implement the Recursive Language Model (RLM) pattern for complex tasks.
+
+## Core Principles
+
+1. **Never work with more context than necessary** - Query REMBR for only relevant prior knowledge
+2. **Break down complex tasks** - Spawn focused subtasks with targeted context
+3. **Store findings persistently** - Save discoveries to REMBR for future sessions
+4. **Coordinate through structured returns** - Each subtask returns a standard result format
+
+## Available REMBR Tools (via MCP)
+
+### Memory Management
+- `store_memory` - Store insights, facts, preferences, project info
+- `search_memory` - Hybrid semantic + text search across memories
+- `list_memories` - Browse recent memories by category
+- `get_memory` - Retrieve specific memory by ID
+- `delete_memory` - Remove outdated memories
+
+### Context Workspaces
+- `create_context` - Create workspace for related memories
+- `add_memory_to_context` - Link memories to contexts
+- `search_context` - Scoped search within a workspace
+- `list_contexts` - View available workspaces
+
+### Snapshots (for subtask handoffs)
+- `create_snapshot` - Immutable memory bundle with TTL
+- `get_snapshot` - Retrieve snapshot by ID
+- `list_snapshots` - View available snapshots
+
+### Insights
+- `get_stats` - Usage and limits
+- `get_context_insights` - Category distribution, patterns
+- `get_memory_graph` - Memory relationships
+- `detect_contradictions` - Find conflicting information
+
+## Memory Categories
+
+Organize memories semantically:
+- **facts** - Concrete information and data
+- **preferences** - User settings and choices
+- **conversations** - Conversation context
+- **projects** - Project-specific information
+- **learning** - Knowledge and insights
+- **goals** - Objectives and targets
+- **context** - Situational context
+- **reminders** - Future actions
+
+## RLM Pattern: Parent-Subtask Protocol
+
+### Before Decomposing
+
+1. Generate unique `taskId` (e.g., `implement-auth-20240106`)
+2. Query REMBR for relevant prior context:
+   ```
+   search_memory({ query: "authentication patterns OAuth JWT", limit: 10 })
+   ```
+3. Identify subtasks and what context each needs
+
+### When Creating Flows/Cascades
+
+Provide each flow with:
+```
+## Objective
+[Specific focused objective]
+
+## Context from REMBR
+[Relevant memories retrieved for this flow]
+
+## Storage Instructions
+Store findings with:
+- Category: "facts"
+- Metadata: { "taskId": "implement-auth-20240106", "area": "oauth-flow" }
+
+## Return Format
+- Summary: [What you found/did]
+- Findings stored: [Search query to retrieve details]
+- Key points: [Most important items]
+- Status: [complete/partial/blocked]
+```
+
+### After Flows Complete
+
+1. Read each flow's summary and key points
+2. If full details needed, query REMBR:
+   ```
+   search_memory({ query: "implement-auth-20240106 oauth-flow", category: "facts" })
+   ```
+3. Synthesize findings and store to REMBR for future sessions
+
+## Example Usage
+
+### Storing a Discovery
+```
+store_memory({
+  category: "facts",
+  content: "API uses rate limiting: 100 req/min per user via express-rate-limit + Redis",
+  metadata: {
+    taskId: "rate-limit-analysis",
+    area: "api-middleware",
+    file: "src/middleware/rateLimit.ts"
+  }
+})
+```
+
+### Retrieving Context
+```
+search_memory({
+  query: "rate limiting middleware patterns",
+  category: "facts",
+  limit: 5
+})
+```
+
+### Creating a Workspace
+```
+create_context({
+  name: "payment-service-refactor",
+  description: "Refactoring payment service to microservices",
+  category: "projects"
+})
+```
+
+## When to Use REMBR
+
+✅ **Do use** for:
+- Storing architectural decisions
+- Remembering project patterns and conventions
+- Building knowledge across sessions
+- Coordinating complex multi-step tasks (Cascade flows)
+- Sharing context between flows
+
+❌ **Don't use** for:
+- Temporary variables or transient data
+- Information already in the codebase
+- Simple single-step tasks
+
+## API Key Setup
+
+Ensure `REMBR_API_KEY` is set in your Windsurf environment settings.