Summary
Zeitwerk autoloading is sensitive to naming conventions and engine structure. A dedicated repo-root script would let contributors quickly verify Zeitwerk is happy before pushing.
Objective
Add a bin/verify-zeitwerk (or scripts/verify-zeitwerk.sh) script that:
- Runs
bin/rails zeitwerk:check (or equivalent) under the default appraisal
- Reports pass/fail clearly
- Can be run from the repo root without knowing the engine layout
Acceptance Criteria
Verification Plan
- Run the script; confirm it outputs a clear result
- Confirm it's referenced in the doc index
Client Impact
None (developer tooling only).
Summary
Zeitwerk autoloading is sensitive to naming conventions and engine structure. A dedicated repo-root script would let contributors quickly verify Zeitwerk is happy before pushing.
Objective
Add a
bin/verify-zeitwerk(orscripts/verify-zeitwerk.sh) script that:bin/rails zeitwerk:check(or equivalent) under the default appraisalAcceptance Criteria
scripts/verify-zeitwerk.sh(orbin/verify-zeitwerk)zeitwerk:checkagainst the default appraisal Ruby versionVerification Plan
Client Impact
None (developer tooling only).