brownfield-drift

Official

Catch architecture drift across modules.

Authorwednesday-solutions
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Brownfield drift detects when changes in a codebase violate the architecture boundaries defined in PLAN.md, preventing AI-assisted work from silently crossing module or service lines.

Core Features & Use Cases

  • Boundary violation detection: Flags forbidden imports, ownership rule breaks, direct inter-service imports, and circular dependencies that contradict PLAN.md constraints.
  • PR-focused drift reporting: Supports comparing against a base commit to report only newly introduced violations.
  • Rule-targeted checks: Runs drift analysis for a single specified rule to speed up reviews and remediation.
  • Guided remediation alignment: Requires reporting the violating edge, the introducing commit when available, and the suggested fix aligned to PLAN.md intent.

Quick Start

Ask an AI to run the drift check for your PR by executing "wednesday-skills drift --since <base-commit>" and then summarize any boundary violations it reports with their violating edges and suggested fixes from PLAN.md.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: brownfield-drift
Download link: https://github.com/wednesday-solutions/ai-agent-skills/archive/main.zip#brownfield-drift

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.