Initializes the faber-cloud plugin configuration for your project. Creates the configuration file at `.fractary/plugins/faber-cloud/config.json` with project-specific settings for cloud infrastructure management.
Creates cloud infrastructure configuration file with auto-discovery and workflow templates.
/plugin marketplace add fractary/claude-plugins/plugin install fractary-faber-cloud@fractaryInitializes the faber-cloud plugin configuration for your project. Creates the configuration file at .fractary/plugins/faber-cloud/config.json with project-specific settings for cloud infrastructure management.
<ARGUMENT_SYNTAX>
This command follows the standard space-separated syntax:
--flag value (NOT --flag=value)# Correct ✅
/fractary-faber-cloud:init
/fractary-faber-cloud:init --provider aws --iac terraform
# Incorrect ❌
/fractary-faber-cloud:init --provider=aws --iac=terraform
</ARGUMENT_SYNTAX>
<CRITICAL_RULES> YOU MUST:
.fractary/plugins/faber-cloud/ directory if neededconfig.json from template at skills/cloud-common/templates/faber-cloud.json.template
faber-cloud.json exists, rename it to config.json (preserving all settings).gitignore if not already presentTHIS COMMAND PERFORMS SETUP WORK DIRECTLY. This is an exception to the normal pattern because it's a one-time setup command.
IMPORTANT ERROR HANDLING:
Create .fractary/plugins/faber-cloud/config.json configuration file for this project.
Set up cloud infrastructure automation configuration by:
Detect Project Information
Auto-Discover Infrastructure
Generate Configuration
faber-cloud.json and migrate to config.json if foundplugins/faber-cloud/config/config.example.json.fractary/plugins/faber-cloud/ directory.fractary/plugins/faber-cloud/workflows/ directory.fractary/plugins/faber-cloud/config.jsonValidate Setup
Extract from Git:
# Project name from repo
git remote get-url origin | sed 's/.*\///' | sed 's/\.git$//'
# Organization from GitHub URL
git remote get-url origin | sed 's/.*github.com[:/]\([^/]*\)\/.*/\1/'
# Namespace: typically organization-project or subdomain
# Examples:
# corthos/core.corthuxa.ai → corthuxa-core
# myorg/api.service.com → myorg-api
Scan directories:
# Find Terraform directory
find . -type d -name "terraform" -o -name "infrastructure"
# Find tfvars files (indicates environments)
find . -name "*.tfvars"
# Check for AWS profiles in config
aws configure list-profiles
Check installed tools:
# AWS
command -v aws && aws sts get-caller-identity
# GCP
command -v gcloud && gcloud config get-value project
# Azure
command -v az && az account show
# Terraform
command -v terraform && terraform version
# Pulumi
command -v pulumi && pulumi version
Source: plugins/faber-cloud/config/config.example.json
This template includes workflow file references:
{
"workflows": [
{
"id": "infrastructure-deploy",
"file": "./workflows/infrastructure-deploy.json"
},
{
"id": "infrastructure-audit",
"file": "./workflows/infrastructure-audit.json"
},
{
"id": "infrastructure-teardown",
"file": "./workflows/infrastructure-teardown.json"
}
]
}
Placeholders to substitute:
{{PROJECT_NAME}} - Project name from Git{{SUBSYSTEM}} - Subsystem name (if applicable){{ORGANIZATION}} - Organization from Git remote{{HOSTING_PROVIDER}} - Cloud provider (aws, gcp, azure){{AWS_ACCOUNT_ID}} - From aws sts get-caller-identity{{AWS_REGION}} - From AWS config or default to us-east-1{{IAC_TOOL}} - IaC tool (terraform, pulumi)Directory structure:
.fractary/plugins/faber-cloud/
├── config.json # Main configuration (references workflows)
└── workflows/ # Workflow definition files
├── infrastructure-deploy.json # Standard deployment workflow
├── infrastructure-audit.json # Non-destructive audit workflow
└── infrastructure-teardown.json # Safe destruction workflow
Workflow files are copied from plugins/faber-cloud/config/workflows/ and contain:
If auto-discovery fails or needs confirmation, ask user:
Provider Selection (if multiple detected or none):
IaC Tool Selection (if multiple detected or none):
Environment Confirmation (if profiles detected):
Terraform Directory (if multiple candidates):
After generating configuration:
File Structure Check
# Verify .fractary/plugins/faber-cloud/config.json exists
# Validate JSON syntax
jq empty .fractary/plugins/faber-cloud/config.json
AWS Profile Validation
# Source config loader
source skills/cloud-common/scripts/config-loader.sh
load_config
# Validate profiles
source skills/handler-hosting-aws/scripts/auth.sh
validate_all_profiles
Terraform Validation
# Check Terraform directory
[ -d "$TERRAFORM_DIR" ] && echo "✓ Terraform directory found"
# Check for .tfvars files
ls "$TERRAFORM_DIR"/*.tfvars
Display configuration summary:
✓ faber-cloud configuration initialized
Project: corthography
Namespace: corthuxa-core
Organization: corthos
Provider: AWS
Account: 123456789012
Region: us-east-1
IaC Tool: Terraform
Directory: ./infrastructure/terraform
AWS Profiles:
✓ Discover: corthuxa-core-discover-deploy
✓ Test: corthuxa-core-test-deploy
✓ Prod: corthuxa-core-prod-deploy
Workflows:
✓ infrastructure-deploy (Standard deployment)
✓ infrastructure-audit (Non-destructive audit)
✓ infrastructure-teardown (Safe destruction)
Files created:
✓ .fractary/plugins/faber-cloud/config.json
✓ .fractary/plugins/faber-cloud/workflows/infrastructure-deploy.json
✓ .fractary/plugins/faber-cloud/workflows/infrastructure-audit.json
✓ .fractary/plugins/faber-cloud/workflows/infrastructure-teardown.json
Next steps:
- Review configuration: cat .fractary/plugins/faber-cloud/config.json
- Review workflows: ls .fractary/plugins/faber-cloud/workflows/
- Customize workflows: Edit workflow files in .fractary/plugins/faber-cloud/workflows/
- Validate setup: /fractary-faber-cloud:validate
- Deploy infrastructure: /fractary-faber-cloud:manage <work-id> --workflow infrastructure-deploy
No Git Repository:
No Cloud Provider Detected:
No IaC Tool Detected:
AWS Profiles Missing:
Invalid Terraform Directory:
.fractary/plugins/faber-cloud/ directory if it doesn't exist.fractary/plugins/faber-cloud/workflows/ directoryplugins/faber-cloud/config/workflows/ to project:
faber-cloud.json and migrate to config.json if foundplugins/faber-cloud/config/config.example.json.gitignore entry for sensitive configs/fractary-faber-cloud:validate - Validate existing configuration/fractary-faber-cloud:status - Show current configuration status/fractary-faber-cloud:deploy-apply - Deploy infrastructure using configuration