hex-scaffold

Scaffold hexagonal architecture projects with domain, ports, adapters, and composition root.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold a Hexagonal Architecture project quickly and consistently, eliminating manual setup and architectural drift when starting new work.

Core Features & Use Cases

  • Interactive wizard to collect requirements and generate a compliant hexagonal skeleton (domain, ports, adapters, and composition root).
  • Default MVP scaffolds available with the --yes flag to skip interactive questions.
  • Enforces clean layering, cross-boundary import rules, and a ready-to-build starter that adapts to CLI or library-style projects.

Quick Start

Ask the AI to scaffold a new hexagonal architecture project, or run with --yes to generate a minimal MVP scaffold immediately.

Frequently Asked Questions about hex-scaffold

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

FAQPage Schema
How do I scaffold a hexagonal architecture project for a new CLI or library?

Hexagonal architecture scaffolding generates a project skeleton with domain, ports, adapters, and a composition root. It enforces clean layering, predictable layout, and minimal cross-boundary imports to prevent architectural drift when starting new work.

Can I generate a clean architecture skeleton without answering interactive prompts?

Yes, you can skip the interactive wizard by using the --yes flag to generate a minimal MVP scaffold immediately. This provides a compliant hexagonal architecture skeleton with default settings without requiring manual input.

Does the generated hexagonal architecture scaffold enforce cross-boundary import rules?

Yes, the scaffold enforces clean layering and cross-boundary import rules to maintain architectural integrity. This ensures the domain, ports, and adapters remain properly separated within the generated project structure.

What is the best way to set up a project with domain, ports, and adapters?

Using a hexagonal architecture scaffold is the best way to set up a project with domain, ports, and adapters. It eliminates manual setup and architectural drift by generating a predictable, ready-to-build starter project with a composition root.

When do I need to use a hexagonal architecture project generator?

You need a hexagonal architecture project generator when you want to eliminate manual setup and prevent architectural drift. It provides a predictable starter for CLI or library-style projects by generating a standardized layout with a composition root.