architecture-conformancelisted
Install: claude install-skill Xopoko/plug-n-skills
# Architecture Conformance
Bundled commands use `$PLUGIN_ROOT` 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, generated code, runtime calls, full CODEOWNERS semantics, a