Search docs
Docs searchValidation rule
Back to Rule CatalogAP-DOC-001DocumentationTenant 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
- Add or update an ADR for the tenant model.
- Include status, context, decision, and consequences.
- 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 validatearchpilot validate --ci
Related docs