Skip to content

avelikiy/great_cto / skills/deploy-landed

deploy-landed

Verified

Prove a deploy landed — the served revision is the commit you meant, its env is present, and the product does its job — instead of trusting the deploy command's exit code. Also catches server drift before a pull or deploy. Use after any deploy, rollout, restart or server-side fix ("задеплой", "выкати", "проверь на проде", "почему не обновилось"). Loaded by devops, release-manager, l3-support, infra-provisioner.

deploy-landed — a deploy is done when the running thing is the thing you meant

A deploy command's exit code says the command finished. It does not say the new code is serving, that its configuration arrived, or that the product works. Every trap below produced a green exit and a broken or stale product on a real project:

TrapWhat happened
git pull failed, the build went onThe build succeeded from the old code and reported success
nohup … &Exit 0 twice for a process that died at once
docker exec into a containerIt does not inherit the entrypoint's env: two "config is missing" readings were false
sed -i / docker cp on a bind-mounted fileReplaced the inode; the container kept reading the old file
A fix applied only on the serverLost on the next deploy — it was never in git
wrangler / Pagesfunctions/ not deployed, _headers ignored, five deploys to notice
Prod behind SSOAnswers 401/302 to every path, including ones that do not exist — proves nothing about a route
/health greenFor six hours while the engine made no trades

Before: is the server what git says it is?

Before pulling or building on a host someone can reach by hand:

git -C /srv/app status --porcelain        # anything here is a patch that is not in git
git -C /srv/app log -1 --format=%H        # what the host thinks it runs

Anything uncommitted on the host is either committed first or reported as drift — never overwritten silently, and never left as the only copy of a fix.

After: four checks, each with its evidence

  1. Revision. What is serving equals the commit you meant.
    • Cloud Run / k8s: the live revision's image tag or digest, then git merge-base --is-ancestor <commit> <image-tag-sha>.
    • Pages / Workers / Vercel: the deployment id and its commit.
    • A plain host: the running process's start time is after the deploy, and the file it serves has the new content (grep for a string the change introduced).
    • A /version endpoint, when the app has one, beats all of the above.
  2. Configuration. The variables and secrets the new code reads are present in the running process — count them against the list the code expects. In a container, read them from PID 1 (cat /proc/1/environ | tr '\0' '\n'), not from docker exec env. After --set-secrets/--set-env-vars, check that the ones you did not name are still there: those flags replace the whole set.
  3. Function. One request that does the product's job and returns something you can compare to a known value — an order created, a row written, a trade placed on paper. A health endpoint proves the process is up, nothing more.
  4. Startup errors. Logs for the new revision since it started, at WARNING and above. Zero lines is a finding only if you saw the logs flowing at all.

Client artifacts: a frontend bundle or a mobile build

There is no server process to inspect, so "landed" is read from the artifact itself.

  • Web frontend. The production URL returns the commit you promoted — /version.json, a build-sha meta tag, or the host's deployment id and its commit. Bypass the edge cache (cache-busting query) and read the cache header: a stale index.html with a long max-age keeps users on the old build. Function = a Playwright golden path on the production URL, not "the page loads".
  • Mobile. The build number inside the artifact (bundletool dump manifest, PlistBuddy) equals the one you set; the store shows that build processed (TestFlight) or completed on the track (Play); the installed app reports that build. Function = the Maestro flows on that installed build.
  • OTA update. The update group id is published on the channel you meant, and its runtime fingerprint equals the native build's.

Report

End the deploy report with this block. A check you could not run is NOT CHECKED with the reason — never omitted, never PASS.

DEPLOY-LANDED <service> @ <commit>
  revision : PASS — serving <revision/deployment id> built from <sha>
  config   : PASS — 14/14 expected vars present in PID 1
  function : PASS — POST /orders → 201, row id 8812 visible in DB
  startup  : PASS — 0 WARNING+ lines since 12:04:10

A FAIL in any line means the deploy is not done, whatever the command printed.

writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall