architecture-conformance

Solid

Use when intended architecture must be compared with implementation: dependency policies, ADRs, ownership rules, drift, erosion, recovered models, and conformance classifications.

AI & Automation 8 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
32
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Architecture Conformance Bundled commands use `$PLUGIN_ROOT` (`$env:PLUGIN_ROOT` in PowerShell; same path suffix) for the plugin root. Set it once: use the host's plugin-root variable when defined (Claude Code: `PLUGIN_ROOT="$CLAUDE_PLUGIN_ROOT"`), otherwise the absolute path of this plugin's root directory. Use when the question is whether implementation still matches intended architecture. Triggers: compare code to ADR/docs/policy, detect drift or erosion, turn intent into checks, classify edges as convergence/divergence/absence/unknown, recover observed architecture before updating docs. ## Inputs - Intended model: ADRs, diagrams, README architecture sections, package rules, service boundaries, CODEOWNERS/OWNERS, ownership docs, explicit constraints. - Observed model: source tree, imports, manifests, build graph, tests, runtime config, deployment/IaC, recent changes. - Policy scope: modules, services, packages, data stores, topics, runtime paths. - Exception path: waivers, migration windows, legacy constraints, owners. If intent is thin, label it incomplete. Do not convert recovered source shape into design intent. ## Probe ```bash python3 "$PLUGIN_ROOT/scripts/architecture_probe.py" <repo-path> --json --policy <policy.json> ``` `architecture_intelligence.policy.v1` supports forbidden edges, required edges, and required documents. See `references/contracts.md`. The probe is conservative: top-level static imports and exact document paths only. Reflection, genera...

Details

Author
Xopoko
Repository
Xopoko/plug-n-skills
Created
1 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category