Update agent prompts to use Memory Router interface (ADR-037)

[rjmurillo-bot]

Summary

After ADR-037 Memory Router Architecture is approved and MemoryRouter.psm1 is implemented, update agent prompts to use the unified Memory Router interface instead of direct backend calls.

Background

ADR-037 defines a unified interface:

• Search-Memory: Semantic/lexical search with Forgetful→Serena fallback
• Get-Memory: Direct memory retrieval by ID
• Save-Memory: Store memories with automatic deduplication

Files to Modify (Enumerated)

File	Lines/Symbols	Current State	Required Change
.claude/agents/skillbook.md	Lines 43, 1230-1267	Uses mcp__serena__*	Use Memory Router
.claude/agents/memory.md	Entire memory section	Uses Serena-only	Use Memory Router
.claude/agents/retrospective.md	Lines with cloudmcp-manager	Deprecated refs	Remove, use router

Grep Command to Find All Affected Files

grep -rn "mcp__serena__\|mcp__forgetful__\|cloudmcp" .claude/agents/

Dependencies

• Reconcile memory system fragmentation across 4 interfaces #751 - Memory fragmentation resolved (unified interface defined)
• [M-003] MemoryRouter performance optimization: reduce 260ms overhead to <20ms #734 - MemoryRouter.psm1 performance optimized (<20ms)
• ADR-037 approved

Acceptance Criteria

• grep -rn "mcp__serena__\|mcp__forgetful__\|cloudmcp" .claude/agents/ returns ONLY Memory Router usage patterns
• skillbook.md uses Search-Memory for deduplication checks
• memory.md uses Memory Router for all memory operations
• retrospective.md has zero cloudmcp-manager references
• All prompts document Memory Router fallback behavior
• Integration tests verify agent prompts work with router

Exit Criteria Verification

# Must return 0 matches for direct MCP calls
grep -c "mcp__serena__list_memories\|mcp__serena__read_memory\|cloudmcp" .claude/agents/*.md
# Expected: 0

# Must return matches for Memory Router usage
grep -c "Search-Memory\|Get-Memory\|Save-Memory" .claude/agents/*.md  
# Expected: >0

Related

• ADR-037: .agents/architecture/ADR-037-memory-router-architecture.md
• ADR-007: Memory-First Architecture
• Blocking: Reconcile memory system fragmentation across 4 interfaces #751, [M-003] MemoryRouter performance optimization: reduce 260ms overhead to <20ms #734

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

---

🔗 Related PRs

#546 - fix(agents): resolve platform drift in 3 agents [merged]
#730 - feat: ADR-007 Memory-First Architecture enforcement and Forgetful MCP setup [merged]
#735 - feat(memory): Phase 2A Memory System - MemoryRouter, Reflexion Memory, ADR-007 Enforcement [merged]
#738 - docs(claude): update CLAUDE.md with current repository state [merged]
#752 - feat(memory): memory system foundation (Session 230) [merged]

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[github-actions]

Product Requirements Document

Important

This PRD was automatically generated based on issue triage escalation.
Complexity Score: 9/12 (Detailed)
Escalation Criteria: feature_request,external_dependency,multi_phase_work

About this PRD

This PRD was generated by the Explainer Agent after the issue was flagged
for detailed analysis. The document is designed to be self-contained - it can
be passed to a separate AI agent instance for implementation without additional
context.

PRD Depth Levels:

• Standard (4-6): Brief analysis, clear requirements
• Detailed (7-9): Research section, blocking questions
• Comprehensive (10-12): Phased implementation, risk analysis

---

Let me check for ADR-037 and ADR-007/ADR-017 for context, and examine the existing memory tools patterns.

Now let me search for any existing Memory Router implementation, related scripts, and check the session-123 reference mentioned in the issue.

Now let me check retrospective.md for the cloudmcp-manager references mentioned in the issue at specific lines:

Now I have sufficient context. Let me create the PRD.

Let me check if the planning directory exists and try an alternative approach:

The directory exists. The permission issue is a temporary environment constraint. Here is the PRD content that would be saved to .agents/planning/PRD-memory-router-agent-prompts.md:

---

PRD: Update Agent Prompts to Use Memory Router Interface (ADR-037)

Executive Summary

Three agent prompts require updates to use the unified Memory Router interface defined in ADR-037. The Memory Router provides semantic search, automatic fallback between Forgetful and Serena backends, and consistent deduplication. Currently, these agents use inconsistent approaches: skillbook.md and memory.md use Serena-only lexical matching, while retrospective.md references the deprecated cloudmcp-manager backend.

Scope	Status	Blocker
ADR-037 Approval	🔴 BLOCKED	ADR-037 status is "Proposed", not "Accepted"
MemoryRouter.psm1 Implementation	🔴 BLOCKED	No MemoryRouter.psm1 found in scripts/lib/
Memory Router Integration Tests	🔴 BLOCKED	Cannot verify without MemoryRouter.psm1
skillbook.md Updates	🟡 PARTIAL	Can draft changes but cannot complete
memory.md Updates	🟡 PARTIAL	Can draft changes but cannot complete
retrospective.md Updates	🟡 PARTIAL	Can draft changes but cannot complete

Verdict: BLOCKED - Dependencies not met. ADR-037 must be approved and MemoryRouter.psm1 must be implemented before agent prompt updates can proceed.

Blocking Questions (CRITICAL)

1. ADR-037 Location: File .agents/architecture/ADR-037-memory-router-architecture.md not found. Create or provide location.
2. MemoryRouter.psm1: Not in scripts/lib/. Is there a tracking issue for implementation?
3. Session 123: Referenced as Phase 2A foundation but not found. Clarify what was completed.

Key Findings

• retrospective.md has 6 cloudmcp-manager references (lines 43, 809, 829, 1235, 1249, 1260)
• skillbook.md uses manual 70% keyword overlap for deduplication (should use cosine 0.7)
• memory.md has no semantic search capability (lexical only via ADR-017 tiered index)

Implementation Phases

Phase	Agent	Effort	Status
0	Dependencies (ADR-037, MemoryRouter.psm1, tests)	External	BLOCKED
1	skillbook.md	S	DEPENDS on Phase 0
2	memory.md	S	DEPENDS on Phase 0
3	retrospective.md	M	DEPENDS on Phase 0

---

_{Generated by AI PRD Generation | View Workflow}

[github-actions]

AI Triage Summary

Note

This issue has been automatically triaged by AI agents

What is AI Triage?

This issue was analyzed by AI agents:

• Analyst Agent: Categorizes the issue and suggests appropriate labels
• Roadmap Agent: Aligns the issue with project milestones and priorities
• Explainer Agent (if escalated): Generates comprehensive PRD

Triage Results

Property	Value
Category	enhancement
Labels	["enhancement","agent-memory","agent-retrospective","area-prompts"]
Priority	P1
Milestone	Not assigned
PRD Escalation	Generated (see below)

Categorization Analysis

```json
{
  "labels": ["enhancement", "agent-memory", "agent-retrospective", "area-prompts"],
  "category": "enhancement",
  "confidence": 0.95,
  "reasoning": "Issue requests updating agent prompts (skillbook.md, memory.md, retrospective.md) to use a new Memory Router interface after ADR-037 implementation"
}

</details>

<details>
<summary>Roadmap Alignment</summary>

```json
```json
{
  "milestone": "",
  "priority": "P1",
  "epic_alignment": "",
  "confidence": 0.65,
  "reasoning": "Feature request with multiple dependencies (ADR-037 approval, MemoryRouter implementation); blocked until prerequisites complete",
  "escalate_to_prd": true,
  "escalation_criteria": ["feature_request", "external_dependency", "multi_phase_work"],
  "complexity_score": 9
}

</details>

---

<sub>Powered by [AI Issue Triage](https://github.com/rjmurillo/ai-agents) workflow</sub>