RCA-2026-02-26: Prevention

Prevention

Mandatory Pre-Write Checklist

  • grep antora.yml for attribute before using it

  • If attribute doesn’t exist, add it first

  • Run make before committing

  • Check for 0 warnings

Shell Function

# Add to .bashrc/.zshrc
attr-check() {
  local attr="$1"
  grep -q "^\s*${attr}:" docs/asciidoc/antora.yml && \
    echo "OK $attr exists" || echo "MISSING $attr - add to antora.yml"
}

Key Lessons

Issue Prevention

Assumed attribute names

Always grep antora.yml before using any attribute

No build verification

Run make before every commit

Inconsistent naming

Use aliases for both patterns (with/without -01-)

Time pressure

Discipline over speed - 5 seconds prevents 15 minutes