Arch-Engine
View mode:

Your codebase has architecture. Nothing enforces it systemically.

Arch-Engine extracts structural relationships directly from source code and enables enforcement of architectural rules via policy packs — automatically, deterministically.

Try it locally in 30 seconds

Install
npm install @arch-engine/cli
Execute
npx arch-engine doctor
Output
Detected authority boundary crossing:
  frontend → database mutation layer

Suggested policy:
  enforce service isolation boundary

How Arch-Engine works

Arch-Engine converts source structure into enforceable architecture diagnostics in a deterministic pipeline.

Structural enforcement pipeline

The Problem

Software architecture is discussed in reviews and documented in wikis. It is rarely enforced systemically by tooling.

Dependencies cross boundaries silently.
Small changes create unexpected blast radius.
Architectural rules exist only as convention.

Teams discover structural problems in production because nothing surfaces them earlier.

A New Kind of Architecture Tool

This is not another linting tool.

It does not check code style or find bugs.

Arch-Engine operates one level above — on the structural relationships between packages, modules, and boundaries. It makes your architecture visible and enforceable through policy packs as a first-class part of your development workflow.

The Solution

Arch-Engine reads your repository and extracts the structural relationships between every package, module, and boundary.

With that structure extracted, teams can:

  • query dependency connections across the entire codebase
  • enforce boundary rules that prevent architectural drift via policy packs
  • detect structural risk before it reaches a pull request

No annotations required. No build changes. One install. Works alongside existing tooling.

Diagnostic Runtime

Run one command to inspect your architecture. Reports structural confidence, connectivity coverage, and policy readiness — instantly.

npx arch-engine doctor
Example output
✔ Topology extracted successfully
✔ Workspace type resolved as: single (highest confidence)
✔ Packages detected: 1 / 1 expected
✔ Connected nodes: 1
✔ Coverage: 100%
✔ Connectivity: 100%
✔ Confidence: HIGH (Structured single workspace extraction)
✔ Authority crossings observed: 0
Extracts structure.Evaluates structure.Reports confidence immediately.

Safe diagnostic runtime. No source files modified. No dependencies mutated. Creates a local .arch-engine/ context directory on first run.

No network requests. Fully offline execution by default. Sub-second execution on typical small and mid-sized workspaces.

Run instantly without installation using npx.

Policy Packs

Policy packs are optional. The engine runs without them.

Policy packs encode architecture rules as enforceable constraints. Define them once. The engine enforces them on every run. Examples: boundary protection, dependency drift detection, API contract alignment validation.

Adapters

Adapters let Arch-Engine understand how your project is structured — npm, pnpm, and Yarn workspaces — monorepo, single-package, or multi-workspace. No configuration required for supported workspace types.

Adapters are read-only and never modify your project.

Production Ready

Available now. Stable CLI runtime. MIT licensed.

v1.0.0 Stable Release

Scoped npm packages on the public registry. Stable public API surface.

CLI Runtime

Topology extraction in a single command.

Workspace Adapters

Automatic project structure discovery.

Governance Packs

Composable architecture rule enforcement.

See your architecture in one command.

npm install @arch-engine/cli

Zero configuration required. Instant diagnostic.