Search docs

Docs search

Validation rule

Back to Rule Catalog

AP-ARCH-003Architecture

Architecture 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 the rule validates

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.

Typical violation example

Validation is configured but no architecture overview is present.

Typical compliant example

docs/architecture/overview.md summarizes modules, data flow, and governance boundaries.

Related rules

AP-ARCH-001 - Modular monolith folder structure exists AP-ARCH-002 - Implementation profile not fully supported AP-ARCH-004 - Module baseline files exist AP-ARCH-005 - Module registry path exists

Adjacent categories

Architecture Rules

Related files/config

docs/architecture/overview.md
.archpilot/architecture.json

Related CLI commands

archpilot validate
archpilot validate --ci

Related docs

Rule Catalog Smart Init Policy & ADR Workflows

AP-ARCH-003 - Architecture overview artifact exists | ArchPilot Docs