← ClaudeAtlas

hex-project-setuplisted

Use when laying a hexagonal project down once — which libraries its core, its entrypoints, its stores and its features bring, the floors this family's templates rely on, and the Alembic bootstrap the revision chain cannot start without (config, environment, and a baseline only over a schema that already exists). The src layout, ruff and mypy, the line length and the dependency-floor discipline every Python project shares are `python-toolchain`'s. Never per feature — the per-change migration revision is `hex-persistence`, runtime DI bindings are `hex-wiring`, and what a settings class declares is `python-settings`.
wntic/pyhouse · ★ 3 · AI & Automation · score 76
Install: claude install-skill wntic/pyhouse
# Hexagonal Project Setup — dependency substrate, migration bootstrap What a hexagonal project needs *once*, beyond the toolchain every Python project carries: the libraries its layers bring, and the migration bootstrap. None of it recurs per feature. The project file itself — src layout, ruff, mypy, dependency declarations — is `python-toolchain`'s; the derivation rules that do recur are `hex-conventions`; the layer boundaries are `hex-architecture`. ## When to use vs. neighbours - Adding a dependency, or justifying one of this family's floors → block A. - Laying migrations for the first time on a project that has none → block B. - The `pyproject.toml` tables, the src layout, the linter and type checker, the sanctioned suppressions, the line length, and whether any dependency may carry a floor → `python-toolchain`. - The *per-change* migration revision that pairs with a schema edit → `hex-persistence`, not here; this skill covers only the bootstrap that lets the chain start. - Where a file goes and what it is called → `hex-conventions`. - Layer boundaries → `hex-architecture`; packaging mechanics → `python-packaging`. - Module files, `__all__` and the re-export contract inside the package → `python-packaging`. - The runtime DI bindings → `hex-wiring`; the environment-backed settings classes → `python-settings`, each shown beside the adapter that reads it. This skill stops at which libraries exist. - The interpreter floor → `python-style`. - Whether the project should