📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*.go: All code must pass golangci-lint checks
Follow Go error handling idioms and use meaningful error messages
Wrap errors with context using fmt.Errorf("context: %w", err)
Consider custom error types for domain-specific errors
Follow standard Go coding style; run gofmt and goimports
Use snake_case for environment variables
Document complex logic with inline comments

**/*.go: All comments must end with periods; comments should be complete sentences (golangci-lint godot).
Organize imports into three groups separated by blank lines: standard library, third-party, and github.com/cloudposse/atmos packages; sort alphabetically within each group and preserve existing aliases.
Wrap all errors using static errors from errors/errors.go; prefer errors.Join for multiple errors; use fmt.Errorf with %w for context; check with errors.Is; never use dynamic errors directly.
Distinguish structured logging from UI output: use stderr for prompts/status/errors needing user action, stdout only for data; never use logging for UI elements.
Most text UI must go to stderr; only data/results go to stdout; prefer utils.PrintfMessageToTUI for UI messages.
Ensure cross-platform compatibility: prefer SDKs over external binaries; use filepath.Join, os.PathSeparator, and runtime.GOOS for OS-specific logic; add build constraints if needed.

Files:

• errors/errors.go
• internal/terraform_backend/terraform_backend_registry.go
• internal/terraform_backend/terraform_backend_utils.go
• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

Document all exported functions, types, and methods with Go doc comments

Files:

• errors/errors.go
• internal/terraform_backend/terraform_backend_registry.go
• internal/terraform_backend/terraform_backend_utils.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (CLAUDE.md)

Define static errors in errors/errors.go as package-level variables using errors.New().

Files:

• errors/errors.go

📄 CodeRabbit inference engine (CLAUDE.md)

@(cmd|internal|pkg)/**/!(*_test).go: Add defer perf.Track() to all public and critical private functions with a blank line after the call; use package-qualified names like "packagename.FunctionName"; pass atmosConfig if present, else nil.
Ensure 80% minimum coverage on new/changed lines; exclude mock files from coverage (mock_.go, **/mock_.go, **/mock/*.go); include comprehensive unit and required integration tests.

Files:

• internal/terraform_backend/terraform_backend_registry.go
• internal/terraform_backend/terraform_backend_utils.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (CLAUDE.md)

Bind environment variables with viper.BindEnv() and provide ATMOS_ alternatives for every env var.

Files:

• internal/terraform_backend/terraform_backend_registry.go
• internal/terraform_backend/terraform_backend_utils.go
• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

go.{mod,sum}: Manage dependencies with Go modules
Keep dependencies up to date

Files:

• go.mod

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in website/ when adding features
Ensure consistency between CLI help text and website documentation
Follow the website's documentation structure and style
Keep website code in website/ and follow its architecture/style; test changes locally
Keep CLI and website documentation in sync; document new features with examples and use cases

Files:

• website/docs/functions/yaml/terraform.state.mdx

📄 CodeRabbit inference engine (CLAUDE.md)

Follow Docusaurus conventions for frontmatter, purpose note, screengrab components, and section ordering (Usage → Examples → Arguments → Flags).

Files:

• website/docs/functions/yaml/terraform.state.mdx

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*_test.go: Every new feature must include comprehensive unit tests
Test both happy paths and error conditions
Use table-driven tests for multiple scenarios

**/*_test.go: Use table-driven tests for unit tests; focus on pure functions; generate and use mocks for external dependencies.
Test behavior, not implementation; avoid tautological or stub tests; remove always-skipped tests; ensure tests validate real behavior.
Always use t.Skipf() with a reason for skipped tests; never call t.Skipf without a reason; CLI tests build a temp binary and TestMain must call os.Exit(m.Run()).

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

pkg/config/const.go (1)

• BackendTypeAzurerm (89-89)

internal/terraform_backend/terraform_backend_azurerm.go (1)

• ReadTerraformBackendAzurerm (121-135)

errors/errors.go (1)

• ErrUnsupportedBackendType (57-57)

internal/terraform_backend/terraform_backend_azurerm.go (2)

• AzureBlobDownloadResponse (42-44)
• ReadTerraformBackendAzurermInternal (138-229)

errors/errors.go (4)

• ErrAzurePermissionDenied (71-71)
• ErrGetBlobFromAzure (65-65)
• ErrAzureContainerRequired (69-69)
• ErrReadAzureBlobBody (66-66)

pkg/perf/perf.go (1)

• Track (58-86)

internal/terraform_backend/terraform_backend_utils.go (3)

• GetBackendAttribute (56-63)
• GetComponentBackend (36-43)
• GetTerraformWorkspace (16-23)

errors/errors.go (7)

• ErrStorageAccountRequired (70-70)
• ErrCreateAzureCredential (67-67)
• ErrCreateAzureClient (68-68)
• ErrAzureContainerRequired (69-69)
• ErrAzurePermissionDenied (71-71)
• ErrGetBlobFromAzure (65-65)
• ErrReadAzureBlobBody (66-66)

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*.go: All code must pass golangci-lint checks
Follow Go error handling idioms and use meaningful error messages
Wrap errors with context using fmt.Errorf("context: %w", err)
Consider custom error types for domain-specific errors
Follow standard Go coding style; run gofmt and goimports
Use snake_case for environment variables
Document complex logic with inline comments

**/*.go: All comments must end with periods; enforced by golangci-lint godot across all Go comments.
Organize imports into three groups (stdlib, third-party, Atmos) separated by blank lines and sorted alphabetically within each group; keep existing aliases.
All errors must be wrapped using static errors defined in errors/errors.go; prefer errors.Join for multiple, fmt.Errorf with %w for context, and errors.Is for checks; never rely on string comparisons.
Prefer cross-platform implementations: use SDKs over external binaries; use filepath/os facilities; gate OS-specific logic with runtime.GOOS or build tags.

Files:

• internal/exec/terraform_state_utils.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

Document all exported functions, types, and methods with Go doc comments

Files:

• internal/exec/terraform_state_utils.go

📄 CodeRabbit inference engine (CLAUDE.md)

{cmd,internal,pkg}/**/*.go: Add defer perf.Track() to all public functions and critical private ones, include a blank line after it, and use package-qualified names (e.g., "exec.ProcessComponent"). Use atmosConfig if available, else nil.
Always bind environment variables with viper.BindEnv; every var must have an ATMOS_ alternative and prefer ATMOS_ over external names.
Distinguish structured logging from UI output: UI prompts/errors/status to stderr; data/results to stdout; logging for system/debug only; no UI via logging.
Most text UI must go to stderr (via utils.PrintfMessageToTUI or fmt.Fprintf(os.Stderr,...)); only data/results to stdout.

Files:

• internal/exec/terraform_state_utils.go

📄 CodeRabbit inference engine (CLAUDE.md)

Always use mockgen for interface mocks; never write manual mocks with many stub methods.

Files:

• internal/exec/terraform_state_utils.go

📄 CodeRabbit inference engine (CLAUDE.md)

Target minimum 80% coverage on new/changed lines; exclude mock files from coverage: **/mock_.go, mock_.go, **/mock/*.go.

Files:

• internal/exec/terraform_state_utils.go

Learnt from: samtholiya
PR: cloudposse/atmos#1466
File: toolchain/list.go:39-42
Timestamp: 2025-09-13T18:06:07.674Z
Learning: In the cloudposse/atmos repository, for UI messages in the toolchain package, use utils.PrintfMessageToTUI instead of log.Error or fmt.Fprintln(os.Stderr, ...). Import pkg/utils with alias "u" to follow the established pattern.

Applied to files:

• internal/exec/terraform_state_utils.go

pkg/logger/log.go (3)

• Debug (24-26)
• Level (171-171)
• Errorf (59-61)

pkg/schema/schema.go (1)

• Logs (376-379)

internal/exec/spinner_utils.go (3)

• NewSpinner (46-64)
• RunSpinner (67-76)
• StopSpinner (79-82)

internal/exec/describe_component.go (1)

• ExecuteDescribeComponent (198-219)

pkg/utils/log_utils.go (1)

• PrintfMessageToTUI (29-31)

internal/terraform_backend/terraform_backend_utils.go (2)

• GetTerraformBackend (121-150)
• GetTerraformBackendVariable (66-84)

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*_test.go: Every new feature must include comprehensive unit tests
Test both happy paths and error conditions
Use table-driven tests for multiple scenarios

**/*_test.go: Unit tests should be table-driven where appropriate and focus on pure functions; target >80% coverage with emphasis on pkg/ and internal/exec/.
Test behavior, not implementation; avoid tautological or stub-only tests; use dependency injection to make code testable; remove always-skipped tests; table-driven tests must use realistic scenarios.
Place //go:generate mockgen directives for mocks at the top of test files; for internal interfaces use -source=$GOFILE -destination=mock_$GOFILE -package=$GOPACKAGE.
Tests must call production code paths (do not duplicate production logic within tests).
Always use t.Skipf with a reason (never t.Skip or Skipf without context).
Test files should mirror implementation structure and be co-located with source files (foo.go ↔ foo_test.go).
Use precondition-based test skipping helpers from tests/test_preconditions.go (e.g., RequireAWSProfile, RequireGitHubAccess).

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*.go: All code must pass golangci-lint checks
Follow Go error handling idioms and use meaningful error messages
Wrap errors with context using fmt.Errorf("context: %w", err)
Consider custom error types for domain-specific errors
Follow standard Go coding style; run gofmt and goimports
Use snake_case for environment variables
Document complex logic with inline comments

**/*.go: All comments must end with periods; enforced by golangci-lint godot across all Go comments.
Organize imports into three groups (stdlib, third-party, Atmos) separated by blank lines and sorted alphabetically within each group; keep existing aliases.
All errors must be wrapped using static errors defined in errors/errors.go; prefer errors.Join for multiple, fmt.Errorf with %w for context, and errors.Is for checks; never rely on string comparisons.
Prefer cross-platform implementations: use SDKs over external binaries; use filepath/os facilities; gate OS-specific logic with runtime.GOOS or build tags.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (CLAUDE.md)

{cmd,internal,pkg}/**/*.go: Add defer perf.Track() to all public functions and critical private ones, include a blank line after it, and use package-qualified names (e.g., "exec.ProcessComponent"). Use atmosConfig if available, else nil.
Always bind environment variables with viper.BindEnv; every var must have an ATMOS_ alternative and prefer ATMOS_ over external names.
Distinguish structured logging from UI output: UI prompts/errors/status to stderr; data/results to stdout; logging for system/debug only; no UI via logging.
Most text UI must go to stderr (via utils.PrintfMessageToTUI or fmt.Fprintf(os.Stderr,...)); only data/results to stdout.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (CLAUDE.md)

Always use mockgen for interface mocks; never write manual mocks with many stub methods.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (CLAUDE.md)

Target minimum 80% coverage on new/changed lines; exclude mock files from coverage: **/mock_.go, mock_.go, **/mock/*.go.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

Document all exported functions, types, and methods with Go doc comments

Files:

• internal/terraform_backend/terraform_backend_azurerm.go

pkg/schema/schema.go (1)

• Context (381-396)

internal/terraform_backend/terraform_backend_azurerm.go (2)

• AzureBlobDownloadResponse (43-45)
• ReadTerraformBackendAzurermInternal (187-245)

errors/errors.go (4)

• ErrAzurePermissionDenied (71-71)
• ErrGetBlobFromAzure (65-65)
• ErrAzureContainerRequired (69-69)
• ErrReadAzureBlobBody (66-66)

pkg/perf/perf.go (1)

• Track (58-86)

internal/terraform_backend/terraform_backend_utils.go (3)

• GetBackendAttribute (56-63)
• GetComponentBackend (36-43)
• GetTerraformWorkspace (16-23)

errors/errors.go (7)

• ErrStorageAccountRequired (70-70)
• ErrCreateAzureCredential (67-67)
• ErrCreateAzureClient (68-68)
• ErrAzurePermissionDenied (71-71)
• ErrAzureContainerRequired (69-69)
• ErrGetBlobFromAzure (65-65)
• ErrReadAzureBlobBody (66-66)

pkg/logger/log.go (1)

• Debug (24-26)

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*.go: All code must pass golangci-lint checks
Follow Go error handling idioms and use meaningful error messages
Wrap errors with context using fmt.Errorf("context: %w", err)
Consider custom error types for domain-specific errors
Follow standard Go coding style; run gofmt and goimports
Use snake_case for environment variables
Document complex logic with inline comments

**/*.go: All comments must end with periods. Applies to single-line, multi-line, inline, and documentation comments.
Organize imports into three groups (stdlib, 3rd-party, Atmos) separated by blank lines and sort alphabetically within each group; preserve existing aliases.
Add defer perf.Track(...) in all public and critical private functions; include a blank line after the perf.Track call; use "packagename.FunctionName" as the name; pass atmosConfig when available, otherwise nil.
Wrap all returned errors using static errors (from errors/errors.go); use errors.Join to combine errors; use fmt.Errorf with %w to add context; use errors.Is for checks; never rely on err.Error() string matching.
Always use viper.BindEnv with ATMOS_ alternatives; prefer ATMOS_* first with fallback to external env vars when needed.
Prefer many small, focused files; never use //revive:disable:file-length-limit to bypass file length limits.
Use filepath.Join, os.PathSeparator, and runtime.GOOS for portable path/OS handling; use build constraints when necessary.

Files:

• internal/terraform_backend/terraform_backend_azurerm.go
• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

Document all exported functions, types, and methods with Go doc comments

Files:

• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (CLAUDE.md)

{cmd,internal,pkg}/**/*.go: Use Viper for configuration management and bind environment variables consistently.
Distinguish structured logging from UI output: UI prompts/status/errors to stderr; data/results to stdout; do not use logging for UI elements.
Prefer SDKs over invoking external binaries for cross-platform compatibility (e.g., terraform-exec instead of exec.Command("terraform")).

Files:

• internal/terraform_backend/terraform_backend_azurerm.go
• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (CLAUDE.md)

{cmd,internal}/**/*.go: Most text UI must go to stderr (e.g., utils.PrintfMessageToTUI or fmt.Fprintf(os.Stderr, ...)); only data/results go to stdout.
Telemetry for commands is automatic via RootCmd.ExecuteC(); for non-standard paths, call telemetry.CaptureCmd/CaptureCmdString explicitly.

Files:

• internal/terraform_backend/terraform_backend_azurerm.go
• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*_test.go: Every new feature must include comprehensive unit tests
Test both happy paths and error conditions
Use table-driven tests for multiple scenarios

**/*_test.go: Unit tests should focus on pure functions and favor table-driven tests.
Test behavior (inputs/outputs), not implementation detail; avoid tautologies and stub-only tests; remove always-skipped tests.
Always call production code within tests rather than duplicating logic under test.
Use t.Skipf with a clear reason when skipping tests; never call t.Skipf without a reason.
Use go.uber.org/mock/mockgen for interface mocks; never hand-write large mock implementations.
Add //go:generate mockgen directives for mocks in test files.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (CLAUDE.md)

Test files should mirror implementation naming (e.g., foo.go has foo_test.go) and be co-located with implementations.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

pkg/perf/perf.go (1)

• Track (121-138)

internal/terraform_backend/terraform_backend_utils.go (3)

• GetBackendAttribute (56-63)
• GetComponentBackend (36-43)
• GetTerraformWorkspace (16-23)

errors/errors.go (8)

• ErrStorageAccountRequired (78-78)
• ErrCreateAzureCredential (75-75)
• ErrCreateAzureClient (76-76)
• ErrBackendConfigRequired (80-80)
• ErrAzurePermissionDenied (79-79)
• ErrAzureContainerRequired (77-77)
• ErrGetBlobFromAzure (73-73)
• ErrReadAzureBlobBody (74-74)

pkg/logger/log.go (2)

• Errorf (59-61)
• Debug (24-26)

internal/terraform_backend/terraform_backend_azurerm.go (3)

• AzureBlobDownloadResponse (43-45)
• ReadTerraformBackendAzurermInternal (190-248)
• ReadTerraformBackendAzurerm (122-139)

errors/errors.go (5)

• ErrAzurePermissionDenied (79-79)
• ErrGetBlobFromAzure (73-73)
• ErrAzureContainerRequired (77-77)
• ErrReadAzureBlobBody (74-74)
• ErrBackendConfigRequired (80-80)

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*.go: All code must pass golangci-lint checks
Follow Go error handling idioms and use meaningful error messages
Wrap errors with context using fmt.Errorf("context: %w", err)
Consider custom error types for domain-specific errors
Follow standard Go coding style; run gofmt and goimports
Use snake_case for environment variables
Document complex logic with inline comments

**/*.go: All comments must end with periods. Applies to single-line, multi-line, inline, and documentation comments.
Organize imports into three groups (stdlib, 3rd-party, Atmos) separated by blank lines and sort alphabetically within each group; preserve existing aliases.
Add defer perf.Track(...) in all public and critical private functions; include a blank line after the perf.Track call; use "packagename.FunctionName" as the name; pass atmosConfig when available, otherwise nil.
Wrap all returned errors using static errors (from errors/errors.go); use errors.Join to combine errors; use fmt.Errorf with %w to add context; use errors.Is for checks; never rely on err.Error() string matching.
Always use viper.BindEnv with ATMOS_ alternatives; prefer ATMOS_* first with fallback to external env vars when needed.
Prefer many small, focused files; never use //revive:disable:file-length-limit to bypass file length limits.
Use filepath.Join, os.PathSeparator, and runtime.GOOS for portable path/OS handling; use build constraints when necessary.

Files:

• internal/exec/terraform_state_utils.go
• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

Document all exported functions, types, and methods with Go doc comments

Files:

• internal/exec/terraform_state_utils.go

📄 CodeRabbit inference engine (CLAUDE.md)

{cmd,internal,pkg}/**/*.go: Use Viper for configuration management and bind environment variables consistently.
Distinguish structured logging from UI output: UI prompts/status/errors to stderr; data/results to stdout; do not use logging for UI elements.
Prefer SDKs over invoking external binaries for cross-platform compatibility (e.g., terraform-exec instead of exec.Command("terraform")).

Files:

• internal/exec/terraform_state_utils.go
• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (CLAUDE.md)

{cmd,internal}/**/*.go: Most text UI must go to stderr (e.g., utils.PrintfMessageToTUI or fmt.Fprintf(os.Stderr, ...)); only data/results go to stdout.
Telemetry for commands is automatic via RootCmd.ExecuteC(); for non-standard paths, call telemetry.CaptureCmd/CaptureCmdString explicitly.

Files:

• internal/exec/terraform_state_utils.go
• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*_test.go: Every new feature must include comprehensive unit tests
Test both happy paths and error conditions
Use table-driven tests for multiple scenarios

**/*_test.go: Unit tests should focus on pure functions and favor table-driven tests.
Test behavior (inputs/outputs), not implementation detail; avoid tautologies and stub-only tests; remove always-skipped tests.
Always call production code within tests rather than duplicating logic under test.
Use t.Skipf with a clear reason when skipping tests; never call t.Skipf without a reason.
Use go.uber.org/mock/mockgen for interface mocks; never hand-write large mock implementations.
Add //go:generate mockgen directives for mocks in test files.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (CLAUDE.md)

Test files should mirror implementation naming (e.g., foo.go has foo_test.go) and be co-located with implementations.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

Learnt from: samtholiya
PR: cloudposse/atmos#1466
File: toolchain/list.go:39-42
Timestamp: 2025-09-13T18:06:07.674Z
Learning: In the cloudposse/atmos repository, for UI messages in the toolchain package, use utils.PrintfMessageToTUI instead of log.Error or fmt.Fprintln(os.Stderr, ...). Import pkg/utils with alias "u" to follow the established pattern.

Applied to files:

• internal/exec/terraform_state_utils.go

Learnt from: osterman
PR: cloudposse/atmos#740
File: cmd/cmd_utils.go:340-359
Timestamp: 2024-10-23T21:36:40.262Z
Learning: In the Go codebase for Atmos, when reviewing functions like `checkAtmosConfig` in `cmd/cmd_utils.go`, avoid suggesting refactoring to return errors instead of calling `os.Exit` if such changes would significantly increase the scope due to the need to update multiple call sites.

Applied to files:

• internal/exec/terraform_state_utils.go

Learnt from: osterman
PR: cloudposse/atmos#808
File: pkg/config/config.go:478-483
Timestamp: 2024-12-02T21:26:32.337Z
Learning: In the 'atmos' project, when reviewing Go code like `pkg/config/config.go`, avoid suggesting file size checks after downloading remote configs if such checks aren't implemented elsewhere in the codebase.

Applied to files:

• internal/exec/terraform_state_utils.go

Learnt from: CR
PR: cloudposse/atmos#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-21T15:50:22.359Z
Learning: Applies to **/*.go : Add defer perf.Track(...) in all public and critical private functions; include a blank line after the perf.Track call; use "packagename.FunctionName" as the name; pass atmosConfig when available, otherwise nil.

Applied to files:

• internal/exec/terraform_state_utils.go

Learnt from: CR
PR: cloudposse/atmos#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-21T15:50:22.359Z
Learning: Applies to **/*.go : All comments must end with periods. Applies to single-line, multi-line, inline, and documentation comments.

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

pkg/schema/schema.go (1)

• Logs (404-407)

internal/exec/spinner_utils.go (3)

• NewSpinner (46-64)
• RunSpinner (67-76)
• StopSpinner (79-82)

internal/exec/describe_component.go (1)

• ExecuteDescribeComponent (198-219)

pkg/utils/log_utils.go (1)

• PrintfMessageToTUI (33-35)

internal/terraform_backend/terraform_backend_utils.go (2)

• GetTerraformBackend (137-166)
• GetTerraformBackendVariable (66-84)

internal/terraform_backend/terraform_backend_azurerm.go (3)

• AzureBlobDownloadResponse (43-45)
• ReadTerraformBackendAzurermInternal (190-248)
• ReadTerraformBackendAzurerm (122-139)

errors/errors.go (5)

• ErrAzurePermissionDenied (79-79)
• ErrGetBlobFromAzure (73-73)
• ErrAzureContainerRequired (77-77)
• ErrReadAzureBlobBody (74-74)
• ErrBackendConfigRequired (80-80)

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in website/ when adding features
Ensure consistency between CLI help text and website documentation
Follow the website's documentation structure and style
Keep website code in website/ and follow its architecture/style; test changes locally
Keep CLI and website documentation in sync; document new features with examples and use cases

Always build the website (npm run build) after documentation changes to ensure no errors, broken links, or missing assets.

Files:

• website/blog/2025-10-21-azure-blob-terraform-state-support.md

📄 CodeRabbit inference engine (CLAUDE.md)

Use definition lists

for arguments and flags in docs instead of tables.

Files:

• website/blog/2025-10-21-azure-blob-terraform-state-support.md

📄 CodeRabbit inference engine (CLAUDE.md)

website/blog/*.md: PRs labeled minor or major must include a blog post in website/blog/YYYY-MM-DD-feature-name.md with required frontmatter, tags, and truncate marker.
Use appropriate audience tags (feature/enhancement/bugfix or contributors) and relevant secondary tags in blog posts.

Files:

• website/blog/2025-10-21-azure-blob-terraform-state-support.md

[grammar] ~302-~302: Please add a punctuation mark at the end of paragraph.
Context: ... add features? Review our [contribution guide](https://atmos.tools/community/contribu...

(PUNCTUATION_PARAGRAPH_END)

[style] ~306-~306: Using many exclamation marks might seem excessive (in this case: 13 exclamation marks for a text that’s 4890 characters long)
Context: ...pport for !terraform.state. Stay tuned!

(EN_EXCESSIVE_EXCLAMATION)

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*.go: All code must pass golangci-lint checks
Follow Go error handling idioms and use meaningful error messages
Wrap errors with context using fmt.Errorf("context: %w", err)
Consider custom error types for domain-specific errors
Follow standard Go coding style; run gofmt and goimports
Use snake_case for environment variables
Document complex logic with inline comments

**/*.go: Use interface-driven design with dependency injection; define interfaces for major functionality and inject dependencies.
Generate mocks with go.uber.org/mock/mockgen using //go:generate directives; never write manual mocks.
Use the functional Options pattern instead of functions with many parameters for configuration.
Use context.Context strictly for cancellation, deadlines/timeouts, and request-scoped values; never for config or dependencies. Context must be the first parameter when present.
All comments must end with periods (godot linter).
Organize imports in three groups separated by blank lines and sorted alphabetically: stdlib, third-party (not cloudposse/atmos), then Atmos packages; maintain aliases cfg, log, u, errUtils.
Add defer perf.Track(atmosConfig, "pkg.FuncName")() (or nil) and a blank line at the start of all public functions to track performance.
Use static error types from errors/errors.go, wrap with fmt.Errorf("%w: msg", err), combine with errors.Join, and check with errors.Is; never use dynamic string comparisons.
Keep files small and focused (<600 lines). One command or implementation per file; co-locate tests; never use //revive:disable:file-length-limit.
Bind environment variables with viper.BindEnv using ATMOS_ prefix (e.g., viper.BindEnv("ATMOS_VAR", "ATMOS_VAR", "FALLBACK")).
UI output (prompts/status) must go to stderr; data output to stdout; logging is for system events only and never for UI.
Ensure cross-platform compatibility: avoid hardcoded path separators; use filepath.Join and prefer SDKs over shelling out to binaries.

Files:

• tests/preconditions.go
• errors/errors.go
• internal/terraform_backend/terraform_backend_registry.go
• internal/terraform_backend/terraform_backend_azurerm.go
• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_utils_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

Document all exported functions, types, and methods with Go doc comments

Files:

• tests/preconditions.go
• errors/errors.go
• internal/terraform_backend/terraform_backend_registry.go
• internal/terraform_backend/terraform_backend_azurerm.go

📄 CodeRabbit inference engine (CLAUDE.md)

tests/**: Place integration tests only under tests/ with fixtures in tests/test-cases/.
Use test precondition helpers from tests/test_preconditions.go so tests skip gracefully when prerequisites are missing.

Files:

• tests/preconditions.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*_test.go: Every new feature must include comprehensive unit tests
Test both happy paths and error conditions
Use table-driven tests for multiple scenarios

**/*_test.go: Prefer unit tests with mocks over integration tests; use table-driven tests; target >80% coverage.
Write tests that validate behavior rather than implementation; avoid tautological or stub-only tests.
Tests must exercise production code paths rather than duplicating logic in test helpers.
When skipping tests, use t.Skipf("reason") with clear context; CLI tests may auto-build temporary binaries.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go
• internal/terraform_backend/terraform_backend_utils_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in website/ when adding features
Ensure consistency between CLI help text and website documentation
Follow the website's documentation structure and style
Keep website code in website/ and follow its architecture/style; test changes locally
Keep CLI and website documentation in sync; document new features with examples and use cases

Files:

• website/blog/2025-10-21-azure-blob-terraform-state-support.md
• website/docs/functions/yaml/terraform.state.mdx

📄 CodeRabbit inference engine (CLAUDE.md)

PRs labeled minor or major must include a blog post with date-prefixed filename and include after the intro; tag appropriately.

Files:

• website/blog/2025-10-21-azure-blob-terraform-state-support.md

Learnt from: CR
PR: cloudposse/atmos#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-22T06:25:54.400Z
Learning: Applies to **/*.go : Add defer perf.Track(atmosConfig, "pkg.FuncName")() (or nil) and a blank line at the start of all public functions to track performance.

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm.go

Learnt from: osterman
PR: cloudposse/atmos#740
File: cmd/cmd_utils.go:340-359
Timestamp: 2024-10-23T21:36:40.262Z
Learning: In the Go codebase for Atmos, when reviewing functions like `checkAtmosConfig` in `cmd/cmd_utils.go`, avoid suggesting refactoring to return errors instead of calling `os.Exit` if such changes would significantly increase the scope due to the need to update multiple call sites.

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm.go

Learnt from: osterman
PR: cloudposse/atmos#808
File: pkg/config/config.go:478-483
Timestamp: 2024-12-02T21:26:32.337Z
Learning: In the 'atmos' project, when reviewing Go code like `pkg/config/config.go`, avoid suggesting file size checks after downloading remote configs if such checks aren't implemented elsewhere in the codebase.

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm.go

pkg/config/const.go (1)

• BackendTypeAzurerm (89-89)

internal/terraform_backend/terraform_backend_azurerm.go (1)

• ReadTerraformBackendAzurerm (133-150)

pkg/perf/perf.go (1)

• Track (121-138)

internal/terraform_backend/terraform_backend_utils.go (3)

• GetBackendAttribute (56-63)
• GetComponentBackend (36-43)
• GetTerraformWorkspace (16-23)

errors/errors.go (8)

• ErrStorageAccountRequired (78-78)
• ErrCreateAzureCredential (75-75)
• ErrCreateAzureClient (76-76)
• ErrBackendConfigRequired (80-80)
• ErrAzurePermissionDenied (79-79)
• ErrAzureContainerRequired (77-77)
• ErrGetBlobFromAzure (73-73)
• ErrReadAzureBlobBody (74-74)

pkg/logger/log.go (1)

• Debug (24-26)

internal/terraform_backend/terraform_backend_azurerm.go (3)

• AzureBlobDownloadResponse (46-48)
• ReadTerraformBackendAzurermInternal (201-267)
• ReadTerraformBackendAzurerm (133-150)

errors/errors.go (6)

• ErrAzurePermissionDenied (79-79)
• ErrGetBlobFromAzure (73-73)
• ErrAzureContainerRequired (77-77)
• ErrReadAzureBlobBody (74-74)
• ErrBackendConfigRequired (80-80)
• ErrStorageAccountRequired (78-78)

tests/preconditions.go (1)

• RequireAzureCredentials (92-123)

internal/terraform_backend/terraform_backend_utils.go (1)

• GetBackendAttribute (56-63)

internal/terraform_backend/terraform_backend_utils.go (1)

• ProcessTerraformStateFile (98-134)

[style] ~308-~308: Using many exclamation marks might seem excessive (in this case: 13 exclamation marks for a text that’s 5035 characters long)
Context: ...pport for !terraform.state. Stay tuned!

(EN_EXCESSIVE_EXCLAMATION)

[style] ~26-~26: Consider using a more formal/concise alternative here.
Context: .... Meanwhile, if you are using backends other than local, s3, and azurerm, consider ...

(OTHER_THAN)

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*_test.go: Every new feature must include comprehensive unit tests
Test both happy paths and error conditions
Use table-driven tests for multiple scenarios

**/*_test.go: Prefer unit tests with mocks over integration tests; use table-driven tests; target >80% coverage.
Write tests that validate behavior rather than implementation; avoid tautological or stub-only tests.
Tests must exercise production code paths rather than duplicating logic in test helpers.
When skipping tests, use t.Skipf("reason") with clear context; CLI tests may auto-build temporary binaries.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

**/*.go: All code must pass golangci-lint checks
Follow Go error handling idioms and use meaningful error messages
Wrap errors with context using fmt.Errorf("context: %w", err)
Consider custom error types for domain-specific errors
Follow standard Go coding style; run gofmt and goimports
Use snake_case for environment variables
Document complex logic with inline comments

**/*.go: Use interface-driven design with dependency injection; define interfaces for major functionality and inject dependencies.
Generate mocks with go.uber.org/mock/mockgen using //go:generate directives; never write manual mocks.
Use the functional Options pattern instead of functions with many parameters for configuration.
Use context.Context strictly for cancellation, deadlines/timeouts, and request-scoped values; never for config or dependencies. Context must be the first parameter when present.
All comments must end with periods (godot linter).
Organize imports in three groups separated by blank lines and sorted alphabetically: stdlib, third-party (not cloudposse/atmos), then Atmos packages; maintain aliases cfg, log, u, errUtils.
Add defer perf.Track(atmosConfig, "pkg.FuncName")() (or nil) and a blank line at the start of all public functions to track performance.
Use static error types from errors/errors.go, wrap with fmt.Errorf("%w: msg", err), combine with errors.Join, and check with errors.Is; never use dynamic string comparisons.
Keep files small and focused (<600 lines). One command or implementation per file; co-locate tests; never use //revive:disable:file-length-limit.
Bind environment variables with viper.BindEnv using ATMOS_ prefix (e.g., viper.BindEnv("ATMOS_VAR", "ATMOS_VAR", "FALLBACK")).
UI output (prompts/status) must go to stderr; data output to stdout; logging is for system events only and never for UI.
Ensure cross-platform compatibility: avoid hardcoded path separators; use filepath.Join and prefer SDKs over shelling out to binaries.

Files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

pkg/schema/schema.go (2)

• Context (409-424)
• AtmosConfiguration (27-65)

internal/terraform_backend/terraform_backend_azurerm.go (3)

• AzureBlobDownloadResponse (46-48)
• ReadTerraformBackendAzurermInternal (201-267)
• ReadTerraformBackendAzurerm (133-150)

errors/errors.go (6)

• ErrAzurePermissionDenied (79-79)
• ErrGetBlobFromAzure (73-73)
• ErrAzureContainerRequired (77-77)
• ErrReadAzureBlobBody (74-74)
• ErrBackendConfigRequired (80-80)
• ErrStorageAccountRequired (78-78)

tests/preconditions.go (1)

• RequireAzureCredentials (92-123)

internal/terraform_backend/terraform_backend_utils.go (1)

• GetBackendAttribute (56-63)

Learnt from: CR
PR: cloudposse/atmos#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-23T00:58:28.954Z
Learning: Applies to {internal,pkg}/**/*.go : Add defer perf.Track(atmosConfig, "pkg.FuncName")() + a blank line at the start of all public functions (use nil if no atmosConfig)

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm.go

Learnt from: osterman
PR: cloudposse/atmos#808
File: pkg/config/config.go:478-483
Timestamp: 2024-12-02T21:26:32.337Z
Learning: In the 'atmos' project, when reviewing Go code like `pkg/config/config.go`, avoid suggesting file size checks after downloading remote configs if such checks aren't implemented elsewhere in the codebase.

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm.go

Learnt from: osterman
PR: cloudposse/atmos#740
File: cmd/cmd_utils.go:340-359
Timestamp: 2024-10-23T21:36:40.262Z
Learning: In the Go codebase for Atmos, when reviewing functions like `checkAtmosConfig` in `cmd/cmd_utils.go`, avoid suggesting refactoring to return errors instead of calling `os.Exit` if such changes would significantly increase the scope due to the need to update multiple call sites.

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm.go

Learnt from: CR
PR: cloudposse/atmos#0
File: CLAUDE.md:0-0
Timestamp: 2025-10-23T00:58:28.954Z
Learning: Applies to **/*.go : All comments must end with periods (godot linter)

Applied to files:

• internal/terraform_backend/terraform_backend_azurerm_test.go

[style] ~26-~26: Consider using a more formal/concise alternative here.
Context: .... Meanwhile, if you are using backends other than local, s3, and azurerm, consider ...

(OTHER_THAN)

[style] ~308-~308: Using many exclamation marks might seem excessive (in this case: 13 exclamation marks for a text that’s 5035 characters long)
Context: ...pport for !terraform.state. Stay tuned!

(EN_EXCESSIVE_EXCLAMATION)