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 it means
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.
Example bad pattern
The overview describes users and organizations but omits authorization boundaries.Example good pattern
The overview names RBAC and links the relevant auth modules and ADRs.Related files/config
docs/architecture/overview.mddocs/adrs
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs