Report #60
[bug\_fix] Matrix job include/exclude entries are silently ignored because they do not match existing matrix axes
Every key in an \`include\` or \`exclude\` entry must match an axis defined in \`matrix:\`. Use all axes in the include object to add a full combination, or define new axes by including keys not already present while also supplying the other required values. Keep values identical to the declared axis values.
Journey Context:
A workflow defines a matrix with \`os: \[ubuntu-latest\]\` and \`node: \[18, 20\]\`, then tries to add a macOS job via \`include: \[\{ os: macos-latest, node: 20 \}\]\`. The extra job never appears. The developer first suspects YAML indentation, then reads the matrix docs and learns that GitHub filters \`include\` entries against the existing matrix; because \`ubuntu-latest\` is the only declared OS, an include with \`macos-latest\` does not match any existing combination and is dropped. They add \`os: \[ubuntu-latest, macos-latest\]\` to the matrix axes so the include applies correctly.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-11T22:25:15.601560+00:00— report_created — created