convez.ai
PluginDesenvolvimento WebIntermediário
TarrySingh

Hulde Review

TarrySingh/hulde-review

Transforme seu código em grafo de conhecimento explorável com análise inteligente de arquitetura

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin Claude Code que transforma qualquer codebase em um grafo de conhecimento interativo. Analisa arquitetura, dependências e padrões usando IA + AST parsing (tree-sitter), fornecendo mapas visuais, resumos em linguagem natural, análise de impacto de PRs e busca semântica.

Instalação

$npx convez-ai TarrySingh/hulde-review

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Onboarding de novos desenvolvedores em projetos complexos
  • Análise de impacto de mudanças antes de mergear PRs
  • Documentação automática e visual da arquitetura
  • Compreensão rápida de dependências e fluxos entre módulos

Veredito

Ferramenta sólida de análise estática elevada por IA, reduzindo friction na compreensão de codebases grandes. O pipeline multi-agente (7 fases) é robusto, e a UI adaptativa por persona é prática. Recomendado para times que trabalham com legado ou onboarding constante.

README

A tradução para o português deste README ainda está na fila.


What is Hulde Review?

Hulde Review is a Claude Code plugin that analyzes any codebase and produces an interactive knowledge graph — a living map of your project's architecture, dependencies, and patterns. It combines LLM intelligence with static analysis (tree-sitter AST parsing) to give you:

  • Visual architecture maps — See how files, functions, classes, and modules connect
  • Plain-English summaries — Every node in the graph gets a human-readable explanation
  • Guided tours — Auto-generated walkthroughs ordered by dependency (start from the roots, work your way up)
  • Diff impact analysis — Understand what a PR actually touches across the architecture
  • Fuzzy + semantic search — Find anything in the graph by name or concept
  • Persona-adaptive UI — Junior dev? PM? Architect? The dashboard adjusts detail level to match
  • Architectural layer detection — API, Service, Data, UI, Utility layers auto-classified
  • 12 programming patterns explained in context

All powered by a 7-phase multi-agent pipeline running inside Claude Code.


Quick Start

Option 1 — Install from Claude Marketplace

/plugin marketplace add tarrysingh/hulde-review
/plugin install hulde-review

Option 2 — Install from GitHub

# Clone the repo
git clone https://github.com/tarrysingh/hulde-review.git

# Launch Claude Code with the plugin loaded
claude --plugin-dir ./hulde-review/hulde-review-plugin

Option 3 — Shell Alias (recommended for daily use)

Add this to your ~/.zshrc or ~/.bashrc:

alias claude-hulde='claude --plugin-dir /path/to/hulde-review/hulde-review-plugin'

Then from any project:

cd your-project
claude-hulde

Commands

Once the plugin is loaded, you get six slash commands:

CommandWhat it does
/hulde-reviewRun the full 7-phase analysis pipeline on the current codebase
/hulde-dashboardLaunch the interactive web dashboard to visualize the knowledge graph
/hulde-chat [query]Ask natural-language questions about the codebase using the graph
/hulde-diffAnalyze staged changes or a PR against the knowledge graph
/hulde-explain [path]Deep-dive explanation of a specific file, function, or module
/hulde-onboardGenerate a structured onboarding guide for new team members

Your first analysis

> /hulde-review

That's it. The pipeline will:

  1. SCAN — Discover project structure, languages, and entry points
  2. ANALYZE — Parse each file with tree-sitter + LLM for summaries and relationships
  3. ASSEMBLE — Merge all file-level graphs into a unified knowledge graph
  4. ARCHITECTURE — Detect layers, patterns, and architectural boundaries
  5. TOUR — Generate guided walkthroughs using topological sort
  6. REVIEW — Validate graph completeness and fix orphan nodes
  7. SAVE — Write knowledge-graph.json to .hulde-review/

The dashboard launches automatically when the analysis completes.


Dashboard

The interactive dashboard runs locally at localhost:5173 (or the next available port) and gives you:

Graph View

An interactive node-link diagram powered by React Flow. Nodes represent files, functions, classes, and modules. Edges show dependencies, calls, imports, and inheritance. Drag, zoom, and click to explore.

Search

Fuzzy search (Fuse.js) finds nodes by name, path, or description. Start typing and results appear instantly.

Guided Tours

Auto-generated walkthroughs that start from the dependency roots and work upward. Each step includes a plain-English explanation of what the component does and why it matters.

Layer Visualization

Toggle architectural layers on/off to focus on specific parts of the stack:

  • API — Routes, endpoints, controllers
  • Service — Business logic, orchestration
  • Data — Models, repositories, database access
  • UI — Components, views, templates
  • Utility — Helpers, shared libraries, config

Persona Selector

Switch between detail levels:

  • Junior — More context, simpler language, pattern explanations
  • Senior — Concise, architecture-focused
  • PM — High-level system overview, no code details

Diff Overlay

Visualize which parts of the architecture are affected by recent changes. Red = modified, yellow = impacted downstream.


How It Works

┌──────────────────────────────────────────────────────┐
│                   Claude Code CLI                     │
│                                                       │
│  /hulde-review                                        │
│       │                                               │
│       ▼                                               │
│  ┌─────────┐  ┌──────────┐  ┌──────────┐            │
│  │  SCAN   │→ │ ANALYZE  │→ │ ASSEMBLE │            │
│  │ scanner │  │ per-file │  │  merge   │            │
│  └─────────┘  └──────────┘  └──────────┘            │
│       │                           │                   │
│       ▼                           ▼                   │
│  ┌──────────┐  ┌────────┐  ┌──────────┐            │
│  │ ARCHITECT│→ │  TOUR  │→ │  REVIEW  │→ SAVE      │
│  │  layers  │  │ guided │  │ validate │  .json      │
│  └──────────┘  └────────┘  └──────────┘            │
│                                                       │
│  /hulde-dashboard ──→ localhost:5173                  │
│  /hulde-chat ──→ graph-powered Q&A                   │
│  /hulde-diff ──→ PR impact analysis                  │
│  /hulde-explain ──→ deep-dive on any component       │
│  /hulde-onboard ──→ new-hire onboarding guide        │
└──────────────────────────────────────────────────────┘

Knowledge Graph Schema

The graph contains 5 node types and 18 edge types:

Nodes:

TypeDescription
fileSource files with language, path, and summary
functionFunctions and methods with signatures
classClasses and interfaces with properties
moduleLogical groupings (packages, namespaces)
conceptArchitectural patterns and design concepts

Edge Categories:

CategoryEdge Types
Structuralcontains, exports, declares
Dependencyimports, depends-on, uses
Inheritanceextends, implements, mixes-in
Runtimecalls, instantiates, emits, listens
Conceptualrelated-to, pattern-of, layer-of, documented-by, tested-by, configured-by

Tech Stack

LayerTechnology
AnalysisTree-sitter WASM + Claude LLM
Graph SchemaZod 4 validation
SearchFuse.js (fuzzy) + cosine similarity (semantic)
DashboardReact 18 + React Flow + Zustand 5
StylingTailwind CSS v4 (Hulde green #00A651)
BuildVite + TypeScript + pnpm workspaces
StalenessGit-based incremental updates

Who Is This For

Engineers & Developers

  • Visualize the architecture of any codebase before diving into code
  • Understand how components connect before making changes
  • Review PRs with full architectural context via /hulde-diff
  • Onboard onto new projects in minutes instead of days

Tech Leads & Architects

  • Validate that the actual architecture matches the intended design
  • Identify orphaned modules, circular dependencies, and structural debt
  • Generate architecture documentation that stays in sync with the code

Product Managers & Designers

  • Understand how systems work without reading source code
  • See the scope and impact of proposed changes
  • Get plain-English explanations of technical components

Educators & Students

  • Learn real-world architecture patterns from actual codebases
  • Follow guided tours that explain systems from the ground up
  • Explore 12 programming patterns identified in context

Project Structure

hulde-review/
├── .claude-plugin/
│   ├── plugin.json              # Plugin manifest
│   └── marketplace.json         # Marketplace listing
├── hulde-review-plugin/
│   ├── skills/
│   │   ├── hulde-review/        # Main analysis pipeline (7 phases)
│   │   ├── hulde-chat/          # Graph-powered Q&A
│   │   ├── hulde-dashboard/     # Dashboard launcher
│   │   ├── hulde-diff/          # Diff impact analysis
│   │   ├── hulde-explain/       # Deep-dive explanations
│   │   └── hulde-onboard/       # Onboarding guide generator
│   ├── agents/
│   │   └── knowledge-graph-guide.md
│   ├── packages/
│   │   ├── core/                # Graph types, schema, search, persistence
│   │   └── dashboard/           # React + Vite interactive visualization
│   └── src/                     # Skill runtime helpers
├── CLAUDE.md                    # Project instructions for Claude Code
└── README.md                    # You are here

Configuration

Incremental Updates

Hulde Review is incremental by default. After the first full analysis, subsequent runs only re-analyze files that changed (detected via git diff). Force a full rebuild with:

/hulde-review --full

Scoped Analysis

Analyze a specific subdirectory:

/hulde-review src/api

Output Location

All analysis artifacts are written to .hulde-review/ in the project root:

.hulde-review/
├── knowledge-graph.json    # The full knowledge graph
├── hr-scan-*.json          # Phase 1 scan results
├── hr-analysis-*.json      # Phase 2 per-file analysis
└── hr-tour-*.json          # Phase 5 guided tours

Add .hulde-review/ to your .gitignore — it's generated output.


Development

Prerequisites

Building from Source

git clone https://github.com/tarrysingh/hulde-review.git
cd hulde-review

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run the dashboard dev server standalone
pnpm dashboard:dev

Running Tests

pnpm test

Marketplace Distribution

For Teams (Custom Marketplace)

Add the marketplace to your Claude Code config:

/plugin marketplace add tarrysingh/hulde-review
/plugin install hulde-review

Or add it to your project's .claude/settings.json so every team member gets it automatically:

{
  "extraKnownMarketplaces": {
    "hulde-review": {
      "source": {
        "source": "github",
        "repo": "tarrysingh/hulde-review"
      }
    }
  },
  "enabledPlugins": {
    "hulde-review@hulde-review": true
  }
}

For Everyone (Official Marketplace)

Hulde Review is also available on the Claude Plugin Marketplace:

/plugin install hulde-review

Part of the Hulde Platform

Hulde Review is a module of hulde.ai — an agentic AI-powered edtech platform for developers and engineers. The platform includes:

  • Hulde Learn — AI-driven personalized learning paths
  • Hulde Review — Codebase analysis and visualization (this plugin)
  • Hulde Agent — Autonomous coding assistants

Visit enterprise.hulde.ai for the full platform experience.


Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

MIT License — see LICENSE for details.


Ver o original no GitHub

Bom para

Relacionados