Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

ship-it

/ship-it

Prowadzi zmianę aplikacji od gałęzi po weryfikację na żywym adresie: wdrożenie, scalenie, tagowanie i poprawki awaryjne.

Repozytorium
claude-agents ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

95/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść30 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Prowadzi zmianę aplikacji od gałęzi po weryfikację na żywym adresie: wdrożenie, scalenie, tagowanie i poprawki awaryjne.

Wyzwalacze z opisu

done\
Oryginalny opis (EN)

<your-app>'s build-and-deploy loop. Use for ANY change to app code, templates, or static assets — from first branch to verified-live. Prevents the two failures that have actually bitten us: branching from a stale local main (nearly reverted a whole redesign) and reporting \"done\" without hitting the live URL. Triggers on: build, implement, fix, ship, deploy, release, PR, merge, tag, hotfix.

Jak działa

  1. 1. Branch from origin/main — never from local main
  2. 2. Smallest change that ships
  3. 3. Safety gate (if user-facing)
  4. 4. Local checks — all of them, fix everything (example commands: use your own stack)
  5. 4b. Journey check: new screens and new flows only
  6. 4c. Design consistency gate: EVERY UI change (founder rule, non-negotiable)
  7. 5. Commit + PR
  8. 6. Review gate
  9. 7. Merge ≠ deploy
  10. 8. Deploy
Sekcje z nagłówków SKILL.md, w oryginale · 107 linii, 656 słów
Podgląd SKILL.md
---
name: "ship-it"
description: "<your-app>'s build-and-deploy loop. Use for ANY change to app code, templates, or static assets — from first branch to verified-live. Prevents the two failures that have actually bitten us: branching from a stale local main (nearly reverted a whole redesign) and reporting \"done\" without hitting the live URL. Triggers on: build, implement, fix, ship, deploy, release, PR, merge, tag, hotfix."
---

# Ship it

Follow in order. Do not skip steps 1, 7, or 9.

## 1. Branch from `origin/main` — never from local main

Local `main` drifts. It has been **15 commits behind** while also ahead. A PR built on
stale main once carried a large deletion that would have reverted a redesign.

```bash
git fetch origin -q
git worktree add -b feat/<short-name> <scratch-dir>/<name> origin/main
```

Work **in that worktree**. Never edit the primary working dir for a feature.
Sanity-check before trusting any file you are about to edit:
```bash
git rev-list --left-right --count origin/main...HEAD   # expect 0  0
```

## 2. Smallest change that ships

One feature per branch. If it needs a decision, use the `lean-spec` skill first.

## 3. Safety gate (if user-facing)

Any patient-visible feature, label, or health copy → run the **`clinical-safety-gate`**
skill. Any data flow / storage / sharing / logging change → run
**`consumer-health-privacy`** and route `@security-reviewer`.

## 4. Local checks — all of them, fix everything (example commands: use your own stack)

```bash
.venv/Scripts/python -m ruff check packages/ tests/ scripts/
.venv/Scripts/python -m ruff format --check packages/ tests/ scripts/
.venv/Scripts/python -m mypy packages/
.venv/Scripts/pytest.exe tests/ -q
```
Front-end-only change (HTML/CSS/images): these do not apply — instead grep for tests
asserting on the markup you changed, and render the page to check it.

## 4b. Journey check: new screens and new flows only

A **new screen or new flow**: **@product-designer** walks the relevant journeys in
`docs/planning/product/key-journeys.md` at a true 390px as a careful 60-year-old first-time user
(taps, seconds, screenshots). Over 60 s or over the tap budget, a dead end, low contrast or a tap
target under 48px fails the change. Wording, colour or small layout tweaks: the PA checks a
390px screenshot instead (founder rule).

## 4c. Design consistency gate: EVERY UI change (founder rule, non-negotiable)

Before review, take a 390px screenshot of the changed screen next to a neighbouring screen that
already follows `docs/planning/product/design.md`. Check: font, title/subtitle/label/row text
sizes, row height and padding, card/segment and divider style, borders, button shape, spacing.
Any mismatch fails the change. No one-off sizes, paddings, radii, borders or colours in page
CSS: use the shared tokens. Missing rule → add it to `design.md` + tokens first.

## 5. Commit + PR

Conventional commits. Push the branch, open a PR against `main`.

## 6. Review gate

Call only the reviewers the change needs — see the **review routing table** in CLAUDE.md.
Code changes need `@code-reviewer` + **founder sign-off**; `@cto` only for schema / model /
infra. One round; re-review only after a BLOCK. Docs-only changes go direct to main.

## 7. Merge ≠ deploy

Merge only through your gated merge script (e.g. `scripts/safe_merge.sh <pr>`, which refuses unless CI passed). No `--auto`, no `--admin`.

Merging ships **nothing**. Production deploys **only on a `vX.Y.Z` tag** (record this as an ADR).

```bash
git fetch origin --tags -q && git tag -l 'v*' | sort -V | tail -1   # find current
git tag vX.Y.Z <merge-commit> -m "<what>" && git push origin vX.Y.Z
```

## 8. Deploy

From a clean checkout of the merged `main` (the worktree works if its tree matches):
```bash
<your-deploy-command> --image-label vX.Y.Z
```
Check your deploy tool's login first. If the login has expired, the human re-authenticates;
never paste credentials into a chat or a file in the repo.

## 9. Smoke-test live — before saying "done"

Never report success from a green deploy log. Hit the real host:
```bash
curl -s -o /dev/null -w "%{http_code} %{content_type}\n" https://<your-app-host>/<asset>
curl -s https://<your-app-host>/<page> | grep -o "<expected marker>"
```
Confirm the **new** thing is present and the **old** thing is gone.

If you have more than one surface (static site vs API), check the right host for the
change: a deploy of one does not touch the other.

## 10. Clean up

```bash
git worktree remove <path> --force; git worktree prune; git branch -d feat/<name>
```
Then report: what shipped, the tag, and the smoke-test evidence.

Wersje

RepozytoriumWynikLicencja
Ta strona · lexiome/claude-agents95MIT
vectorize-io/hindsight100MIT
Smana/cloud-native-ref100Apache-2.0
vickydotbat/vicky-skills100MIT
adamlinscott/claude-skills100MIT
paultyng/skill-issue100MIT
alexandrosandre/alice-issue-agent100CC-BY-4.0
alexandrosandre/agentic-engineering100CC-BY-4.0
stevengonsalvez/agents-in-a-box100MIT

Migawka bazy z 13.11.2026 · wersja paczki 769cd8cd0ee5 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100workflow-ship-and-observe
    Prowadzi scalony, zielony kod do zweryfikowanego i monitorowanego wydania produkcyjnego działającej aplikacji.
  • 100shipit
    Prowadzi kod od zweryfikowanej gałęzi do wdrożenia, wykrywa stos technologiczny i uruchamia bramki, build, testy oraz tryby PR, wydania i hotfix.
  • 90ship
    Scala sprawdzony pull request, sprząta jego gałąź i drzewo robocze, a gdy trzeba, uruchamia wydanie lub wdrożenie.
  • 100release
    Przenosi gotową pracę do użytkowników: scala pull requesty, wdraża je i sprawdza stan po wdrożeniu.
  • 90sdlc-ship
    Doprowadza sprawdzoną zmianę do wskazanego etapu: commit, PR, scalenie, wydanie lub wdrożenie, wyłącznie na wyraźne wywołanie.
  • 96god-ship
    Prowadzi bramkę wydania: wymaga świeżych testów i przeglądu, a potem prowadzi przez wdrożenie, wycofanie i notatki wydania.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.