# Release Preflight Skill

> Pre-checks, version consistency, and deployment discipline.

- Skill: `majiayu000/release-preflight-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/release-preflight-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/release-preflight-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/release-preflight-skill

---


# Release Preflight Skill

> Pre-checks, version consistency, and deployment discipline.

## The Golden Rule

> **NEVER publish without running the preflight checklist.**

## Quick Start

```powershell
# Full preflight check
scripts/release-preflight.ps1

# With packaging test
scripts/release-preflight.ps1 -Package

# Skip time-consuming tests
scripts/release-preflight.ps1 -SkipTests
```

## Version Locations (Must Stay Synchronized)

| # | Location | Field | Example |
| - | -------- | ----- | ------- |
| 1 | `platforms/vscode-extension/package.json` | `version` | `"5.1.0"` |
| 2 | `CHANGELOG.md` | Latest heading | `## [5.1.0] - 2026-02-07` |
| 3 | `.github/copilot-instructions.md` | `**Version**:` line | `**Version**: 5.1.0` |
| 4 | `platforms/vscode-extension/.github/copilot-instructions.md` | Same as #3 |
| 5 | `docs/index.html` | Footer version | `v5.1.0` |
| 6 | `ROADMAP-UNIFIED.md` | Quick Status table | Master 5.1.0 row |
| 7 | Git tag | Tag name | `v5.1.0` |

## Preflight Gates

| Gate | Check | Script Flag |
|------|-------|-------------|
| 0 | PAT configured | Always |
| 1 | Version sync (all 7 locations) | Always |
| 2 | Build passes | Always |
| 3 | Lint passes | Always |
| 4 | Tests pass | `-SkipTests` to skip |
| 5 | Package creates | `-Package` to include |
| 6 | Human review | Manual |

## Full Release Workflow

```powershell
# VS Code Extension release
scripts/release-vscode.ps1 -BumpType minor

# M365 Agent release  
scripts/release-m365.ps1 -Validate
```

## Version Bump Only

```powershell
# 1. Bump
npm version patch --no-git-tag-version

# 2. Get version
$v = (Get-Content package.json | ConvertFrom-Json).version

# 3. Update CHANGELOG, commit, tag, push
git add -A; git commit -m "release: v$v"; git tag "v$v"; git push --tags
```

## Common Mistakes

| Mistake | Prevention |
| ------- | ---------- |
| Published without version bump | Run preflight first |
| CHANGELOG not updated | Script checks this |
| Forgot to push tags | Script does this |
| Version mismatch | Grep entire repo for old version |
| PAT 401 error | Refresh PAT before release |

## Related Scripts

| Script | Purpose |
|--------|---------|
| `scripts/release-preflight.ps1` | Pre-release validation |
| `scripts/release-vscode.ps1` | Full VS Code release |
| `scripts/release-m365.ps1` | M365 agent packaging |
| `.github/muscles/build-extension-package.ps1` | Full build (sync + compile + PII scan) |
| `.github/muscles/sync-architecture.js` | Canonical Master → Heir sync |

## Triggers

- "release", "publish", "deploy"
- "preflight", "pre-release check"
- "version bump", "version sync"

---

*Scripts: `scripts/release-preflight.ps1`, `scripts/release-vscode.ps1`*