hex-analyze-arch

Analyzes hexagonal architecture health in TypeScript and Rust codebases, detecting boundary violations, circular dependencies, and dead exports while creating HexFlo tasks and spawning fix agents.

4|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/gaberger/hex --skill hex-analyze-arch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hex-analyze-arch
Source: https://github.com/gaberger/hex/tree/main/.claude/skills/hex-analyze-arch
Command: npx skills add https://github.com/gaberger/hex --skill hex-analyze-arch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze hexagonal architecture health across a codebase and surface actionable violations and architectural hygiene issues that impede maintainability.

Core Features & Use Cases

  • End-to-end architecture health analysis that detects boundary violations, circular dependencies, and dead exports.
  • Automatic creation of HexFlo tasks and spawns fix agents when violations are found, reducing manual triage.
  • Report generation and actionable feedback integrated with git history for traceability.

Quick Start

Run a full hexagonal architecture health check on your repository and allow automatic fixes when violations are found.

Frequently Asked Questions about hex-analyze-arch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect hexagonal architecture boundary violations in my codebase?

Detect hexagonal architecture boundary violations by running an automated health check that analyzes your codebase to surface actionable hygiene issues. It identifies boundary violations, circular dependencies, and dead exports that impede maintainability.

Can I automatically fix circular dependencies and dead exports in TypeScript and Rust projects?

Yes, you can automatically fix circular dependencies and dead exports in TypeScript and Rust projects. When violations are found, the analysis automatically creates HexFlo tasks and spawns fix agents to resolve them, reducing manual triage.

What is hexagonal architecture health analysis and why is it needed?

Hexagonal architecture health analysis is an automated process that evaluates your codebase against architectural rules to find structural violations. It is needed to surface boundary violations, circular dependencies, and dead exports that impede codebase maintainability.

Does architecture analysis support generating reports integrated with git history?

Yes, architecture analysis supports generating reports integrated with git history for traceability. This provides actionable feedback and tracks the context of architectural hygiene issues across your codebase's evolution.

What's the best way to triage hexagonal architecture violations without manual effort?

The best way to triage hexagonal architecture violations without manual effort is to automate action-item extraction and task registration. The analysis auto-creates HexFlo tasks and spawns fix agents when it detects boundary violations or circular dependencies.