name: encode-repo-serena version: 1.0.0 description: Systematically populate the Forgetful knowledge base using Serena's LSP-powered symbol analysis for accurate, comprehensive codebase understanding. license: MIT model: claude-sonnet-4-5 metadata: argument-hint: 'Project path or name to encode (default: current directory)'

Encode Repository (Serena-Enhanced)

Transform an undocumented codebase into a rich, searchable knowledge repository using Serena's LSP-powered symbol analysis.

Quick Start

/encode-repo-serena
/encode-repo-serena ./my-project
"encode this repository"
"populate forgetful with this codebase"

Prerequisites

1. Serena plugin: claude plugins list | grep serena
2. Forgetful MCP: Test with execute_forgetful_tool("list_projects", {})
3. If missing, run /context-hub-setup first

Phase Overview

See references/phases.md for full phase details.

Memory Targets

Execution Order

0 → 1 → 1B → 2 → 2B → 3 → 4 → 5 → 6 → 6B → 7 → 7B

Guidelines:

• Execute phases in order
• Use Serena's find_symbol and find_referencing_symbols
• Deduplicate entities before creating
• Link entities to memories bidirectionally
• Create entry memories for documents

Quality Principles

Validation Checklist

After completion:

• Test memory search: "How do I add a new API endpoint?"
• Test dependency query: "What dependencies does this project use?"
• List entities by project
• Verify entity relationships
• Check Symbol Index document exists
• Check Architecture Reference document exists
• Verify project.notes populated

See references/validation.md for test commands.

References

Related Skills

• /context-hub-setup - Setup Forgetful MCP
• /using-forgetful-memory - Memory best practices
• /using-serena-symbols - Serena symbol analysis