| name | magic-dev-release |
| description | Workflow for validating, versioning, and triggering a GitHub Release of the Magic Spec engine. |
Release Workflow
This workflow automates the end-to-end process of validating, versioning, and releasing the magic-spec engine.
The core logic is handled by the release script, which enforces QA gates and triggers distribution via GitHub Actions.
Agent Guidelines
CRITICAL INSTRUCTIONS FOR AI:
- One-Command Release: To initiate a release, simply run
node .agents/skills/magic-dev-release/scripts/release.js.
- Prerequisites: Ensure
.magic/.version is incremented and CHANGELOG.md has a corresponding entry before running.
- QA Gate: The script automatically runs tests and updates metadata. Do not attempt to bypass this.
- Automation: Distribution is handled by the
Release GitHub Action triggered by the tag push.
Workflow Steps
1. Preparation
- Increment Version: Update
.magic/.version (e.g., 2.0.2 → 2.0.3).
- Update Changelog: Add version entry and notes to
CHANGELOG.md.
- Commit Draft: (Optional) Commit any feature changes before running the release command.
2. Execution
Run the automated release script:
node .agents/skills/magic-dev-release/scripts/release.js
3. Verification
- Check Action:
gh run list --workflow release.yml --limit 1
- Verify Release:
gh release view vX.Y.Z
Release Completion Checklist
Release Workflow Checklist — vX.Y.Z
Preparation
☐ Version incremented in .magic/.version
☐ Entry exists in CHANGELOG.md
Execution
☐ Command 'node .agents/skills/magic-dev-release/scripts/release.js' executed
☐ Engine tests passed (automated)
☐ Metadata (C14) updated (automated)
☐ Git tag vX.Y.Z created and pushed (automated)
Verification
☐ GitHub Action 'Release' started
☐ Release archive correctly generated
