[gems2000]

what

• let full-form custom run steps opt into the configured plan store with plan_store.mode: save or consume
• save plans only after the marked producer succeeds, and validate/remove plans around the marked consumer
• reject invalid stage, duplicate, and native/custom combinations
• document the syntax and add regression coverage for stale, empty, missing, mutated, and failed plans

why

• native plan and apply steps use PlanStore, but custom workflows that produce $PLANFILE through run currently bypass plan persistence
• explicit per-run semantics preserve custom Terraform/Terragrunt workflows without guessing which arbitrary command owns the plan

tests

• go test ./server/core/config/... -count=1
• focused custom plan-store and existing load/hash tests in ./server/events
• all ProjectCommandRunner tests
• gofmt and git diff --check

references

• Closes Persist plans for custom Atlantis workflows using external plan stores #6951
• Related to Missing documentation for external_stores #6779

architecture decision record

• I checked the ADR criteria.

ADR: Not required — this is additive optional configuration with unchanged defaults.

[gems2000]

Tracking issue: #6951. I opened this feature request to capture the custom-workflow plan persistence use case and link the implementation for maintainer review.

[gems2000]

@lukemassa can i get a review?