architecture-guard

Enforce monorepo rules and detect cross-service boundary violations.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/lgerard314/global-plugin --skill architecture-guard-lgerard314
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-guard
Source: https://github.com/lgerard314/global-plugin/tree/main/plugin/skills/architecture-guard
Command: npx skills add https://github.com/lgerard314/global-plugin --skill architecture-guard-lgerard314

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keep the monorepo healthy — packages have clear owners, dependencies flow one direction, shared code is stable.

Core Features & Use Cases

  • Enforces dependency direction rules, package ownership, and entry point contracts.
  • Detects cycles, missing owners, and cross-app interactions; supports automated review.
  • Guides teams to establish clear ownership with CODEOWNERS and README for new packages.

Quick Start

Review the change against monorepo structure rules and run the automated guard checks.

Frequently Asked Questions about architecture-guard

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

FAQPage Schema
How do I enforce monorepo boundaries and prevent cross-service dependency violations?

You can enforce monorepo boundaries by applying automated guard checks to each change, ensuring dependency direction rules are followed and preventing direct app-to-app dependencies across services.

What happens when a new package is added without explicit CODEOWNERS or a README?

When new packages lack explicit CODEOWNERS or README files, the guard checks flag the missing ownership documentation and guide teams to establish clear package ownership before merging.

How do I detect dependency cycles and unauthorized cross-app interactions in a monorepo?

Automated guard checks detect dependency cycles and cross-app interactions by validating package entry points and verifying that dependencies flow in one direction across the monorepo.

Can I use architecture guardrails to verify package ownership and shared code stability?

Yes, architecture guardrails verify package ownership by requiring one public entry point per package and ensuring shared code boundaries remain stable across services during code reviews.

What are the limitations of relying solely on code reviews for monorepo architecture rules?

Manual code reviews often miss complex dependency cycles and cross-service boundary violations, whereas automated guard checks consistently validate package ownership and dependency direction rules.

When do I need automated guardrails for monorepo package boundaries?

You need automated guardrails when changes affect package ownership, dependency direction, or shared package boundaries, ensuring one public entry per package and preventing app-to-app dependencies.