Cloud Common

Shared utilities used across all faber-cloud skills.

Purpose

This skill provides:

• Configuration loading from

  .fractary/plugins/faber-cloud/config.json

  (in project working directory)
• Backward compatibility with

  faber-cloud.json

  and

  devops.json

  (deprecated)
• Pattern substitution (

  {project}

  ,

  {environment}

  , etc.)
• Auto-discovery fallbacks when config is missing
• Validation and error handling

CRITICAL: Always load config from the project working directory, NOT the plugin installation directory.

Configuration Loading

Primary config file:

.fractary/plugins/faber-cloud/config.json

(relative to project root / current working directory)

Common Mistake: Do NOT look in

~/.claude/plugins/marketplaces/fractary/plugins/faber-cloud/

- that's the plugin installation directory, not the project config location.

Automatic migration (seamless upgrade):

• If

  config.json

  exists: use it (current standard)
• If

  faber-cloud.json

  exists: automatically rename to

  config.json

• If

  devops.json

  exists: show warning to migrate manually

Migration is automatic and preserves all configuration settings.

Components

scripts/config-loader.sh

Core configuration management:

Main Functions:

• load_faber_cloud_config()

  - Load configuration from file or auto-discover (with backward compatibility)

• resolve_pattern(pattern, environment)

  - Substitute placeholders in patterns

• get_aws_profile(environment)

  - Get AWS profile for environment

• get_config_value(key)

  - Get specific config value

• show_config()

  - Display current configuration

Usage:

# Source the loader
source "${SKILL_DIR}/../cloud-common/scripts/config-loader.sh"

# Load configuration (checks config.json, auto-migrates from faber-cloud.json if needed)
load_faber_cloud_config

# Use configuration variables
echo "Project: $PROJECT_NAME"
echo "Provider: $PROVIDER"
echo "IaC Tool: $IAC_TOOL"

# Resolve patterns
USER_NAME=$(resolve_pattern "$USER_NAME_PATTERN" "test")
# Result: corthuxa-core-test-deploy

# Get AWS profile
AWS_PROFILE=$(get_aws_profile "test")
# Result: corthuxa-core-test-deploy

Exported Variables:

• PROJECT_NAME

  - Project name

• NAMESPACE

  - Project namespace

• ORGANIZATION

  - Organization name

• PROVIDER

  - Cloud provider (aws, gcp, azure)

• IAC_TOOL

  - IaC tool (terraform, pulumi, cdk)

• AWS_REGION

  - AWS region

• TERRAFORM_DIR

  - Terraform directory path

• IAM_POLICIES_DIR

  - IAM policies directory path

• PROFILE_DISCOVER

  ,

  PROFILE_TEST

  ,

  PROFILE_PROD

  - AWS profiles

• USER_NAME_PATTERN

  ,

  POLICY_NAME_PATTERN

  - IAM naming patterns

• RESOURCE_PREFIX

  - Resource naming prefix

templates/faber-cloud.json.template

Template for generating

.fractary/plugins/faber-cloud/config.json

:

• Placeholders:

  {{PROJECT_NAME}}

  ,

  {{NAMESPACE}}

  , etc.
• Used by

  /fractary-faber-cloud:init

  command
• Includes sensible defaults
• Template filename remains

  faber-cloud.json.template

  for compatibility, generates

  config.json

Auto-Discovery

When configuration file doesn't exist, auto-discovers:

• Project name from Git repository
• Organization from Git remote
• AWS account ID from credentials
• Provider and IaC tool from installed tools

Pattern Substitution

Supported placeholders:

• {project}

  - Project name

• {namespace}

  - Project namespace

• {organization}

  - Organization name

• {environment}

  - Current environment (test, prod, etc.)

• {prefix}

  - Resource prefix

Example:

Pattern: "{prefix}-{environment}-bucket"
Result: "corthuxa-test-bucket"

Configuration Schema

See

/docs/specs/fractary-faber-cloud-plugin-spec.md

for complete schema.

Used By

Infrastructure Skills:

• infra-architect
• infra-engineer
• infra-validator
• infra-previewer
• infra-deployer
• infra-permission-manager
• infra-tester
• infra-debugger

Operations Skills:

• ops-monitor
• ops-investigator
• ops-responder
• ops-auditor

Handler Skills:

• handler-hosting-aws
• handler-iac-terraform

Note: Previously used by deprecated agents (devops-deployer, devops-debugger, devops-permissions) - now superseded by Phase 1-4 architecture. See

.archive/pre-phase-architecture/

for historical reference.