Agent skill · product strategy · jeremylongshore
hex-reference-architecture
Implement Hex reference architecture with best-practice project layout.
Why this skill is useful
Provides specific integration patterns and project structure for Hex applications that the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Hex Reference Architecture Architecture Project Structure Integration Patterns Pattern When Tool --------- ------ ------ CI-triggered refresh On deploy GitHub Actions Scheduled pipeline Daily/weekly reports Cron, Airflow On-demand run User-triggered analysis API endpoint Orchestrated pipeline Multi-step ETL Airflow, Dagster Overview This architecture separates project triggers, parameter validation, scoped execution, bounded orchestration, aggregate observability, and cancellation/rollback. Workspace data remains inside approved project boundaries and never becomes architectural telemetry. Prerequisites A project/data owner for each source, environment allowlist, secret manager, and owner for every execution edge. Separate sandbox/staging/production configuration plus rollback for project, schedule, queue, and client controls. Instructions 1. Map every trigger-to-project edge with owner, data class, allowed parameters, authorization scope, retry behavior, observability, and rollback. 2. Start with a sandbox project and fail closed on unknown project, parameter schema, destination, or response shape. 3. Make asynchronous execution idempotent and bounded; quarantine uncertainty rather than resubmitting or exporting output for debugging. 4. Canary one project with aggregate signals before promotion and retain the prior revision. 5. Re-evaluate controls whenever credentials, project ownership, schedules, or parameters change. Output Produce an architecture record with owners, opaque project IDs, policy revisions, idempotency/retry behavior, observability, test evidence, and rollback revision. Exclude SQL, output, credentials, and identities. Error Handling Stop on unknown scope/destination, failed redaction, non-idempotent retry, or authorization drift. Quarantine the event and restore the prior controlled path instead of adding a broad fallback. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/hex-reference-architecture