Files
ruflo/plugins/ruflo-knowledge-graph
Reuvenandclaude-flow f25bcf2073 feat: add 10 new ruflo plugins, optimize all 32, add READMEs and user guide
New plugins: ruflo-adr (ADR lifecycle), ruflo-ddd (domain-driven design),
ruflo-sparc (SPARC methodology), ruflo-neural-trader (trading strategies),
ruflo-ruvector (vector embeddings), ruflo-knowledge-graph (entity graphs),
ruflo-market-data (OHLCV ingestion), ruflo-migrations (schema management),
ruflo-observability (logging/tracing), ruflo-cost-tracker (token budgets).

Optimizations across all 32 plugins:
- All pass `claude plugin validate` (removed invalid manifest arrays)
- 51/51 skills have argument-hint frontmatter
- Model routing: 4 haiku, 24 sonnet, 2 opus (cost-optimized)
- Neural learning hooks on 25/30 agents
- Cross-references between 6 related plugin pairs
- Pathfinder graph traversal algo for researcher agent
- READMEs for all 32 plugins + plugins/README.md catalog
- discover-plugins skill updated with full 32-plugin catalog

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-04-29 23:46:54 -04:00
..

ruflo-knowledge-graph

Knowledge graph construction -- entity extraction, relation mapping, and pathfinder graph traversal.

Overview

Extracts entities (classes, functions, modules, types, concepts) and relations (imports, extends, implements, depends-on, calls) from source code and documentation. Builds a navigable knowledge graph stored in AgentDB with hierarchical nodes and causal edges. Traverses the graph using a pathfinder algorithm that scores paths by edge weight and semantic similarity.

Installation

claude --plugin-dir plugins/ruflo-knowledge-graph

Agents

Agent Model Role
graph-navigator sonnet Entity extraction, relation mapping, knowledge graph construction, pathfinder traversal

Skills

Skill Usage Description
kg-extract /kg-extract <path> Extract entities and relations from source files to build a knowledge graph
kg-traverse /kg-traverse <entity> [--depth N] Pathfinder traversal starting from a seed entity

Commands (5 subcommands)

kg extract <path>            # Extract entities and relations from source files
kg traverse <entity>         # Pathfinder traversal from a seed entity
kg relations <entity>        # List all direct relations for an entity
kg visualize                 # ASCII visualization of the knowledge graph
kg search <query>            # Semantic search across the graph

Entity Types

Type Examples
class UserService, AuthController
function calculateDiscount, handleRequest
module auth, payments, api
concept authentication, caching
type User, OrderStatus
config database, redis, jwt

Pathfinder Algorithm

  1. Seed -- start from the target entity node
  2. Expand -- follow causal edges outward (configurable depth, default 3)
  3. Score -- relevance = edge_weight * semantic_similarity(query, node)
  4. Prune -- remove paths below threshold (default 0.3)
  5. Rank -- return top-K paths by cumulative relevance
  • ruflo-ruvector -- HNSW indexing for fast semantic search across graph nodes
  • ruflo-adr -- ADR dependency graphs share the same causal edge model

License

MIT