semantic-clusters

What problem does it solve?

Understanding a codebase’s capabilities is hard when only the filesystem layout is visible, leading to missed functionality, hidden gaps, and confusing architectural decisions.

Core Features & Use Cases

• Behavioral Architecture Map: Generates a markdown map that groups every significant component by action‑verb clusters, revealing what the system can do.
• Cross‑Cluster Insight: Identifies components that belong to multiple clusters, highlighting integration points and architectural concerns.
• Orphan Detection & Health Assessment: Flags directories not represented in any cluster and provides health emojis with concise audit notes.
• Use Cases: Quickly onboard new engineers, plan refactors, audit feature coverage, or create status documents that focus on system behavior rather than file locations.

Quick Start

Generate a semantic cluster map for the repository at /path/to/repo.