sf-agent-framework/devops/commands/orchestrator/prepare.md

AI Agent Orchestration Framework for Salesforce Development - Two-phase architecture with 70% context reduction

# sfpowerscripts orchestrator:prepare

## Overview

The `orchestrator:prepare` command prepares the target environment before
deployment by fetching scratch orgs from pools, installing dependencies, and
validating prerequisites.

## Integration with SF-Agent Framework

This command is integrated into the following agents:

- sf-devops-lead
- sf-release-automation
- sf-build-engineer

## Usage

```bash
sfdx sfpowerscripts:orchestrator:prepare \
  -p config/prepare.json \
  -f \
  --npm \
  --loglevel INFO
```

## Configuration Template

```json
{
  "poolConfig": {
    "tag": "release-1.0",
    "maxAllocation": 10,
    "fetchTimeout": 60
  },
  "dependencies": {
    "packages": [
      {
        "package": "CoreFramework@1.0.0-1"
      },
      {
        "package": "SharedUtilities",
        "versionNumber": "LATEST"
      }
    ],
    "keys": "config/package.keys"
  },
  "validation": {
    "checkOnly": false,
    "testLevel": "RunLocalTests",
    "ignoreWarnings": true
  }
}
```

## Agent Commands

- `*prepare-env` - Prepare target environment
- `*fetch-org` - Get scratch org from pool
- `*install-deps` - Install package dependencies

## Best Practices

1. Always maintain healthy scratch org pools
2. Use specific package versions in production
3. Implement retry logic for transient failures
4. Monitor pool health metrics
5. Clean up failed preparations