arch-review

Check code changes for architecture conformance across modules.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/kagenti/humr --skill arch-review-kagenti
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-review
Source: https://github.com/kagenti/humr/tree/main/.agents/skills/arch-review
Command: npx skills add https://github.com/kagenti/humr --skill arch-review-kagenti

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review code changes against opinionated TypeScript architecture rules to ensure alignment with layer boundaries, domain purity, and event usage.

Core Features & Use Cases

  • Checks PRs, diffs, and branch changes for architecture conformance.
  • Flags violations like improper layer dependencies, cross-boundary imports, or missing domain events.
  • Use Case: during a PR review, validate that a change across modules respects module boundaries and event contracts.

Quick Start

Review a PR against the architecture rules to receive a conformance report and suggested fixes.

Frequently Asked Questions about arch-review

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

FAQPage Schema
How do I check a PR for TypeScript architecture conformance?

Architecture conformance checks validate PRs by loading TypeScript architecture guidelines and verifying changes against defined ports, events, and module boundaries to detect improper layer dependencies and cross-boundary imports.

How does architecture review detect improper cross-boundary imports in a diff?

Architecture review detects improper cross-boundary imports by loading guidelines from your architecture docs and validating the diff against defined module boundaries, domain invariants, and event contracts to flag violations.

Can I validate branch changes against module boundaries and event contracts?

Yes, you can validate branch changes against module boundaries and event contracts. The review applies to branches and diffs to verify that changes respect layer boundaries, domain purity, and defined ports.

What is the best way to enforce layer boundaries and domain invariants in TypeScript?

The best way to enforce layer boundaries and domain invariants in TypeScript is to review code changes against opinionated architecture rules, which flags missing domain events and improper layer dependencies during PR validation.

Why does my TypeScript architecture review flag missing domain events?

Your TypeScript architecture review flags missing domain events because the change violates the defined event contracts and architecture guidelines loaded from your docs, ensuring domain purity and proper event usage across modules.

Do I need architecture docs to validate module boundaries in a PR?

Yes, you need architecture docs to validate module boundaries in a PR. The review loads architecture guidelines from these docs to verify changes against defined ports, events, and module boundaries.