Skip to content

CircleCI config hardening: enable --next validation #993

Description

@cacieprins

CircleCI config hardening: enable --next validation

Summary

Plan and implement --next validation for CircleCI configs so we catch August 17, 2026 breaking changes before they block pipelines.

Target date: Before 2026-08-17 (recommend completing by 2026-08-01)


Background

On August 17, 2026, CircleCI will enforce stricter config compilation. Pipelines using affected patterns will fail to compile. The three changes are:

  1. Undeclared parameters — references to undeclared/out-of-scope pipeline parameters fail instead of resolving to null
  2. Regex engine update — negative lookaheads/lookbehinds, possessive quantifiers, and backreferences are rejected
  3. Config v2.0 sunset — configs must comply with v2.1 semantics (HEREDOC <<, job names, workflow filters, etc.)

Preview affected configs today:

circleci config validate <path-to-config> --next

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions