wip

.roo/rules.md

@@ -13,9 +13,9 @@ Each mode has **one responsibility** and performs **only that responsibility**:
 
 - Orchestrator  
 - Architect  
-- Clarification  
+- Ask  
 - Debugger  
-- Backend Coder  
+- Coder  
 - Frontend Coder  
 - Designer  
 - Quality  
@@ -115,6 +115,58 @@ execution must proceed without further comment.
 
 ---
 
+## Memory (MCP) — Product Brain Rules
+
+Memory is **not** a place for instructions, prompts, or process rules.
+
+Memory represents **product knowledge and decision constraints** that are:
+- not encoded directly in code
+- not part of working instructions
+- but must influence future decisions
+
+### What MAY be stored in Memory
+Only **truths about the product**, such as:
+- domain rules that are not obvious from code alone  
+- irreversible product decisions  
+- historical or business constraints  
+- intentional trade-offs  
+- invariants that must hold across all future work  
+
+Examples (illustrative only):
+- “The website is marketing-only and contains no business rules.”  
+- “Public DTOs are external contracts and must not be renamed.”  
+- “Some automation flows intentionally allow partial failure.”
+
+Memory entries must be:
+- declarative
+- short
+- atomic
+- free of explanation
+- free of history
+- free of instruction language
+
+### What MUST NEVER be stored in Memory
+- instructions or rules of how to work  
+- role definitions or mode behavior  
+- prompts or prompt fragments  
+- TODOs or task lists  
+- explanations or examples  
+- chat summaries  
+- code  
+- logs  
+- decisions about process  
+
+If something belongs in a prompt, README, or code comment → it does NOT belong in memory.
+
+### Memory Access Rules
+- Only the **Orchestrator** may read from or write to memory.  
+- Experts must NEVER read or write memory directly.  
+- Memory is consulted only when making decisions, never during execution.
+
+Memory exists to **prevent re-deciding facts**, not to guide implementation.
+
+---
+
 ## Forbidden (Applies to All Modes)
 Modes may NOT:
 - override user intent