Search docs
Docs searchValidation rule
Back to Rule CatalogAP-EVT-004Event ArchitectureEvent naming inconsistency
Flags event names that do not follow the repository's event naming convention.
warningviolationNo auto-fix
How to fix
- Use the established event naming convention.
- Prefer past-tense fact names for domain events when that is the local pattern.
- Update publisher, handler, and contract names together.
What the rule validates
An event name appears inconsistent with adjacent event names or documented conventions.
Why it matters
Consistent event naming helps teams understand event meaning, ownership, and lifecycle.
Common causes
- Some events are named as commands and others as facts.
- Pluralization or tense varies across modules.
- Renames did not update all references.
Typical violation example
StartUpload, RepositoryUploadedEvent, and upload_finished all describe the same style of event.Typical compliant example
RepositoryUploaded follows the same noun/verb tense convention as adjacent events.Related rules
AP-EVT-001 - Published event has no handlerAP-EVT-002 - Circular event chain riskAP-EVT-003 - Synchronous dependency disguised as event
Adjacent categories
Related files/config
apps/api/srcpackages/contracts/src
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs