Hulde Review
TarrySingh/hulde-review
Transforme seu código em grafo de conhecimento explorável com análise inteligente de arquitetura
Ver no GitHubPlugin 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-review1 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
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:
| Command | What it does |
|---|---|
/hulde-review | Run the full 7-phase analysis pipeline on the current codebase |
/hulde-dashboard | Launch the interactive web dashboard to visualize the knowledge graph |
/hulde-chat [query] | Ask natural-language questions about the codebase using the graph |
/hulde-diff | Analyze staged changes or a PR against the knowledge graph |
/hulde-explain [path] | Deep-dive explanation of a specific file, function, or module |
/hulde-onboard | Generate a structured onboarding guide for new team members |
Your first analysis
> /hulde-review
That's it. The pipeline will:
- SCAN — Discover project structure, languages, and entry points
- ANALYZE — Parse each file with tree-sitter + LLM for summaries and relationships
- ASSEMBLE — Merge all file-level graphs into a unified knowledge graph
- ARCHITECTURE — Detect layers, patterns, and architectural boundaries
- TOUR — Generate guided walkthroughs using topological sort
- REVIEW — Validate graph completeness and fix orphan nodes
- SAVE — Write
knowledge-graph.jsonto.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:
| Type | Description |
|---|---|
file | Source files with language, path, and summary |
function | Functions and methods with signatures |
class | Classes and interfaces with properties |
module | Logical groupings (packages, namespaces) |
concept | Architectural patterns and design concepts |
Edge Categories:
| Category | Edge Types |
|---|---|
| Structural | contains, exports, declares |
| Dependency | imports, depends-on, uses |
| Inheritance | extends, implements, mixes-in |
| Runtime | calls, instantiates, emits, listens |
| Conceptual | related-to, pattern-of, layer-of, documented-by, tested-by, configured-by |
Tech Stack
| Layer | Technology |
|---|---|
| Analysis | Tree-sitter WASM + Claude LLM |
| Graph Schema | Zod 4 validation |
| Search | Fuse.js (fuzzy) + cosine similarity (semantic) |
| Dashboard | React 18 + React Flow + Zustand 5 |
| Styling | Tailwind CSS v4 (Hulde green #00A651) |
| Build | Vite + TypeScript + pnpm workspaces |
| Staleness | Git-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
- Node.js 20+
- pnpm 9+
- Claude Code CLI
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.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
MIT License — see LICENSE for details.