Search docs

Docs search
Back to Rule Catalog
AP-DOC-001Documentation

Tenant model ADR exists for different-schema model

Checks that different-schema tenant modeling decisions are captured in an ADR.

warningsetup-gapNo auto-fix

How to fix

  1. Add or update an ADR for the tenant model.
  2. Include status, context, decision, and consequences.
  3. Link related migrations or operational runbooks.

What the rule validates

ArchPilot expected ADR coverage for the configured tenant model but did not find enough evidence.

Why it matters

Tenant architecture affects security, operations, and migrations, so the decision needs durable context.

Common causes

  • The tenant model changed without an ADR.
  • ADR keywords do not match the configured architecture.
  • The ADR lives outside the configured docs path.

Typical violation example

Tenant isolation changes are only described in a pull request.

Typical compliant example

docs/adrs/adr-001-tenant-model.md explains the tenant isolation decision.

Related rules

Adjacent categories

Related files/config

  • docs/adrs
  • .archpilot/architecture.json

Related CLI commands

  • archpilot validate
  • archpilot validate --ci
AP-DOC-001 - Tenant model ADR exists for different-schema model | ArchPilot Docs