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 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
AP-ADR-001 - ADR directory missingAP-ADR-002 - ADR file missing titleAP-ADR-003 - ADR status missing or invalidAP-ADR-004 - Required ADR missing for architecture context
Adjacent categories
Related files/config
docs/adrs.archpilot/architecture.json
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs