EXPLORE

Project Exploration & Knowledge Indexing

Explore the current project, index key information to memory, and optionally update CLAUDE.md.

Instructions

Perform a comprehensive project exploration and knowledge update:

Phase 1: Gather Current State

1. Get project metadata:

   # Package info
   cat package.json | head -30
   
   # Git status
   git log --oneline -10
   git status --short
   

2. Count and analyze source files:

   # TypeScript files
   find src -name "*.ts" | wc -l
   
   # Test files
   find src -name "*.test.ts" | wc -l
   

3. Check for recent changes:

   git diff --stat HEAD~5
   

4. Review key entry points:

   • Read src/memory/index.ts
   • Check src/memory/server/toolDefinitions.ts for tool count
   • Scan for new files not in CLAUDE.md

Phase 2: Update Knowledge Graph

1. Search for existing project entity:

   • Use search_nodes with "memory-mcp"

2. Create or update project entity:

   • If not exists: Create entity with type "project"
   • Add observations about current state:
     • Version number
     • Tool count
     • Test count
     • Recent changes summary
     • Key architectural patterns

3. Create entities for new components:

   • Any new managers or major classes
   • New tool categories
   • New features discovered

4. Update relations:

   • Connect components to the main project
   • Map dependencies between modules

Phase 3: CLAUDE.md Update (if --update-claude-md)

If --update-claude-md flag is provided, analyze and update CLAUDE.md:

1. Check for discrepancies:

   • Version number in package.json vs CLAUDE.md
   • Tool count (grep toolDefinitions.ts vs documented 47)
   • Test count (run quick test --dry-run or count test files)
   • File counts per module
   • Dependencies in package.json vs documented

2. Update outdated sections:

   • Version numbers
   • Tool counts
   • Test statistics
   • Dependency versions
   • New slash commands in commands list