tools-only Navigator v5.2.0 Release Notes
Release Date: 2025-01-20 Type: Minor Release (Positioning + Documentation)
Summary
Navigator v5.2.0 introduces the "Finish What You Start" positioning—a complete README rewrite focused on the core value proposition: sessions that actually complete without crashing.
New Positioning
# Navigator
**Finish What You Start**
Sessions that last. AI that learns. Features that ship.
The Problem We Solve
Sessions crash at exchange 5-7 because context fills with documentation you never use.
The Solution
Navigator implements context engineering—load what you need, when you need it.
| Metric | Without Navigator | With Navigator |
|---|---|---|
| Tokens loaded | 150,000 | 12,000 |
| Session length | 5-7 exchanges | 20+ exchanges |
| Context at end | 95% (crashed) | 35% (comfortable) |
| Token savings | — | 92% |
README Rewrite
Complete rewrite from 1,200 lines to 190 lines.
Before: Feature-heavy, technical documentation After: Benefit-first, scannable, outcome-focused
New Structure
- The Loop You're Stuck In — Problem statement
- Break The Loop — Solution with metrics
- And Your AI Gets Smarter — ToM differentiation
- Same Workflows. More Capabilities — Superset positioning
- Proof, Not Promises — OpenTelemetry verification
- Quick Start — Installation
- Stop Restarting. Start Shipping — CTA
Superset Positioning
Navigator is positioned as a superset—everything competitors offer, plus context engineering.
| Feature | Navigator | Others |
|---|---|---|
| Structured workflows | ✅ 23 skills | ✅ |
| Component generation | ✅ | ✅ |
| Test generation | ✅ | ✅ |
| Session longevity | 20+ exchanges | 5-7 exchanges |
| Token savings | 92% verified | None |
| Theory of Mind | ✅ | ❌ |
| Loop mode | ✅ | ❌ |
| OpenTelemetry metrics | ✅ | ❌ |
| Figma MCP integration | ✅ | ❌ |
Files Changed
| File | Change |
|---|---|
README.md |
Complete rewrite (1200 → 190 lines) |
CLAUDE.md |
Updated header and tagline |
.claude-plugin/marketplace.json |
Version bump to 5.2.0 |
.claude-plugin/plugin.json |
Version bump to 5.2.0 |
.agent/.nav-config.json |
Version bump to 5.2.0 |
Upgrade Path
From v5.1.0: No breaking changes. Documentation only.
- Update plugin:
/plugin update navigator - Optional: Run
nav-update-claudeto get new CLAUDE.md template
Backward compatible: All v5.1.0 features continue unchanged.
Version History
v5.2.0 (This Release)
- NEW: "Finish What You Start" positioning
- REWRITTEN: README.md (1200 → 190 lines)
- UPDATED: CLAUDE.md with new tagline
- UPDATED: Superset comparison table
v5.1.0
- Loop Mode with structured completion signals
- Dual-condition exit gate
- Stagnation detection
v5.0.0
- Theory of Mind integration
- nav-profile, nav-diagnose skills
- Verification checkpoints
Full Changelog: https://github.com/alekspetrov/navigator/compare/v5.1.0...v5.2.0