Search docs

Docs search
Back to Rule Catalog
AP-ARCH-012Architecture

Architecture module review state is current

Checks whether observed and governed architecture modules require explicit architecture model review.

infoguidanceNo auto-fix

How to fix

  1. Open Review Architecture Model and review the surfaced module.
  2. Accept intentional modules into governance when they should be added to .archpilot/architecture.json.
  3. Choose Not Now when a module should remain ungoverned for now; applicable architecture validation can still evaluate it.
  4. 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

Adjacent categories

Related files/config

  • .archpilot/architecture.json
  • .archpilot/architecture-review-state.json

Related CLI commands

  • archpilot validate
  • archpilot validate --ci
AP-ARCH-012 - Architecture module review state is current | ArchPilot Docs