# Deployment

> Enable and operate the Deployment feature (ops/deploy conventions + deploy scripts) for multi-environment delivery. Use when this capability is needed.

- Skill: `tomevault-io/deployment-14` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/deployment-14`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/deployment-14/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/deployment-14

---


# Deployment Feature

## Intent

Standardize how the repo describes and executes deployments across environments (dev/staging/prod) in an LLM-friendly, auditable way.

The repo keeps deployment artifacts under `ops/deploy/` and exposes a small set of controller scripts under `.ai/`.

## What gets enabled

When enabled, this feature materializes:

- `ops/deploy/**`
  - `ops/deploy/environments/*.yaml`
  - `ops/deploy/k8s/manifests/deployment.template.yaml`
  - `ops/deploy/scripts/healthcheck.mjs`
  - `ops/deploy/handbook/**` (runbooks, rollback procedure)

Controller scripts (provided by the template SSOT):

- `node .ai/skills/features/deployment/scripts/ctl-deploy.mjs` — deployment configuration management
- `node .ai/skills/features/deployment/scripts/rollback.mjs` — rollback entry point (human-run)

## How to enable

1. Copy templates from:
   - `.ai/skills/features/deployment/templates/`
   into the repo root.
2. Initialize:

```bash
node .ai/skills/features/deployment/scripts/ctl-deploy.mjs init
node .ai/skills/features/deployment/scripts/ctl-deploy.mjs verify
```

Optional (recommended for LLM routing): record the flag in project state:

```bash
node .ai/scripts/ctl-project-state.mjs init
node .ai/scripts/ctl-project-state.mjs set features.deployment true
```

## Operating rules

- Deployment and rollback are **human-executed** operations.
- Record plans and run results under `ops/deploy/handbook/`.
- Never store secrets in repo; use environment secret managers.

## Verification

```bash
node .ai/skills/features/deployment/scripts/ctl-deploy.mjs verify
```

## Boundaries

- Deployment/rollback are human-executed; do not run live deploy commands as the AI agent.
- Do not store secrets in repo; keep only non-secret configs/templates under `ops/deploy/**`.
- Keep changes within the declared blast radius (`ops/deploy/**` and related controller scripts).

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/willyu1007) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->