skill-system-coder-lifecycle

What this skill does

# Skill System Coder Lifecycle

Deprecated compatibility surface. `skill-system-comms` is now the merged owner of reviewer messaging plus session lifecycle management. This skill remains as a compatibility shim during the transition.

This skill owns the canonical opencode session convention for projects:

- `coder`
- `user`
- `auto`

It uses `opencode session list --format json -n 20` for discovery, supplements
that with SQLite reads from `opencode.db`, and never uses `opencode run --title`.

## Commands

```bash
python3 "{skill_dir}/scripts/coder_lifecycle.py" discover <project-dir>
python3 "{skill_dir}/scripts/coder_lifecycle.py" ensure <project-dir>
python3 "{skill_dir}/scripts/coder_lifecycle.py" cleanup <project-dir>
python3 "{skill_dir}/scripts/coder_lifecycle.py" restart <project-dir> <session-name>
python3 "{skill_dir}/scripts/coder_lifecycle.py" audit
```

## Rules

- Discovery is authoritative for command decisions.
- Cleanup only deletes non-canonical sessions.
- Ambiguous canonical matches fail closed.
- Known projects are configured in `config/coder-lifecycle.yaml`.

```skill-manifest
{
  "schema_version": "2.0",
  "id": "skill-system-coder-lifecycle",
  "version": "1.0.0",
  "capabilities": ["session-discover", "session-ensure", "session-cleanup", "session-restart", "session-audit"],
  "effects": ["fs.read", "db.read", "db.write", "proc.exec"],
  "operations": {
    "discover": {
      "description": "Discover canonical coder/user/auto sessions for one project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" }
      },
      "output": {
        "description": "Canonical session status plus extras",
        "fields": { "sessions": "array", "extras": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "discover", "{project_dir}"]
      }
    },
    "ensure": {
      "description": "Ensure canonical coder/user/auto sessions exist for one project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" }
      },
      "output": {
        "description": "Created sessions and final state",
        "fields": { "created": "array", "sessions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "ensure", "{project_dir}"]
      }
    },
    "cleanup": {
      "description": "Delete non-canonical sessions from one project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" }
      },
      "output": {
        "description": "Deleted extra sessions and final state",
        "fields": { "deleted": "array", "sessions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "cleanup", "{project_dir}"]
      }
    },
    "restart": {
      "description": "Restart one canonical session for a project.",
      "input": {
        "project_dir": { "type": "string", "required": true, "description": "Target project directory" },
        "session_name": { "type": "string", "required": true, "description": "Canonical session name" }
      },
      "output": {
        "description": "Restart result and final state",
        "fields": { "restarted": "boolean", "sessions": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "restart", "{project_dir}", "{session_name}"]
      }
    },
    "audit": {
      "description": "Audit all known projects for session health.",
      "input": {},
      "output": {
        "description": "Session health rows by project",
        "fields": { "rows": "array" }
      },
      "entrypoints": {
        "unix": ["python3", "{skill_dir}/scripts/coder_lifecycle.py", "audit"]
      }
    }
  },
  "stdout_contract": {
    "last_line_json": true
  }
}
```