adev:deploy

Deploy Pipeline

Execute a structured deployment pipeline defined in .context-index/deploy.yaml. Steps run in order with fail-fast behavior, output redaction, and rollback guidance on failure.

Announce at start: "I'm using the adev:deploy skill to run a deployment pipeline."

Arguments

• --version <tag>: explicit version/tag for this deploy (bypasses milestone lookup)
• --env <name>: target environment name (uses default if omitted)
• --dry-run: print what would execute without running anything

Prerequisites

Before starting, verify all conditions. If any fails, stop with the indicated message.

1. Deploy config exists. .context-index/deploy.yaml must exist. If missing: "No deploy.yaml found. Run /adev:deploy init to set up deployment."

2. Config validates. Load and validate the config using the companion library. If validation fails: print each error with step ID and description, then exit.

3. Version resolved. Either --version <tag> is provided, or a shipped milestone exists in milestones.yaml. If neither: "No shipped milestone found. Use --version <tag> to deploy explicitly."

Process

Step 1: Load and Validate Config

import { loadDeployConfig, validateDeployConfig } from '<project-root>/lib/deploy.mjs';

const config = loadDeployConfig(projectRoot);
// If null: print NO_CONFIG message and exit
// If config._loadError: print errors and exit

const { errors, warnings } = validateDeployConfig(config);
// If errors.length > 0: print each error and exit
// If warnings.length > 0: print warnings (non-blocking)

Load Skill Extensions: Load any skill extension instructions before proceeding:

adev skill-ext load --skill deploy

If the output is not __NONE__, incorporate it as additional standing instructions that apply to this skill's entire execution. Frame it as: "The following skill extension instructions apply to this invocation (source: installed domain extensions and/or project-level overrides)." If the output is __NONE__, continue normally.