One-click install
npx skills add https://github.com/ysuurme/azure_hello_world --skill architecture-ysuurme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/ysuurme/azure_hello_world/tree/main/.agents/skills/architecture
Command: npx skills add https://github.com/ysuurme/azure_hello_world --skill architecture-ysuurme

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill prevents structural drift and surprise side-effects by computing a dependency blast radius before a change is committed, then blocking progress when topology violates boundaries defined in CONTEXT.md.

Core Features & Use Cases

  • Dependency topology visibility: Generates dependency graphs and derives actionable signals like circular dependencies and God Object risk.
  • Blast-radius computation: Identifies changed modules, traces impacted callers/dependents, classifies modules as safe/at-risk/blocked, and produces a PR-ready report.
  • Boundary and refactoring enforcement: Validates topology against bounded contexts in CONTEXT.md and escalates when fragility or pattern signals demand refactoring.
  • GitHub issue cross-reference loop: Checks open architecture issues to avoid duplicate work and to ensure findings map to prior decisions.

Quick Start

Use the architecture skill when you have a PR with proposed module changes and you want an automated blast-radius report against CONTEXT.md boundaries.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I calculate dependency blast radius for a code change before merging?

Dependency blast radius is calculated by analyzing module topology, tracing impacted callers, classifying modules as safe or at-risk, and validating against bounded contexts. This Skill automates that computation and produces a structured architecture risk report for GitHub PR review.

How do I detect circular dependencies and God Objects in my codebase?

Circular dependencies and God Object risks are detected by generating dependency graphs and deriving actionable structural signals from module coupling. This Skill analyzes dependency topology to identify these architectural anti-patterns and escalates findings when refactoring is required.

How do I enforce bounded context boundaries in GitHub PR reviews?

Bounded context boundaries are enforced by validating dependency topology against layer constraints defined in CONTEXT.md. When a proposed change violates these boundaries, the Skill blocks progress and publishes a structured blast-radius report as a GitHub PR comment.

What's the best way to prevent structural drift when modifying shared modules?

Preventing structural drift requires computing a dependency blast radius before a change is committed, then blocking progress when topology violates defined boundaries. This Skill maps module coupling, classifies deep vs shallow modules, and cross-references open architecture issues to avoid duplicate work.

Can I map module coupling and classify deep vs shallow modules automatically?

Module coupling can be mapped and modules classified as deep or shallow by generating dependency outputs to the filesystem and deriving structural metrics. This Skill automates that topology analysis, summarizing metrics into context and producing architecture risk reports.

Do I need a CONTEXT.md file to validate architecture boundaries?

A CONTEXT.md file is required to define layer constraints and bounded contexts that the Skill validates dependency topology against. Without it, boundary enforcement and fragility escalation cannot be applied to the computed blast radius during PR review.