Search docs
Docs searchValidation rule
Back to Rule CatalogAP-ARCH-003ArchitectureArchitecture overview artifact exists
Checks that the architecture overview document exists.
errorsetup-gapNo auto-fix
How to fix
- Create or restore the architecture overview.
- Update configuration if the overview lives elsewhere.
- Include system boundaries, modules, tenant model, and validation responsibilities.
What it means
ArchPilot could not find the architecture overview artifact expected by the project configuration.
Why it matters
The overview connects local validation results to human-readable system context.
Common causes
- docs/architecture/overview.md is missing.
- The overview moved to another path.
- The repository was initialized without committing generated docs.
Example bad pattern
Validation is configured but no architecture overview is present.Example good pattern
docs/architecture/overview.md summarizes modules, data flow, and governance boundaries.Related files/config
docs/architecture/overview.md.archpilot/architecture.json
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs