consensus-persona-generator
consensus-persona-generator is the entrypoint for evaluator diversity in the Consensus.Tools ecosystem.
What this skill does
- creates N distinct decision personas (role, bias, risk posture, voting style)
- assigns initial reputation baselines for weighted arbitration (ongoing updates handled by consensus-persona-engine)
- persists a versioned
persona_set artifact to board state - reuses compatible persona sets when possible to reduce churn
Why this matters
Most agent pipelines fail because one model self-approves its own output. This skill injects structured disagreement first, so later guards operate over explicit multi-perspective review.
Ecosystem role
Stack position:
consensus-tools -> consensus-interact pattern -> consensus-persona-generator -> domain guards -> consensus-persona-engine
- consensus-tools: board/job/submission ledger substrate
- consensus-interact: board-native orchestration contract
- persona-generator: lightweight multi-agent initialization layer
- persona-engine: reputation update and persona lifecycle state transition layer
Inputs / outputs (automation-friendly)
- strict JSON input contract (
board_id, task_context, n_personas, etc.) - strict JSON output with
persona_set_id, personas[], and board write refs - deterministic/replayable behavior where feasible
Typical use cases
- bootstrap evaluators for email/publish/support/merge/action guards
- regenerate persona cohorts by domain or risk profile
- establish reusable governance personas for long-running automation
Runtime, credentials, and network behavior
- runtime binaries:
node, tsx - network calls: none in shipped generator 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 runtime dependency for this package- 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
npm i consensus-persona-generator
Quick start
node --import tsx run.js --input ./examples/persona-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
invoke() initializes or reuses persona sets and executes board operations via shared guard-core wrappers. It does not perform ongoing reputation mutation; that belongs to consensus-persona-engine.