heymegabyte/agent-skills / 08-deploy-and-runtime-verification
deploy-and-runtime-verification
UnverifiedMANDATORY deploy after every code change. Typecheck → deploy → purge CDN → E2E on production → visual verify → fix-forward loop. Workers Builds native CI/CD, D1 Time Travel PIT recovery, D1→R2 long-term backups, wrangler rollback, wrangler secrets management, structured observability, cross-browser smoke tests, rollback procedures, and GitHub auto-configuration.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.6 KB |
| backup-and-disaster-recovery.md | markdown | 2.7 KB |
| changelog-and-releases.md | markdown | 5.3 KB |
| ci-cd-pipeline.md | markdown | 7.1 KB |
| critical-css.md | markdown | 4.7 KB |
| font-subsetting.md | markdown | 4.5 KB |
| gh-fix-ci.md | markdown | 3.5 KB |
| launch-day-sequence.md | markdown | 5.2 KB |
| pipeline-health-check.md | markdown | 4.5 KB |
| r2-lifecycle.md | markdown | 5.6 KB |
| service-worker.md | markdown | 9.7 KB |
| uptime-and-health.md | markdown | 6.5 KB |
changelog-and-releases.md
View on GitHub---
name: "Changelog and Releases"
version: "1.1.0"
updated: "2026-04-23"
description: "Auto-generate changelog from conventional commits. Public /changelog page, GitHub Releases, semver rules, social announcement on minor+ releases."
---
# Changelog and Releases
## Conventional Commits
All commits should follow conventional commits format:
```
feat: add donation progress bar
fix: contact form validation on mobile
docs: update README with new features
perf: compress hero image to 150KB
chore: update dependencies
```
### Commit Types
- **`feat`** — New feature — shows in changelog as "New"
- **`fix`** — Bug fix — shows in changelog as "Fixed"
- **`perf`** — Performance improvement — shows in changelog as "Improved"
- **`docs`** — Documentation — NOT in changelog
- **`chore`** — Maintenance — NOT in changelog
- **`refactor`** — Code restructure — NOT in changelog
- **`test`** — Tests — NOT in changelog
## Auto-Generate Changelog
```bash
# Using git log (no dependencies)
git log --pretty=format:"%h %s (%an, %ar)" --since="30 days ago" | \
grep -E "^[a-f0-9]+ (feat|fix|perf):" | \
sed 's/feat:/✨/; s/fix:/🐛/; s/perf:/⚡/'
```
### Changelog Page (/changelog)
```typescript
app.get('/changelog', async (c) => {
// Read from a changelog.json or D1 table
const entries = await getChangelogEntries(c.env);
return c.html(renderChangelog(entries));
});
```
## GitHub Releases
```bash
# Create a release after significant deploys
gh release create v1.2.0 --title "v1.2.0 — Donation Progress Bars" --notes "$(cat <<'EOF'
## What's New
- ✨ Real-time donation progress bar with Stripe webhooks
- ✨ Multi-language support (EN + ES)
## Fixed
- 🐛 Contact form validation on mobile Safari
- 🐛 OG image not showing on LinkedIn
## Improved
- ⚡ Hero image compressed from 400KB to 150KB
- ⚡ Lighthouse score: 72 → 91
EOF
)"
```
## Semantic Versioning
- **Major** (1.0.0 → 2.0.0) — breaking changes, redesign
- **Minor** (1.0.0 → 1.1.0) — new features
- **Patch** (1.0.0 → 1.0.1) — bug fixes
For most Emdash projects: start at 1.0.0, bump minor for features, patch for fixes.
### Version Bump Rules
- Multiple `feat` commits since last release → bump **minor**
- Only `fix` / `perf` commits since last release → bump **patch**
- Any commit with `BREAKING CHANGE:` in body or `!` after type → bump **major**
- Pre-release tags — use `-beta.1`, `-rc.1` for staging / preview deploys
## MCP Tools Available
### GitHub MCP (`mcp__github-mcp__*`)
- **`list_releases`** — list existing releases to determine next version
- **`get_latest_release`** — get the latest release tag for version bumping
- **`get_release_by_tag`** — fetch a specific release's notes
- **`list_tags`** — list all tags to check version history
- **`get_tag`** — get details of a specific tag
- **`list_commits`** — fetch commits since last release for changelog generation
- **`get_commit`** — get details of a specific commit
- **`create_or_update_file`** — update `CHANGELOG.md` in the repo
- **`push_files`** — push changelog + version bump in one commit
## Automated Changelog Generation from Git Log
### Step-by-step workflow
1. **Get latest release tag** — `mcp__github-mcp__get_latest_release` → extract tag name
2. **List commits since that tag** — `mcp__github-mcp__list_commits` with `sha: main` and filter by date
3. **Parse conventional commits** — categorize into `feat` / `fix` / `perf` / `breaking`
4. **Determine version bump** — apply semver rules above
5. **Generate changelog entry** — format as markdown grouped by type
6. **Update CHANGELOG.md** — prepend new entry, push via `mcp__github-mcp__push_files`
7. **Create GitHub Release** — use `gh release create` with generated notes
```typescript
// Parsing conventional commits from git log
function parseCommits(commits: Array<{ message: string; sha: string; author: string }>) {
const categories = { feat: [], fix: [], perf: [], breaking: [] };
for (const c of commits) {
const match = c.message.match(/^(feat|fix|perf|docs|chore|refactor|test)(!?):\s*(.+)/);
if (!match) continue;
const [, type, bang, description] = match;
if (bang === '!' || c.message.includes('BREAKING CHANGE:')) {
categories.breaking.push({ description, sha: c.sha.slice(0, 7) });
}
if (type in categories) {
categories[type].push({ description, sha: c.sha.slice(0, 7) });
}
}
return categories;
}
```
## Acceptance Criteria
1. Every `feat` / `fix` / `perf` commit appears in changelog — diff changelog against git log, zero missing entries
2. Version follows semver rules — parse version string, verify bump type matches commit types
3. GitHub Release exists for every minor+ version — `mcp__github-mcp__list_releases` count matches expected releases
4. Release notes match changelog entry — diff release body against `CHANGELOG.md` section, identical content
5. `/changelog` page renders correctly — Playwright screenshot shows formatted entries, no empty state
6. Changelog page has valid date ordering — entries sorted newest-first, no date inversions
7. Social announcement fires for minor+ releases — 09/social-automation triggered, post confirmed on at least 2 platforms
8. No `docs` / `chore` / `refactor` / `test` commits leak into changelog — parse changelog, only `feat` / `fix` / `perf` / `breaking` entries present
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |