architecture-guardian

Identify architectural boundary violations in BioETL code and generate a compliance report.

1|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/SatoryKono/BioactivityDataAcquisition --skill architecture-guardian-satorykono
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-guardian
Source: https://github.com/SatoryKono/BioactivityDataAcquisition/tree/main/docs/skills/local/public/architecture-guardian
Command: npx skills add https://github.com/SatoryKono/BioactivityDataAcquisition --skill architecture-guardian-satorykono

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintains architectural integrity by enforcing proper boundaries between domain, application, infrastructure, composition, and interfaces, ensuring ADRs are followed and anti-patterns are avoided.

Core Features & Use Cases

  • Validate import rules across hexagonal layers to prevent cross-layer coupling.
  • Enforce naming conventions for classes, functions, and modules.
  • Detect anti-patterns such as DI violations, direct logging, sentinel values, and hardcoded secrets.
  • Verify ADR compliance by auditing docs in docs/02-architecture/decisions/.
  • Audit structural consistency including type annotations and module naming.

Quick Start

Run architecture-guardian against the latest code changes to generate an architecture compliance report.

Frequently Asked Questions about architecture-guardian

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

FAQPage Schema
How do I detect architectural boundary violations in hexagonal architecture code?

Detect architectural boundary violations by scanning code to enforce import rules across domain, application, infrastructure, composition, and interface layers, generating a compliance report to prevent cross-layer coupling.

What anti-patterns should architecture compliance checks detect in code review?

Architecture compliance checks detect anti-patterns including dependency injection violations, direct logging, sentinel values, and hardcoded secrets to maintain structural integrity and enforce proper boundaries.

How do I verify ADR compliance in architecture decisions documentation?

Verify ADR compliance by auditing architecture decision records stored in docs/02-architecture/decisions/ directories to ensure code implementation aligns with documented architectural decisions.

Can I enforce naming conventions for classes and modules across all hexagonal layers?

Enforce naming conventions for classes, functions, and modules across all hexagonal layers by auditing structural consistency, checking type annotations, and validating module naming during code review.

What is the best way to audit structural consistency in BioETL architecture?

Audit structural consistency in BioETL architecture by running automated checks that validate type annotations, module naming, and import rules, producing a comprehensive compliance report for code review.