Code Context Finder

Overview

• Knowledge graph entities: Prior decisions, project context, related concepts
• Code relationships: Dependencies, imports, function calls, class hierarchies

When to Use (Smart Detection)

references/detection_triggers.md

Core Workflow

1. Detect Context Need

Signals to watch:
- New/unfamiliar file opened
- Error messages mentioning unknown components
- Questions about "why" or "how" something works
- Changes to shared/core modules
- Architectural or design discussions

2. Search Knowledge Graph

# Search for related context
mcp__memory__search_nodes(query="<topic>")

# Open specific entities if known
mcp__memory__open_nodes(names=["entity1", "entity2"])

# View relationships
mcp__memory__read_graph()

• Module/file names → project context
• Error types → past issues, solutions
• Feature names → prior decisions, rationale
• People names → ownership, expertise

3. Analyze Code Relationships

# Find what imports this module
grep -r "from module import" --include="*.py"
grep -r "import module" --include="*.py"

# Find function callers
grep -r "function_name(" --include="*.py"

# Find class usages
grep -r "ClassName" --include="*.py"

# Find test coverage
find . -name "*test*.py" -exec grep -l "module_name" {} \;

references/search_patterns.md

4. Synthesize Context

## Context Found

**Knowledge Graph:**
- [Entity]: Relevant observation
- [Decision]: Prior architectural choice

**Code Relationships:**
- Imported by: file1.py, file2.py
- Depends on: module_a, module_b
- Tests: test_module.py (5 tests)

**Suggested Actions:**
- Review [entity] before modifying
- Consider impact on [dependent files]

Quick Reference

Knowledge Graph Queries

search_nodes("project-name")

search_nodes("decision")

search_nodes("<feature>")

search_nodes("<concept>")

search_nodes("<person-name>")

read_graph()

Code Relationship Queries

grep -r "from X import|import X"

grep -r "function("

grep -r "def function|class Class"

find -name "*test*" -exec grep -l "X"

grep -r "X" *.json *.yaml *.toml

Integration with Coding Workflow

Before Making Changes

1. Check knowledge graph for context on module/feature
2. Find all files that import/depend on target
3. Locate relevant tests
4. Review prior decisions if architectural

After Making Changes

1. Update knowledge graph if significant decision made
2. Note new patterns or learnings
3. Add observations to existing entities

When Debugging

1. Search knowledge graph for similar errors
2. Find all code paths to affected component
3. Check for related issues/decisions
4. Document solution if novel

Resources

references/

• detection_triggers.md

  - Detailed trigger patterns for smart detection

• search_patterns.md

  - Common search patterns for code relationships

scripts/

• find_code_relationships.py

  - Analyze imports, dependencies, and call graphs