SKILL·92153B

deploy-landed

avelikiy
Updated 16 days ago
2 views
103
13
103
View on GitHub
Designapi

About

This skill verifies that a deployment has fully landed by checking the live revision, environment, and functionality, rather than just trusting the deploy command's exit code. It's used after any deploy, rollout, or restart to confirm the update is live and also detects manual server drift before a pull. It's a low-effort check using Read, Bash, and Grep for devops and support roles.

Quick Install

Claude Code

Recommended
Primary
npx skills add avelikiy/great_cto -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/avelikiy/great_cto
Git CloneAlternative
git clone https://github.com/avelikiy/great_cto.git ~/.claude/skills/deploy-landed

Copy and paste this command in Claude Code to install this skill

Documentation

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.

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.

GitHub Repository

avelikiy/great_cto
Path: skills/deploy-landed
0
agentic-codingai-agentsclaude-codeclaude-code-pluginclaude-code-skillsclaude-code-subagents
FAQ

Frequently asked questions

What is the deploy-landed skill?

deploy-landed is a Claude Skill by avelikiy. Skills package instructions and resources that Claude loads on demand, so Claude can perform deploy-landed-related tasks without extra prompting.

How do I install deploy-landed?

Use the install commands on this page: add deploy-landed to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does deploy-landed belong to?

deploy-landed is in the Design category.

Is deploy-landed free to use?

Yes. deploy-landed is listed on AIMCP and free to install.

Related Skills

executing-plans
Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill
requesting-code-review
Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill
connect-mcp-server
Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill
web-cli-teleport
Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill