# Cfn Process Management

> Process instrumentation and lifecycle management. Use when starting/stopping/tracking OS processes, instrumenting process metrics, or managing process lifecycle for CFN.

- Skill: `masharratt/cfn-process-management` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add masharratt/cfn-process-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/masharratt/cfn-process-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: masharratt (https://skillmd.com/u/masharratt)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/masharratt/cfn-process-management

---


# Process Management Skill (Mega-Skill)

**Version:** 1.0.0
**Purpose:** Process instrumentation and lifecycle management
**Status:** Production
**Consolidates:** cfn-process-instrumentation, cfn-process-lifecycle

---

## Overview

This mega-skill provides process management:
- **Instrumentation** - Process metrics and monitoring
- **Lifecycle** - Process start/stop/restart management

> **Orphan reaper (complements this skill's internal cleanup):** `.claude/hooks/reap-orphan-test-workers.sh` reaps leaked test workers (reparented to PID 1) and stuck CodeSearch indexers out-of-band. It is a safety net for processes this skill's lifecycle management did not stop, not a replacement for it.

---

## Directory Structure

```
process-management/
├── SKILL.md
├── lib/
│   ├── instrumentation/  # From cfn-process-instrumentation
│   └── lifecycle/        # From cfn-process-lifecycle
└── cli/
```

---

## Migration Paths

| Old Path | New Path |
|----------|----------|
| cfn-process-instrumentation/ | process-management/lib/instrumentation/ |
| cfn-process-lifecycle/ | process-management/lib/lifecycle/ |

---

## Version History

### 1.0.0 (2025-12-02)
- Consolidated 2 process skills into mega-skill

---

## Quick Start

Start process instrumentation for an agent:
```bash
bash $HOME/.claude/skills/cfn-process-management/lib/instrumentation/instrument.sh --agent-id <agent-id> --metrics cpu,memory
```

Manage process lifecycle (start, stop, restart):
```bash
bash $HOME/.claude/skills/cfn-process-management/lib/lifecycle/manage.sh --action start --process <process-name>
bash $HOME/.claude/skills/cfn-process-management/lib/lifecycle/manage.sh --action stop --process <process-name>
```

Check process health and metrics:
```bash
bash $HOME/.claude/skills/cfn-process-management/lib/instrumentation/instrument.sh --agent-id <agent-id> --report
```