プロセスライフサイクル管理

概要

Node.jsプロセスのライフサイクル管理を専門とするスキル。Linuxカーネルのプロセス管理思想に基づき、プロセスの生成、実行、監視、終了までの完全な制御と、シグナル処理、ゾンビプロセス回避を設計します。

ワークフロー

Phase 1: ライフサイクル分析

目的: プロセスの要件と状態遷移を分析

アクション:

1. アプリケーションの起動・終了要件を特定
2. 管理対象プロセス（親・子）を洗い出し
3. 必要なシグナル処理を決定
4. 状態遷移図を設計

Task: agents/analyze-lifecycle.md を参照

Phase 2: シグナルハンドラ実装

目的: Graceful Shutdownとシグナル処理を実装

アクション:

1. assets/signal-handler.template.ts を基にハンドラーを実装
2. SIGTERM、SIGINT、SIGHUPの処理を定義
3. クリーンアップ関数を登録
4. タイムアウト処理を設定

Task: agents/implement-handlers.md を参照

Phase 3: シャットダウン検証

目的: 実装したシグナルハンドラの動作を検証

アクション:

1. scripts/check-process-health.mjs で動作確認
2. シグナル送信テストを実施
3. リソースリークを検証
4. PM2との連携を確認

Task: agents/validate-shutdown.md を参照

Task仕様ナビ

ベストプラクティス

すべきこと

• Node.jsプロセスの起動・終了フローを設計する時
• シグナルハンドラーを実装する時
• 子プロセスの管理戦略を決定する時
• PM2でプロセスを管理する設定を行う時
• Graceful Shutdownの実装時にタイムアウトを設定する
• クリーンアップ関数を逆順（後入れ先出し）で実行する

避けるべきこと

• アンチパターンや注意点を確認せずに進めることを避ける
• graceful shutdownの実装なしに本番環境へ展開することを避ける
• シグナルハンドラーなしのプロセス管理を避ける
• 子プロセスの終了確認なしの設計を避ける
• SIGKILLへのハンドラー登録（不可能）を試みることを避ける

リソース参照

references/

scripts/

assets/

変更履歴