architecture-evolution-tracking

Detect architectural drift from ADRs and compute alignment scores.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill architecture-evolution-tracking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-evolution-tracking
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/architecture-evolution-tracking
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill architecture-evolution-tracking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Monitors alignment between code and architectural decisions, detects drift from ADRs, and suggests refactoring to restore conformance.

Core Features & Use Cases

  • ADR-based alignment scoring
  • Drift detection and refactoring guidance
  • Serena integration for architectural health monitoring

Quick Start

Invoke architecture evolution tracking to measure conformance: /shannon:architecture-evolution-tracking

Frequently Asked Questions about architecture-evolution-tracking

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

FAQPage Schema
How do I detect architectural drift from ADRs?

Architectural drift detection compares your codebase against Architecture Decision Records to identify deviations. This Skill computes an alignment score (0.00–1.00) and auto-detects violations like circular dependencies, layer violations, and unauthorized coupling, then generates refactoring guidance to restore conformance.

What violations does ADR compliance checking catch?

ADR compliance checking identifies circular dependencies, layer violations, and unauthorized coupling in your codebase. It flags architectural violations that deviate from your documented decisions and provides specific refactoring guidance to resolve them.

Can I integrate architectural monitoring with Serena?

Yes. This Skill integrates with Serena for continuous architectural health monitoring. It tracks ADR alignment and drift over time, enabling large-scale design reviews and dependency analyses with real-time conformance visibility.

When should I run architecture conformance checks?

Run conformance checks during large-scale design reviews, dependency analyses, and regular architectural audits. Use it to catch drift early, prevent unauthorized coupling, and maintain alignment between code and Architecture Decision Records throughout your project lifecycle.

How does alignment scoring measure architectural health?

Alignment scoring produces a normalized 0.00–1.00 metric reflecting how closely your codebase conforms to documented ADRs. Higher scores indicate better adherence; lower scores signal violations and drift requiring refactoring attention.