architecture.hexum

Last updated 12 September 2026

architecture.hexum

skill full

layer ui
  match src/ui/**
  match src/pages/**

layer services
  match src/services/**

layer data
  match src/data/**

rule no_ui_to_data
  from ui
  cannot use data
  severity high
  message UI must not import data access directly.
  hint Call services instead.

Field	What you are saying
`skill`	lite, full, ultra, or off. Optional.
`layer`	A named group of files.
`match`	Glob. Repeatable.
`rule`	A named forbid.
`from`	Source layer.
`cannot use`	Forbidden target layer.
`severity`	high / error, medium / warning, low.
`message`	What to show when the rule fires.
`hint`	Optional fix.
`layer name = glob`	One-line layer. Repeat to add globs.
`forbid src -> dst`	One-line high-severity rule. Comma-separated destinations ok.

Public explainer: What is architecture.hexum?

FAQ

What is the rules file?

A file in the repo (usually architecture.hexum) that groups folders into layers and says which layer cannot import another. Guide: /architecture-hexum.

Does the architecture check use an AI?

No. It reads a rules file in your repo and reports forbidden imports. It does not call a model, so it does not guess.