Deploy Anywhere

One deploy intent — read or scaffold .agent-loom/deploy.yml, detect provider, preflight secrets, run adapter steps, return URL + rollback command.

Hard Rules

Run scripts/preflight.py before any deploy — no partial deploys on missing config/secrets. Secrets by name only in files — never write credential values to repo. Shipped adapters: vercel, github-actions — see references/adapters/. Run test_cmd from config when present before build. Emit deployment summary: target, URL/status, rollback command.

---

Workflow

Step 1 — Read or scaffold config

Load .agent-loom/deploy.yml per DEPLOY-SCHEMA.md. If missing, scaffold from repo signals (vercel.json, .github/workflows/) and confirm with user.

Step 2 — Detect target

Config targets[] first; else repo signals; else ask.

Step 3 — Preflight

python3 .agents/skills/deploy-anywhere/scripts/preflight.py

On fail: list missing items exactly; stop.

Step 4 — Test + build

Run test_cmd then build_cmd from config.

Step 5 — Run adapter

Load references/adapters/<provider>.md. Execute documented CLI sequence.

Step 6 — Summarize

## Deploy summary
Target: [provider] ([preview|prod])
URL: [url or run link]
Rollback: [command]

---

Gotchas

• Vercel prebuilt flow requires vercel build before vercel deploy --prebuilt.
• Local gh workflow run needs gh auth — not the same as CI token.
• Multiple targets deploy sequentially — confirm order with user.

---

Output Format

See Step 6 summary template.

---

Examples

Teaser: deploy.yml with vercel target → preflight OK → build → deploy URL returned.

Full pairs: references/examples.md

---

Common Rationalizations

Excuse	Reality
"Skip preflight — I'll add secrets later"	Half-configured deploys fail opaquely.
"Embed token in deploy.yml for now"	Secrets in repo leak — names only.
"Skip tests this once"	test_cmd exists for a reason.
"One adapter fits all"	Use the adapter file — don't improvise CLI.
"Rollback is optional"	Always emit rollback command.

Verification

• preflight.py passed
• test_cmd run when configured
• Adapter steps from reference file
• Rollback command in summary

Red Flags

• Deploy attempted after preflight fail
• Secret value written to yaml
• Unknown provider without adapter file

Prune Log

Last pruned: 2026-07-05

• Initial release from high-leverage skill spec (Skill 3 family)

Impact Report

Deploy: [provider] | Preflight: [pass/fail] | URL: [url or n/a]