How Navigator Works
Navigator is a context engineering system that dramatically improves Claude Code's efficiency.
Architecture
┌─────────────────────────────────────────────────────┐
│ Pilot Process │
├─────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Navigator │──│ Claude │──│ Executor │ │
│ │ Engine │ │ Code │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────┐ │
│ │ .agent/ Directory │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │ │
│ │ │ Index │ │ Tasks │ │ Knowledge │ │ │
│ │ │ Doc │ │ Docs │ │ Graph │ │ │
│ │ └─────────┘ └─────────┘ └─────────────┘ │ │
│ └─────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘Lazy Loading
Instead of loading everything at once:
- Start: Load only
DEVELOPMENT-README.md(~2k tokens) - On Demand: Load specific docs when referenced
- Cache: Keep frequently accessed docs in memory
- Prune: Remove unused docs after task completion
Knowledge Graph
Navigator maintains a knowledge graph that captures:
- Decisions: Why certain approaches were chosen
- Patterns: Reusable solutions discovered during development
- Pitfalls: Problems to avoid in future tasks
- Dependencies: Relationships between components
Session Markers
Navigator uses markers to:
- Save Progress: Create checkpoints before risky changes
- Resume Work: Continue from where you left off
- Share Context: Transfer knowledge between sessions
Integration with Pilot
When Pilot picks up a task:
1. Check for .agent/ directory
2. If found → Start Navigator session
3. Load index + task-specific docs
4. Execute with full context awareness
5. Update knowledge graph with learnings
6. Create PR with context-aware description