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 it means

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.

Example bad pattern

Tenant isolation changes are only described in a pull request.

Example good pattern

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

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