RCA-2026-04-11-001: Analysis

1

Why did the Antora build hang?
Because: ~5,000 scripture pages were added to a single Antora component. The node process exhausted memory processing all pages before writing output.

2

Why were 5,000 pages added to domus-captures?
Because: The generation script targeted domus-captures directly instead of a dedicated spoke repo. The decision to create a spoke was made during planning but not executed before generating files.

3

Why wasn’t the build tested before committing 5,000 files?
Because: Build verification was skipped. The generation script ran successfully and files were committed and pushed without running make first.

4

Why was build output being filtered instead of read?
Because: The pattern make 2>&1 | grep "Site built" was used repeatedly, which hides all errors and warnings. When the build hung, the grep waited forever with no indication of failure.

5

Why were pre-existing errors tolerated for hours?
Because: ~100 broken case-study xrefs were visible from the first build but dismissed as "pre-existing" and filtered out. This normalized error-blindness — when new errors appeared, they were filtered too.