release-prep

リリース準備スキル

このスキルは、MassGen のリリース準備を自動化し、CHANGELOG のエントリーや告知文を生成して、ドキュメントを検証します。

使用するタイミング

新しいリリースを準備するときに、このスキルを実行します。

• リリース PR を main にマージした後
• git タグを作成する前

使用方法

/release-prep v0.1.34

このスキルの処理内容

1. 変更を収集する

最後のタグ以降のコミットと PR を読み取ります。

# Get last tag
git describe --tags --abbrev=0

# Get commits since last tag
git log v0.1.33..HEAD --oneline

# Get merged PRs (if using GitHub)
gh pr list --base main --state merged --search "merged:>2024-01-01"

2. 前回の告知をアーカイブする

docs/announcements/current-release.md が存在する場合：

# Extract version from current-release.md
VERSION=$(grep -m1 "^# MassGen v" docs/announcements/current-release.md | sed 's/# MassGen v\([^ ]*\).*/\1/')

# Archive it
mv docs/announcements/current-release.md docs/announcements/archive/v${VERSION}.md

3. CHANGELOG エントリーを生成する

CHANGELOG.md の先頭にある Recent Releases セクションを更新します。

• 新しいリリースの概要を先頭に追加します
• このセクションには最新のリリースを3件だけ残します
• 古いエントリーを削除します（詳細な変更履歴には残します）

Keep a Changelog 形式に従って、構造化されたエントリーを作成します。

## [0.1.34] - YYYY-MM-DD

### Added
- **Feature Name**: Description
  - Implementation details

### Changed
- **Modified Feature**: What changed

### Fixed
- **Bug #123**: Description of fix

### Documentations, Configurations and Resources
- **Feature Guide**: New `docs/source/user_guide/feature.rst` for feature usage
- **Design Document**: New `docs/dev_notes/feature_design.md` for implementation details
- **Updated Docs**: Updated `docs/source/reference/cli.rst` with new commands
- **Skills**: New `massgen/skills/skill-name/SKILL.md` for automation

ドキュメントセクションのルール：

• 具体的なファイルパス（.rst、.md、.yaml ファイル）を記載します
• 新しく追加したファイルには「New」、変更したファイルには「Updated」を使用します
• git diff <last-tag>..HEAD --name-only -- "*.md" "*.rst" "*.yaml" を実行して、変更されたドキュメントを確認します

分類ルール：

• feat: コミット → Added
• fix: コミット → Fixed
• docs: コミット → Documentation
• refactor:、perf: コミット → Changed
• 破壊的変更 → ⚠️ を付けて強調します

コントリビューター：

• git shortlog -sn <last-tag>..HEAD を実行して、すべてのコントリビューターを確認します
• Technical Details セクションに、コミット数の多い順でコントリビューターを記載します

4. Sphinx ドキュメントを更新する

docs/source/index.rst の Recent Releases セクションを更新します。

# Update Recent Releases section (keep latest 3 releases)
# Add new release at top, remove oldest (v0.1.X-3)

形式：

Recent Releases
---------------

**v0.1.44 (January 28, 2026)** - Execute Mode for Independent Plan Selection

New Execute mode for cycling through Normal → Planning → Execute modes via ``Shift+Tab``. Users can independently browse and select from existing plans with a plan selector popover. Context paths preserved between planning and execution phases. Enhanced case studies page with setup guides and quick start instructions.

**v0.1.43 (January 26, 2026)** - Tool Call Batching & Interactive Case Studies

...

**v0.1.42 (January 23, 2026)** - TUI Visual Redesign

...

このセクションには最新のリリースを3件だけ残します。古いリリースは完全な変更履歴に残します。

5. Configs ドキュメントを更新する

massgen/configs/README.md の Release History セクションを更新します。

## Release History & Examples

### v0.1.44 - Latest
**New Features:** Execute Mode for Independent Plan Selection, Case Studies UX Enhancements

**Key Features:**
- **Execute Mode Cycling**: Navigate through Normal → Planning → Execute modes via `Shift+Tab`
- **Plan Selector Popover**: Browse and select from up to 10 recent plans with timestamps
- **Context Path Preservation**: Context paths automatically preserved between planning and execution
- **Enhanced Case Studies**: Setup guides and quick start instructions on case studies page

**Example Usage:**
```bash
# Use the TUI with plan mode cycling
massgen --config @examples/basic/multi/three_agents_default

# In the TUI:
# 1. Press Shift+Tab to enter Planning mode
# 2. Create a plan: "Create a Python web scraper for news articles"
# 3. Press Shift+Tab twice to enter Execute mode
# 4. Select your plan from the popover and press Enter to execute

### 6. Update README.md

#### 6.1 Latest Features Section

Update the "🆕 Latest Features" section:

```markdown
## 🆕 Latest Features (v0.1.44)

**🎉 Released: January 28, 2026**

**What's New in v0.1.44:**
- **🔄 Execute Mode** - Cycle through Normal → Planning → Execute modes via `Shift+Tab` to independently browse and execute existing plans
- **📋 Plan Selector** - Browse up to 10 recent plans with timestamps, view full task breakdowns, and execute with preserved context paths
- **📚 Enhanced Case Studies** - Interactive setup guides and quick start instructions on case studies page
- **⚡ TUI Performance** - Optimized timeline rendering with viewport-based scrolling for faster UI responsiveness
- **🔧 Plan Mode Fixes** - Fixed planning instruction injection bug in execute mode, improved tool tracking

**Try v0.1.44 Features:**
```bash
# Install or upgrade
pip install --upgrade massgen

# Experience Execute mode with plan cycling
uv run massgen --display textual

# In the TUI:
# 1. Press Shift+Tab to enter Planning mode
# 2. Create a plan: "Build a Python web scraper"
# 3. Press Shift+Tab twice to enter Execute mode
# 4. Select your plan and press Enter to execute

Also update the table of contents link from v0.1.43 → v0.1.44.

#### 6.2 Recent Achievements Section

Move the current "Recent Achievements" to "Previous Achievements" and add new release:

```markdown
### Recent Achievements (v0.1.44)

**🎉 Released: January 28, 2026**

#### Execute Mode for Independent Plan Selection
- **Mode Cycling**: Navigate through Normal → Planning → Execute modes via `Shift+Tab` or mode bar click
- **Plan Selector Popover**: Browse up to 10 recent plans with timestamps and original prompts
- **View Full Plan**: Modal displays complete task breakdown from selected plan
- **Empty Submission**: Press Enter to execute selected plan without additional input
- **Context Path Preservation**: Context paths (`@/path/to/file`) automatically restored from planning to execution phase

...

### Previous Achievements (v0.0.3 - v0.1.43)

✅ **Tool Call Batching & Interactive Case Studies (v0.1.43)**: Consecutive MCP tool calls grouped into collapsible tree views...

roadmap の TOC リンクも更新します。

• [Recent Achievements (v0.1.43)] → [Recent Achievements (v0.1.44)]
• [Previous Achievements (v0.0.3 - v0.1.42)] → [Previous Achievements (v0.0.3 - v0.1.43)]
• [v0.1.44 Roadmap] → [v0.1.45 Roadmap]

末尾の roadmap セクションを更新し、次のバージョン（v0.1.45）を参照するようにします。

7. ROADMAP.md を更新する

メインの roadmap ファイルを更新します。

7.1 バージョンと日付

**Current Version:** v0.1.44

**Last Updated:** January 28, 2026

7.2 リリース表

すべてのリリースを下にずらし、新しい次回リリースを追加します。

| Release | Target | Feature | Owner | Use Case |
|---------|--------|---------|-------|----------|
| **v0.1.45** | 01/30/26 | Improve Subagent Display in TUI | @ncrispino | Stream and view subagents with full timeline in TUI ([#821](...)) |
| **v0.1.46** | 02/02/26 | Next feature | @owner | Use case |

7.3 完了セクションを追加する

リリースしたばかりのバージョンを COMPLETED として追加します。

## ✅ v0.1.44 - Execute Mode & Case Studies Enhancement (COMPLETED)

**Released: January 28, 2026**

### Features

- **Execute Mode**: Independent mode for browsing and executing existing plans ([#819](...))
  - Cycle through Normal → Planning → Execute modes via `Shift+Tab`
  - Plan selector popover shows up to 10 recent plans with timestamps
  - "View Full Plan" button opens modal with all tasks
  - Empty submission executes selected plan
  - Context paths preserved from planning to execution phase

...

### Bug Fixes
- Fixed planning instruction injection during execute mode
- Improved tool call spacing in TUI
- Enhanced timeline performance with viewport optimization

7.4 次回リリースセクションを更新する

次回リリースの見出しを変更します。

## 📋 v0.1.45 - Improve Subagent Display in TUI

### Features

**1. Subagent TUI Streaming** (@ncrispino)
- Issue: [#821](...)
- Stream and display subagents almost identically to main process in TUI
...

8. 次回リリースの roadmap を作成する

詳細なマイルストーンを記載した ROADMAP_v0.1.X+1.md を作成します。

# MassGen v0.1.45 Roadmap

## Overview

Version 0.1.45 focuses on [MAIN THEME].

- **Feature 1** (Required): Description
- **Feature 2** (Required): Description

## Key Technical Priorities

1. **Feature 1**: Details
   **Use Case**: Why this matters

2. **Feature 2**: Details
   **Use Case**: Why this matters

## Key Milestones

### Milestone 1: [Feature Name] (REQUIRED)

**Goal**: What we're building

**Owner**: @username (discord)

**Issue**: [#XXX](...)

#### 1.1 Research & Design
- [ ] Task 1
- [ ] Task 2

#### 1.2 Implementation
- [ ] Task 1
- [ ] Task 2

...

**Success Criteria**:
- Criteria 1
- Criteria 2

GitHub の Issue、特に次のマイルストーンが付けられたものを確認し、roadmap に反映します。

9. Sphinx ドキュメントをビルドする

Sphinx ドキュメントをビルドして検証します。

cd docs
make clean
make html

以下を確認します。

• ❌ ビルドエラーがない
• ❌ リンク切れがない
• ⚠️ 警告は最小限に抑える（回避できないものは記録します）
• ✅ 新しいコンテンツが正しく表示される

任意：リンクチェッカーを実行します。

cd docs
make linkcheck

10. リリースノートを作成する

以前のリリースで確立された形式に従って、RELEASE_NOTES_v0.1.X.md を作成します。

形式の参考： GitHub で前回のリリースを確認します。

gh release view v0.1.43

テンプレートの構成：

# 🚀 Release Highlights — v0.1.X (YYYY-MM-DD)

### 🎯 [Feature Name](https://docs.massgen.ai/en/latest/path/to/docs.html)
- **Bullet Point**: Description
- **Bullet Point**: Description

### 📚 [Another Feature](https://docs.massgen.ai/en/latest/path/to/docs.html)
- **Bullet Point**: Description

### 🔧 Bug Fixes
- **Fix Description**: What was fixed

---

### 📖 Getting Started
- [**Quick Start Guide**](https://github.com/massgen/MassGen?tab=readme-ov-file#1--installation): Try the new features today
- **Try Feature Name**:

```bash
# Example command showing the new feature
uv run massgen [example command]

変更点

• PR のタイトル、@author、PR_URL
• PR のタイトル、@author、PR_URL

完全な変更履歴：https://github.com/massgen/MassGen/compare/v0.1.X-1...v0.1.X

**Get PRs for What's Changed:**
```bash
gh pr list --base dev/v0.1.X --state merged --json number,title,url,author \
  | jq -r '.[] | "* \(.title) by @\(.author.login) in \(.url)"'

重要：

• 絵文字付きのセクション見出しを使用します（🚀 🔄 📚 ⚡ 🔧 📖）
• 機能名を関連ドキュメントにリンクします（リンクが正確であることを確認してください！）
• 実用的なコマンド例を含めます
• 「What's Changed」にマージ済みの PR をすべて記載します
• 「Full Changelog」の比較リンクを追加します

11. 告知を生成する

docs/announcements/current-release.md を作成します。

# MassGen vX.X.X Release Announcement

## Release Summary

We're excited to release MassGen vX.X.X, adding [MAIN FEATURE]! 🚀

[2-3 sentences describing the key changes]

## Install

\`\`\`bash
pip install massgen==X.X.X
\`\`\`

## Links

- **Release notes:** https://github.com/massgen/MassGen/releases/tag/vX.X.X
- **X post:** [TO BE ADDED AFTER POSTING]
- **LinkedIn post:** [TO BE ADDED AFTER POSTING]

12. ドキュメントを検証する

必須のドキュメントが存在することを確認します。

# Check for user guide updates (if new features)
ls docs/source/user_guide/

# Check capabilities.py updated (if new models)
git diff v0.1.33..HEAD -- massgen/backend/capabilities.py

# Check token_manager.py (if pricing changes)
git diff v0.1.33..HEAD -- massgen/token_manager/token_manager.py

# Check for case study
ls docs/source/examples/case_studies/

13. 文字数を確認する

告知文が LinkedIn の約3000文字の上限に収まることを確認します。

# Count characters
cat docs/announcements/current-release.md docs/announcements/feature-highlights.md | wc -m

# Should be < 3000

14. スクリーンショット／メディアの提案

このリリースでの変更内容に基づいて、撮影するスクリーンショットまたは GIF を提案します。

機能とスクリーンショットの対応表：

変更の種類	スクリーンショットの提案
新しいバックエンド／モデルのサポート	エージェントが新しいモデルを使用して、正常に応答する様子を示すターミナル
複数エージェントの連携	色分けされた出力で、複数のエージェントが並行して動作する様子
投票／合意形成	エージェントの判断と最終的な選択が表示される投票フェーズ
MCP ツール	実行結果（ファイル操作、検索など）が見えるツールの実行画面
コンテキスト圧縮	圧縮の統計情報とメッセージ数を示すログ出力
メモリ／永続化	エージェントが前回のセッションのコンテキストを思い出している様子
Web UI の変更	エージェントのアクティビティや新しい UI 機能を表示するダッシュボード
コスト追跡	エージェントごとのトークン使用量とコストを示す概要
エラー処理	エージェントが障害から適切に回復する様子
パフォーマンスの改善	処理時間またはスループットの変更前後の比較
新しい設定オプション	新しいオプションを強調表示した YAML 設定スニペット

分析方法：

1. コミットから主な機能を確認します
2. 最も視覚的に訴求力のある変更を特定します
3. 機能を実演する具体的なコマンドを提案します
4. 静止画よりも GIF（VHS 経由）が適しているかどうかを記載します

出力例：

### 📸 Suggested Screenshot for v0.1.34

Based on this release's changes, recommend capturing:

**Primary:** GPT-5 model support
- Run: `massgen --config massgen/configs/providers/openai/gpt5_demo.yaml "Explain quantum computing"`
- Capture: Terminal showing GPT-5 model name in agent output with response

**Alternative:** Context compression improvements
- Run: `massgen --automation --config [long-context-config] "question" | grep compression`
- Capture: Log output showing reduced token counts

**Media type:** Static screenshot is fine (no complex animation needed)

15. 出力の概要

チェックリストを表示します。

## Release Prep Summary for v0.1.34

✅ Archived previous announcement → archive/v0.1.33.md
✅ Updated CHANGELOG.md with v0.1.34 entry
✅ Updated docs/source/index.rst Recent Releases
✅ Updated massgen/configs/README.md Release History
✅ Updated README.md Latest Features section
✅ Updated README.md Recent Achievements section
✅ Updated ROADMAP.md (current version, release table, completed section)
✅ Created ROADMAP_v0.1.35.md for next release
✅ Built Sphinx documentation successfully
✅ Created current-release.md
✅ Character count: 2847/3000

### Manual Steps Remaining:
1. Review all updated files for accuracy
2. Capture suggested screenshot (see below)
3. Stage and commit changes
4. Push and create PR to main
5. After merge: Create tag (git tag v0.1.34 && git push origin v0.1.34)
6. Publish GitHub Release (triggers PyPI publish)
7. Post to LinkedIn/X with screenshot, update links in current-release.md

### 📸 Screenshot Suggestion:
[Feature-specific suggestion based on changes]

### Validation Warnings:
⚠️ No case study found for this release
⚠️ capabilities.py was modified - verify docs updated
⚠️ README_PYPI.md will auto-sync via pre-commit hook

参照ファイル

ドキュメントファイル

• CHANGELOG： CHANGELOG.md - リリース履歴の全記録
• Sphinx ドキュメントのホームページ： docs/source/index.rst - 最近のリリースのセクション
• 設定ファイルの README： massgen/configs/README.md - リリース履歴と例
• メイン README： README.md - 最新の機能と最近の主な成果
• メインロードマップ： ROADMAP.md - 現在のバージョン、リリース一覧、完了したリリース
• 次期リリースのロードマップ： ROADMAP_v0.1.X+1.md - 次のバージョンの詳細なマイルストーン

告知ファイル

• 告知ディレクトリ： docs/announcements/
• 現在のリリース： docs/announcements/current-release.md
• 機能のハイライト： docs/announcements/feature-highlights.md
• アーカイブ： docs/announcements/archive/ - 過去のリリース

プロセスのドキュメント

• リリースチェックリスト： docs/dev_notes/release_checklist.md - 手順をすべて記載したガイド
• README の同期： README_PYPI.md - pre-commit フックで自動同期

ヒント

• PR を作成する前に、リリースブランチ（例：dev/v0.1.44）でこのスキルを実行します
• コミットする前に、生成されたすべての内容が正確かどうかを必ず確認します
• このリリースで大きな新機能が追加される場合は、feature-highlights.md を更新します
• ソーシャルメディアへの投稿後、current-release.md のリンクを更新します
• README_PYPI.md は pre-commit フックで自動的に同期されます。README.md の変更をコミットするだけです
• 最近のリリースのセクションは最大 3 件にします（Sphinx ドキュメント、CHANGELOG の先頭セクション）
• 追跡可能性を確保するため、ロードマップの更新には GitHub の issue 番号を使用します
• Sphinx ドキュメントをビルドし（cd docs && make html）、書式の問題を早めに確認します