codenavi

Investigates unfamiliar codebases and implements surgical changes while maintaining a persistent .notebook/ knowledge base.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Peterson-Benhame/agent-skills --skill codenavi-peterson-benhame
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codenavi
Source: https://github.com/Peterson-Benhame/agent-skills/tree/main/packages/skills-catalog/skills/%28development%29/codenavi
Command: npx skills add https://github.com/Peterson-Benhame/agent-skills --skill codenavi-peterson-benhame

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working in unfamiliar, messy, or undocumented codebases forces developers to rediscover the same flows, gotchas, and conventions repeatedly, and AI assistants often guess or invent answers instead of verifying them. ## Core Features & Use Cases - Structured Mission Cycle: Follows a six-phase workflow (Briefing, Recon, Plan, Execute, Verify, Debrief) so every bug fix, feature, or investigation is planned and verified before changes land. - Persistent .notebook/ Knowledge Base: Captures flows, patterns, gotchas, and domain terms as pointer-based notes indexed in INDEX.md, so discoveries survive across sessions. - Knowledge Verification Chain: Verifies APIs and framework behavior against project docs, Context7 MCP, or web search instead of relying on training memory, and explicitly flags uncertainty. - Use Case: A developer reports a 500 error when applying a coupon in an unfamiliar project. The skill traces the checkout flow, finds a snake_case/camelCase schema mismatch, proposes a verified fix plan, and documents the API convention in .notebook/ for future sessions. ## Quick Start Ask the agent to fix a bug, implement a feature, or explain how a flow works in your current codebase, and it will investigate, plan, execute, and record its findings in .notebook/.

Frequently Asked Questions about codenavi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a bug in an unfamiliar codebase with an AI agent?

Describe the bug and its symptoms, and the agent reads .notebook/INDEX.md, traces the relevant flow from the nearest entry point, presents a plan with verification steps, and only executes after your approval. Discovered context is saved for future sessions.

What is the .notebook/ directory and how does it work?

The .notebook/ directory is a persistent knowledge base with an INDEX.md index and individual notes for flows, patterns, gotchas, and domain terms. Notes use pointers like file.ts:functionName() instead of copied code, and are created during the Debrief phase when something cost investigation effort.

Does codenavi work with MCP servers like Context7?

Yes, it prioritizes summoning available skills and MCP servers before struggling alone. Context7 is the preferred source for current library and framework documentation, falling back to web search and finally to explicitly flagged uncertainty.

When should I not use codenavi?

Do not use it for greenfield project scaffolding, CI/CD pipeline setup, or infrastructure provisioning. It is designed for working within existing codebases: bug fixes, features, refactoring, and flow investigation.

How does codenavi avoid making up incorrect API usage?

It follows a Knowledge Verification Chain: check .notebook/, then project docs, then Context7 MCP, then web search. If none resolve the question, it states its uncertainty explicitly rather than presenting guesses as fact.