release

/release - リリースワークフロー

自信を持ってリリースできるよう、体系的に準備します。

使用するタイミング

• 「リリースの準備をする」
• 「バージョン X を出荷する」
• 「本番環境にリリースする」
• 「リリースを切る」
• 「デプロイの準備ができた」
• 本番環境にデプロイする前

ワークフローの概要

┌─────────┐    ┌─────────┐    ┌──────────────┐    ┌──────────┐    ┌─────────┐
│  aegis  │───▶│  atlas  │───▶│ review-agent │───▶│  herald  │───▶│  scribe │
│         │    │         │    │              │    │          │    │         │
└─────────┘    └─────────┘    └──────────────┘    └──────────┘    └─────────┘
  Security       E2E            Final              Version         Release
  audit          tests          review             bump            notes

エージェントの順序

#	エージェント	役割	出力
1	aegis	セキュリティ脆弱性スキャン	セキュリティレポート
2	atlas	E2E テストスイート全体の実行	テストレポート
3	review-agent	最終リリースレビュー	リリース承認
4	herald	バージョン更新、変更履歴の生成	更新済みのバージョンファイル
5	scribe	リリースノート、ドキュメント	RELEASE.md、docs

この順序の理由

1. まずセキュリティ：出荷前に脆弱性を検出します
2. E2E テスト：システム全体がエンドツーエンドで動作することを確認します
3. 最終レビュー：人間が介在して承認します
4. バージョン更新：承認後にのみ実施します
5. ドキュメント：適切なリリースノートとともに出荷します

実行

フェーズ 1：セキュリティ監査

Task(
  subagent_type="aegis",
  prompt="""
  Security audit for release: [VERSION]

  Scan for:
  - Dependency vulnerabilities (npm audit, pip audit)
  - Hardcoded secrets/credentials
  - SQL injection, XSS, CSRF risks
  - Authentication/authorization issues
  - Insecure configurations

  Output: Security report with severity levels
  """
)

フェーズ 2：E2E テスト

Task(
  subagent_type="atlas",
  prompt="""
  Run E2E tests for release: [VERSION]

  Execute:
  - Full E2E test suite
  - Critical path tests
  - Integration tests
  - Performance benchmarks (if applicable)

  Output: Test report with pass/fail counts
  """
)

フェーズ 3：最終レビュー

Task(
  subagent_type="review-agent",
  prompt="""
  Final release review: [VERSION]

  Review:
  - Security audit results
  - E2E test results
  - Changes since last release (git log)
  - Breaking changes
  - Migration requirements

  Output: RELEASE_APPROVED or RELEASE_BLOCKED with reasons
  """
)

フェーズ 4：バージョン更新と変更履歴

Task(
  subagent_type="herald",
  prompt="""
  Prepare release: [VERSION]

  Tasks:
  - Bump version in package.json/pyproject.toml
  - Generate CHANGELOG.md entry
  - Update version constants in code
  - Tag commit (don't push yet)

  Follow semantic versioning.
  """
)

フェーズ 5：リリースノート

Task(
  subagent_type="scribe",
  prompt="""
  Write release notes: [VERSION]

  Include:
  - Summary of changes
  - New features
  - Bug fixes
  - Breaking changes
  - Migration guide (if needed)
  - Contributors

  Output: RELEASE.md or update docs
  """
)

リリースの種類

メジャーリリース（破壊的変更）

/release --major
→ Full workflow with migration guide

マイナーリリース（新機能）

/release --minor
→ Full workflow, lighter security review

パッチリリース（バグ修正）

/release --patch
→ Security + tests + quick review

ホットフィックス

/release --hotfix
→ Expedited: aegis → atlas → herald

例

User: /release v2.0.0

Claude: Starting /release workflow for v2.0.0...

Phase 1: Security audit...
[Spawns aegis]
✅ No critical vulnerabilities
⚠️ 2 low-severity issues (documented)

Phase 2: E2E tests...
[Spawns atlas]
✅ 156/156 E2E tests passing

Phase 3: Final review...
[Spawns review-agent]
✅ RELEASE_APPROVED
- 47 commits since v1.9.0
- 3 new features
- 12 bug fixes
- No breaking changes

Phase 4: Version bump...
[Spawns herald]
✅ Version bumped to 2.0.0
✅ CHANGELOG.md updated
✅ Git tag created

Phase 5: Release notes...
[Spawns scribe]
✅ RELEASE-v2.0.0.md created

┌─────────────────────────────────────────┐
│ Release v2.0.0 Ready                    │
├─────────────────────────────────────────┤
│ Security: ✅ Passed                     │
│ Tests: ✅ 156/156                       │
│ Review: ✅ Approved                     │
│                                         │
│ Next steps:                             │
│ 1. git push origin v2.0.0              │
│ 2. Create GitHub release               │
│ 3. Deploy to production                │
└─────────────────────────────────────────┘

ブロッカー

次の場合、ワークフローは停止します：

• 重大なセキュリティ脆弱性が見つかった
• E2E テストが失敗した
• レビュー結果が RELEASE_BLOCKED である

Phase 1: Security audit...
❌ CRITICAL: SQL injection in user.py:45

Release blocked. Fix critical issues before proceeding.

フラグ

• --major/--minor/--patch：セマンティックバージョンの種類
• --hotfix：迅速なリリース手順
• --skip-security：セキュリティ監査をスキップします（推奨されません）
• --dry-run：バージョンを更新せずにチェックを実行します