Search docs
Docs searchValidation rule
Back to Rule CatalogAP-ARCH-012ArchitectureArchitecture module review state is current
Checks whether observed and governed architecture modules require explicit architecture model review.
infoguidanceNo auto-fix
How to fix
- Open Review Architecture Model and review the surfaced module.
- Accept intentional modules into governance when they should be added to .archpilot/architecture.json.
- Choose Not Now when a module should remain ungoverned for now; applicable architecture validation can still evaluate it.
- Review moved or removed governed modules explicitly before removing stale declarations from .archpilot/architecture.json.
What the rule validates
ArchPilot treats .archpilot/architecture.json as the accepted architecture model while also surfacing high-confidence observed modules that are not yet governed, previously reviewed but still ungoverned modules, and governed modules whose declared paths are no longer observed.
Why it matters
New module-like source folders can represent intentional architecture changes or accidental drift. They should be reviewed before becoming governed architecture, without hiding applicable validation evidence from the current source tree.
Common causes
- A new high-confidence module folder was added after architecture review state was established.
- A module was reviewed with Not Now, so it remains outside governed architecture but is no longer treated as newly discovered.
- A governed module path in .archpilot/architecture.json was moved or removed and is now declared-missing.
Typical review-needed example
.archpilot/architecture.json governs src/modules/users and src/modules/orders, then source later adds src/modules/notifications and assumes validation will automatically add it to the governed model.Typical reviewed example
Review Architecture Model surfaces src/modules/notifications for explicit review; accepting it updates governance when appropriate, while Not Now records the decision without suppressing applicable validation.Related rules
AP-ARCH-001 - Modular monolith folder structure existsAP-ARCH-002 - Implementation profile not fully supportedAP-ARCH-003 - Architecture overview artifact existsAP-ARCH-004 - Module baseline files exist
Adjacent categories
Related files/config
.archpilot/architecture.json.archpilot/architecture-review-state.json
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs