athenaeum-ratify

name

athenaeum-ratify

description

Streamlined single-pack fleet attestation — formal sign-off on an immutable artifact with dissent recorded, not overruled, via the consolidated athenaeum path. Use to chain ratification onto a converged athenaeum result, or when an ADR/convention needs N-agent attestation and you want the athenaeum protocol. Triggers — "athenaeum ratify", "ratify via athenaeum", "athenaeum attestation". If the grill-each-other pack is installed and you want the modular primitive instead, use fleet-ratify (artifact sign-off) or permutation (NxN topology).

Athenaeum — Ratify

Decision rule: unanimous-or-decompose

• All SIGN → ratified.
• Any DISSENT or ABSTAIN_BY_TIMEOUT → decomposed. The merge writer aggregates dissent atom-refs and hands them to the human grain-gate. No auto-recursion. No quorum voting.
• mode: fast (low-stakes) → any dissent is a plain rejection.

3-step workflow

1. Init — scripts/athenaeum init <topic> --mode ratify --roster a,b,c

   • Freezes artifact verbatim to artifact.md. Computes SHA-256. Never edit after init.
   • Writes manifest.yaml with roster and expires_at (+72h).
   • See templates/ratify/manifest.yaml.template.

2. Vote — each rostered agent reads artifact.md, verifies SHA-256, writes <agent>.vote.yaml:

   • SIGN — attests the exact bytes.
   • DISSENT — proposes atom-refs for decomposition.
   • Agents do not read peers' votes first.
   • See templates/ratify/vote.yaml.template.

3. Tally — merge writer (first alphabetically among voters) runs:

   • All sign → write ratified.md, log RATIFIED.
   • Any dissent/abstain → write decomposition.md, set status: pending-human, ping the human.
   • Human fills human-decision.yaml: accept-split · decompose-further · rewrite-with-caveats · reject.
   • Merge writer detects the decision and converges.

Discovery

• scripts/athenaeum check — glob open ratifications where this agent is rostered and has not voted.
• n8n can alert the roster, but check is the floor — it works even if notifications fail.

A2A interop

This skill speaks A2A natively. An A2A Task represents this workflow.

Task metadata:

• athenaeum_mode: ratify
• status lifecycle: submitted → working → input-required → completed

Artifacts produced:

• artifact.md — text/markdown
• manifest.yaml — application/yaml
• ratified.md — text/markdown
• ratified-artifact.excalidraw — Visual JSON for deep-review and presentation
• ratified-artifact.svg — Scalable vector graphic for dashboards

Enable A2A for this workflow:

athenaeum init my-topic --mode ratify --transport a2a

Invoking via A2A:

{
  "jsonrpc": "2.0",
  "method": "tasks/send",
  "params": {
    "task": {
      "id": "athenaeum-ratify-my-topic",
      "sessionId": "<agent-session>",
      "status": "submitted",
      "metadata": {"athenaeum_mode": "ratify", "topic": "my-topic"}
    }
  }
}

Sibling skills

• athenaeum-design — design the artifact before ratifying it
• athenaeum-reconcile — reconcile state before ratifying it

Full protocol (caveat rules, grain-gate semantics, terminal events): see REFERENCE.md §7–9.