memento_onboarding

Provides onboarding guidance for Memento's long-term memory system, including retrieval workflows, storage protocols, and best practices for cross-session knowledge management.

Instructions

Get comprehensive onboarding protocol for Memento including tool usage guidance, retrieval flow optimization, and best practices.

MEMENTO ONBOARDING PROTOCOL:

INITIALIZATION: Run memento_onboarding() at session start
RETRIEVAL FLOW:
- Fact Check: Use search_mementos(tags=[...]) for simple identity/known facts
- Complex Tasks: Use recall_mementos(query="...") for dev/architecture context
- Fallback: If search fails, fallback to recall
AUTOMATIC STORAGE: Store via store_memento on git commits, bug fixes, version releases
ON-DEMAND TRIGGERS: Store instantly when user says "memento...", "remember...", etc.
MEMORY SCHEMA: Required tags (project, tech, category). Importance: 0.8+ (critical), 0.5 (standard)

OPTIMIZED RETRIEVAL (Avoid 6+ tool calls):

Target: 1-3 tool calls for simple info
Maximum: 5 tool calls for complex tasks
Follow decision tree: Known tags → search_mementos, Conceptual → recall_mementos

CRITICAL DISTINCTION: Memento vs Session memory

Memento: Long-term, cross-session, global scope
Session Memory: Temporary, project-specific, session-only

USE memento_onboarding(topic="...") for specific guidance:

"protocol": Full onboarding protocol
"retrieval_flow": Optimized retrieval guide
"distinction": Memento vs Session memory
"examples": Practical examples
"best_practices": Usage guidelines

Input Schema

TableJSON Schema

Name	Required	Description	Default
`topic`	No	Specific topic for onboarding guidance	onboarding

Implementation Reference

src/memento/tools/guide_tools.py:13-40 (handler)

The primary handler for the 'memento_onboarding' tool, which processes the tool call and returns the onboarding content based on the specified topic.

async def handle_memento_onboarding(
    context: Any, arguments: Dict[str, Any]
) -> CallToolResult:
    """
    Handle memento_onboarding tool call.

    Provides comprehensive onboarding protocol for Memento including
    tool usage guidance, retrieval flow optimization, and best practices.

    Args:
        context: Tool context with database and configuration
        arguments: Tool arguments including optional topic

    Returns:
        CallToolResult with onboarding content
    """
    topic = arguments.get("topic", "onboarding")

    onboarding_content = _generate_onboarding_content(topic)

    return CallToolResult(
        content=[
            TextContent(
                type="text",
                text=onboarding_content,
            )
        ]
    )

src/memento/tools/definitions.py:18-22 (registration)

The tool registration where 'memento_onboarding' is defined, including its description, input schema, and purpose.

            name="memento_onboarding",
            description="""Get comprehensive onboarding protocol for Memento including tool usage guidance, retrieval flow optimization, and best practices.

MEMENTO ONBOARDING PROTOCOL:
1. INITIALIZATION: Run memento_onboarding() at session start

MCP Memento