Search docs
Docs searchValidation rule
Back to Rule CatalogAP-DOC-002DocumentationRBAC or role-based access control mentioned in overview
Checks that architecture overview documentation mentions RBAC or role-based access control where expected.
warningsetup-gapNo auto-fix
How to fix
- Update the architecture overview with RBAC context.
- Link to authorization docs or ADRs.
- Mention the modules or services responsible for access-control decisions.
What the rule validates
The architecture overview is missing expected access-control context.
Why it matters
Access-control assumptions affect module boundaries, API behavior, and governance workflows.
Common causes
- RBAC was implemented after the overview was written.
- The overview uses product language without naming role-based access control.
- Security and authorization notes live in a separate doc that is not linked.
Typical violation example
The overview describes users and organizations but omits authorization boundaries.Typical compliant example
The overview names RBAC and links the relevant auth modules and ADRs.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/architecture/overview.mddocs/adrs
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs