Skip to Content
Skillsnav-graph

nav-graph

Queries and maintains the project knowledge graph — unified search across tasks, SOPs, system docs, and experiential memories.

Triggers

Natural-language phrases that auto-invoke the skill:

  • “What do we know about X?”
  • “Show everything related to X”
  • “Any pitfalls for X?”
  • “What decisions about X?”
  • “Remember this pattern/pitfall/decision/learning: …”
  • “Initialize knowledge graph”
  • “Show graph stats”

What it does

  • QUERY: loads .agent/knowledge/graph.json (~1-2k tokens) and returns matching tasks, SOPs, memories, and files for a concept
  • CAPTURE: parses your input into a memory typed as pattern, pitfall, decision, or learning, with auto-extracted concepts and a confidence score
  • INIT / rebuild: scans .agent/ to build the graph, extracting concepts and relationships from existing docs
  • STATS: reports node/edge/memory counts by type
  • RELATED: traverses the graph from a node (e.g. TASK-29) to find connected items
  • CONTRADICTIONS (v7.1.0): decisions may carry the TRIZ contradiction they resolved (--contradiction "A vs B" --separation time|space|condition|level --principle "..."); --action contradictions --filter "<terms>" answers “how did we resolve this shape of problem before?”, and tagged memories render with a ↔ A vs B suffix at session start
  • RECONCILE syncs hand-tagged footer fields disk → graph (--execute --fields-only when your resolved/ archive holds pruned memories)
  • Applies a confidence system — base 0.8-0.9, +5% per use, manual decay/pruning via graph_maintenance
  • Integrates with nav-start (surfaces relevant memories), nav-task (concept extraction), and nav-profile (corrections become memories)

Example

"What do we know about authentication?"

Returns related tasks, captured pitfalls and decisions, matching SOPs, and relevant files — then offers to load any item in detail.

"Remember we decided to ship the new gate OFF by default — feature value vs regression risk, resolved by condition"

Captures a decision tagged with its contradiction. Later, --action contradictions --filter risk returns it with the separation mode and principle.

nav-sopnav-deep-research