twining-mcp CLAUDE.md

Claude Code Project Instructions

Serena MCP Best Practices

This project uses the Serena MCP server for intelligent code navigation and editing. Follow these guidelines to maximize efficiency.

Code Navigation Principles

Prefer symbolic tools over file reads:

• Use get_symbols_overview first to understand a file's structure
• Use find_symbol with include_body=false to explore before reading
• Only use include_body=true when you need the actual implementation
• Avoid reading entire files unless absolutely necessary

Symbol discovery workflow:

1. Start with get_symbols_overview for file structure
2. Use find_symbol with depth=1 to see class members
3. Use find_referencing_symbols to understand usage patterns
4. Only then read specific symbol bodies you need

Search Strategy

Use the right tool for the job:

• find_symbol - When you know the symbol name (supports substring matching)
• search_for_pattern - For arbitrary text patterns, non-code files, or unknown symbol names
• find_file - When looking for files by name/mask
• list_dir - For directory structure exploration

Pattern search tips:

• Always pass relative_path when you know the scope
• Use restrict_search_to_code_files=true for code-only searches
• Use context_lines_before/after sparingly to save tokens

Editing Guidelines

Symbol-based editing (preferred):

• Use replace_symbol_body for modifying entire methods/functions/classes
• Use insert_after_symbol to add code after a symbol
• Use insert_before_symbol to add imports or code before a symbol
• Always check references with find_referencing_symbols before renaming

When to use file-based editing:

• Small inline changes within a large method
• Non-code files (config, markdown, etc.)
• Files without clear symbol structure

Memory System

Reading memories:

• Check list_memories for available project knowledge
• Read memories that match your current task
• Don't read the same memory twice in a conversation