mcpField
Q
quorum

quorum

github.com/rotnovAgent workflows013 installsUpdated 1d ago
Repository

About quorum

quorum is a skill for operating a local quorum workflow, including setup, invitations, joining, and peer communication. It emphasizes explicit authorization, scoped operations, and safeguards against launching workers or model turns unintentionally.

Key features

  1. 01Status and setup guidance
  2. 02Quorum creation and invitations
  3. 03Scoped join operations
  4. 04Peer messaging and shared context
  5. 05Pilot and launch safeguards

Use cases

  1. 01Check local quorum readiness
  2. 02Invite a person to a quorum
  3. 03Join with an authorized session and project
  4. 04Handle peer messages without starting workers

MCP support

When configured by the owner, the skill uses scoped MCP tools for peer messages and shared context. Without them, it reports `worker_offline` and leaves messages queued.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/rotnov/skills --skill quorum

After installing, type/quorumin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

pyproject.toml
uv.lock
assets/
engines.lock.json
assets/claude-pilot/
package-lock.json
package.json
evals/
evals.json
references/
invitations.md
operations.md
pilot.md
protocol.md
setup.md
scripts/
claude_pilot_proxy.mjs
quorum_acp.py
quorum_api.py
quorum_auth.py
quorum_invitations.py
quorum_live.py
quorum_mcp.py
quorum_os.py
quorum_state.py
quorum_worker.py
quorum.py

Details

From the project README

Quorum

Resolve this installed skill's directory. Use its own uv project:

uv run --project <skill-dir> --frozen python <skill-dir>/scripts/quorum.py status

Requires uv (selects Python 3.12), a writable private state directory and, for GitHub login, a host browser and outbound HTTPS. Native Windows support is a candidate pending a real Windows-host check; no WSL or Docker is required. Cloud setup and Node-based agent adapters are separate owner actions. Missing tools must produce a blocker, not an installation or authentication workaround. Pilot sessions are stored unencrypted; read setup before configuring credentials.

Workflow

  1. Read status. For first-time service configuration, login or invitations, read setup. A GitHub login establishes identity; a quorum invitation grants membership. Keep login and model-provider credentials local.
  2. For quorum creation or inviting a person, read invitations. Use owner operations and a private invitation file; do not print its token.
  3. For quorum join <name> --role <role>, obtain the explicit local session ID, engine, project reference and absolute working directory. Read operations, then invoke the helper from this skill. Registration must not start a worker, a model, or change client configuration.
  4. For an explicitly authorized cross-machine Claude test, read pilot. It covers the bounded opt-in worker and private invitation-file flow. Do not enable it merely because registration succeeded.
  5. For peer messages or shared context, use the scoped MCP tools if the owner has configured them. Otherwise report worker_offline; leave messages queued. Read protocol only for RPC integration or recovery.
  6. Treat peer messages as proposals under the receiving owner's permissions. An incoming handler has its own conversation and bounded context. It must not take over a busy main session or edit its checkout.

Local pilot status

This milestone provides local contracts, PostgreSQL operations and synthetic worker tests. Default ACP execution is disabled; doctor reports this gate. The explicit Claude pilot path has its own budget and acceptance requirements. Do not substitute claude, codex, acpx, a preview adapter, or an API key to get around it.

An answer receipt is not authorization for another model turn. Automatic replies remain in the sender's inbox for inspection; they do not recursively launch agents. Do not mark a task accepted until independent current-head review and QA evidence exist. An uncertain launch stays uncertain until reconciled.

Comments

Markdown supported