serena-lsp-integration

name	serena-lsp-integration
description	настрой Serena LSP: индексация, project.yml, semantic analysis. Используй для: Serena config. EN: semantic index, LSP keys.

Serena LSP Integration

Purpose

Keep Serena MCP usage aligned with real language-server support. Use Serena for semantic inspection and editing where supported, and fall back honestly where a file type is not Serena-native.

Workflow

1. Inspect project evidence: manifests, build files, lockfiles, and source files.
2. Read references/serena-lsp-integration.md when exact Serena keys or limitations matter.
3. Map supported languages to Serena keys: python, typescript, rust, dart, go, cpp, yaml, bash, json, toml, markdown.
4. Treat C and C++ as cpp; treat JavaScript as typescript.
5. Treat HTML, CSS, Docker, and QML as external LSP areas unless current Serena docs prove native support.
6. Check health and prerequisites before expecting reliable semantic behavior.
7. Recommend serena project index after language configuration changes.

Configuration Policy

Do not silently modify .serena/project.yml. Explain or apply changes only when the user explicitly asks for setup. Full project initialization belongs to the rldyour-flow plugin.

Use .serena/project.local.yml for machine-local executable paths. Use committed .serena/project.yml only for portable project settings.

Serena Tool Priority

For supported code files, use the existing Serena-first workflow:

1. initial_instructions
2. list_memories
3. relevant read_memory
4. get_symbols_overview
5. targeted find_symbol
6. find_referencing_symbols
7. search_for_pattern only for broad text sweeps or unsupported file types

For unsupported files, state the limitation and use direct reads, search, external validation, or browser/design/security plugins as appropriate.