agentleFS
pranataa-labspranataa-labs/Workflow-Master/skills/release-deploy-check/SKILL.md

release-deploy-check

Skill2 starsChanged 8 days agoMITView on GitHub

Release verification procedure for Stage 8 (Release): pre-release gates, push, monitoring the GitHub Actions run until it finishes, and probing the live URL (GitHub Pages, Vercel, Netlify, or a custom server) for HTTP status, expected content, and broken base paths. Includes rollback steps. Use after pushing to a deploy branch, when publishing to GitHub Pages, or whenever the user asks whether a deployment succeeded.

  • Commits and pushes

The file

Files
SKILL.md

Release and Deploy Check

Push yang berhasil bukan bukti rilis berhasil. Tahap 8 (Release) selesai hanya bila pipeline deploy lulus dan halaman live merespons dengan konten yang diharapkan.

Rule terkait: 08 (DevOps & CI/CD), 09 (Reliability), 10 (Performance).


1. Gerbang Sebelum Rilis

  • verify-and-test lulus (minimal typecheck dan build)
  • diff-review tanpa [BLOCK]
  • Untuk perubahan yang menyentuh auth, endpoint, atau upload: security-audit dijalankan
  • Untuk Vite + GitHub Pages: base di vite.config.ts sesuai ("./" atau "/<repo>/"), aset di public/ dirujuk secara relatif
  • Rilis ke produksi hanya bila diotorisasi pengguna

2. Verifikasi Otomatis

# Pantau run terbaru di branch main, lalu cek URL live
powershell -ExecutionPolicy Bypass -File skills/release-deploy-check/scripts/check-deploy.ps1 `
  -Repo pranataa-labs/Personal-Portfolio `
  -Url https://pranataa-labs.github.io/Personal-Portfolio/ `
  -Expect "Aria Sastra"
ParameterDefaultFungsi
-Repodeteksi dari originowner/name
-BranchmainBranch yang memicu deploy
-UrlkosongURL live yang diperiksa setelah run sukses
-ExpectkosongTeks yang wajib ada di HTML respons
-TimeoutSec600Batas waktu menunggu run selesai

Skrip melakukan:

  1. Mengambil run terbaru (gh run list) untuk branch tersebut.
  2. Menunggu sampai selesai (gh run watch --exit-status).
  3. Bila gagal, menampilkan log langkah yang gagal (gh run view --log-failed).
  4. Bila sukses dan -Url diberikan, mengirim permintaan HTTP dengan cache-buster, memeriksa status 200, teks -Expect, serta memastikan aset JS dan CSS yang dirujuk HTML tidak 404.

3. Kegagalan Umum

GejalaPenyebab umumPerbaikan
Halaman putih, aset 404base Vite salah untuk subpath PagesSet base: "./" atau "/<repo>/"
Gambar di public/ tidak tampilPath absolut /images/x.png di subpathGunakan ./images/x.png
Run sukses tetapi konten lamaCache CDNTunggu 1 sampai 2 menit, cek dengan query ?v=<timestamp>
Refresh rute SPA menghasilkan 404Pages tidak mendukung rewriteSalin index.html ke 404.html saat build, atau gunakan hash router
Deploy gagal di npm ciLockfile tidak sinkronJalankan npm install, commit lockfile

4. Rollback

git revert <commit-bermasalah> --no-edit
git push origin main

Gunakan revert, bukan reset --hard + force push, agar riwayat tetap utuh. Untuk Vercel/Netlify, promosikan deployment sebelumnya dari dashboard atau CLI.


5. Laporan

[RELEASE] pranataa-labs/Personal-Portfolio @ 93ceefc
Pipeline : Deploy to GitHub Pages #41733149068  SUCCESS (33 s)
Live     : https://pranataa-labs.github.io/Personal-Portfolio/  200 OK
Content  : "Aria Sastra" ditemukan; 2 aset JS/CSS 200
Verdict  : RILIS TERVERIFIKASI

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.