consensus-persona-respawn

SKILL.md

---
name: consensus-persona-respawn
description: Ledger-informed persona lifecycle management. Replaces low-performing personas with successor personas derived from mistake patterns in board decision history, preserving adaptive governance over long-running automation. Reputation updates are computed by consensus-persona-engine.
version: 1.1.13
homepage: https://github.com/kaicianflone/consensus-persona-respawn
source: https://github.com/kaicianflone/consensus-persona-respawn
upstream:
  consensus-guard-core: https://github.com/kaicianflone/consensus-guard-core
requires:
  bins:
    - node
    - tsx
  env:
    - CONSENSUS_STATE_FILE
    - CONSENSUS_STATE_ROOT
metadata:
  openclaw:
    requires:
      bins:
        - node
        - tsx
      env:
        - CONSENSUS_STATE_FILE
        - CONSENSUS_STATE_ROOT
    install:
      - kind: node
        package: consensus-persona-respawn
---

# consensus-persona-respawn

`consensus-persona-respawn` is the adaptive maintenance loop for persona governance.

## What this skill does

- identifies dead/weak personas by trigger or reputation threshold
- mines historical decision artifacts for mistake patterns
- generates successor persona profiles informed by those failures
- writes `persona_respawn` and updated `persona_set` artifacts
- keeps governance panel quality from stagnating

## Why this matters

A static evaluator panel drifts over time. This skill provides lifecycle renewal so consensus quality improves instead of degrading.

## Ecosystem role

Consumes persona-engine outputs for long-term adaptation and ties directly into board-ledger evidence.

## Best use cases

- long-running agent teams
- recurring decision domains with repeated failure classes
- autonomous systems requiring evaluator maintenance


## Runtime and network behavior

- runtime binaries: `node`, `tsx`
- network calls: none in shipped respawn logic
- environment config read by this package: `CONSENSUS_STATE_FILE`, `CONSENSUS_STATE_ROOT`
- filesystem writes: board/state artifacts under the configured consensus state path

## Dependency trust model

- `consensus-guard-core` is the first-party consensus package used in runtime execution
- versions are semver-pinned in `package.json` for reproducible installs
- this skill does not request host-wide privileges and does not mutate other skills

## Install

```bash
npm i consensus-persona-respawn
```

## Quick start

```bash
node --import tsx run.js --input ./examples/input.json
```

## Tool-call integration

This skill is wired to the consensus-interact contract boundary (via shared consensus-guard-core wrappers where applicable):
- readBoardPolicy
- getLatestPersonaSet / getPersonaSet
- writeArtifact / writeDecision
- idempotent decision lookup

This keeps board orchestration standardized across skills.

## Invoke Contract

This skill exposes a canonical entrypoint:

- `invoke(input, opts?) -> Promise<OutputJson | ErrorJson>`

`invoke()` executes persona replacement based on lineage and failure patterns. Reputation deltas are expected from consensus-persona-engine outputs.