roundtable

name	roundtable
description	Convene the multi-LLM round table — Claude, Antigravity, and Codex deliberate a question; the user chairs promotion. Triggers on: roundtable, round table, convene the table, ask the table, what do the other models think, deliberate.

Round Table

IMPORTANT: Start your response by telling the user:

Round table — Convening the fixed roster (Claude, Antigravity, Codex). You chair; I moderate. Up to 3 rounds.

What It Does

A moderated deliberation (Phase 1 of docs/specs/agent-round-table): the user poses a question, each roster member answers headlessly and independently, the moderator (this session) posts every message to the Redis board, synthesizes, and presents the result. Only the chair — the user — promotes anything into a tracked artifact.

Invariants (ratified — do not improvise around them):

• R1 Members are text-in/text-out. They never touch Redis, files, or shell. All board I/O goes through the moderator via the Board client (attune.roundtable).
• R3 Board state lives only under attune:roundtable:* (TTL 7 days). Never write attune:memory:*.
• R4 Nothing reaches a tracked file without explicit per-item chair approval. No auto-promotion, ever.
• D3 Hard ceiling: 3 rounds per question. Halt early when positions converge or a round adds no information.

Step 0 — Intake and the spend gate

Confirm the question with the user (one short exchange if it is ambiguous; skip if crisp). Derive a thread slug (kebab-case, e.g. q-cache-invalidation-002). Then state the plan — roster, expected rounds (usually 1) — and get an explicit go before invoking any member. That go is session-durable.

If Redis is unreachable (Board() raises on first call): tell the chair. Offer to deliberate unrecorded (transcript stays in-session; promotion still writes artifacts) or abort. Never block silently.

Step 1 — Open the thread

Write the question to a scratch file, then post it:

T="<slug>" A="chair" K="question" F="/tmp/rt-q.txt" python -c "import os; from attune.roundtable import Board; b=Board(); b.ensure_functions(); print(b.post_message(os.environ['T'], os.environ['A'], os.environ['K'], open(os.environ['F']).read()))"

Step 2 — Brief the members (round 1)

Write one brief per member to a scratch file. Brief template:

You are one seat at a three-model round table (Claude, Antigravity,
Codex). Answer independently; you cannot see the other seats this
round. Reply with: (1) your POSITION on the question, concretely;
(2) the main RISK of your own position; (3) optionally ONE follow-up
question for the table. Text only — do not run tools, write files,
or take actions. Question:

<question text, plus any round-N context — see Step 4>

Invoke all three (verified recipes; run the two CLIs in parallel Bash calls, each with a timeout of ~180s):

• Claude seat — Agent tool, general-purpose, context-free: pass the brief verbatim as the prompt; its final text is the reply.
• Antigravity — reasoning-only plan mode (shell is auto-denied headlessly, which is what R1 wants):

agy --add-dir "$PWD" -p "$(cat /tmp/rt-brief.txt)" --mode plan

• Codex — brief on stdin (the arg-prompt form blocks forever on non-TTY stdin):

codex exec --skip-git-repo-check - < /tmp/rt-brief.txt

Step 3 — Post positions with receipts

For each member, write its reply to a scratch file and post it as a position authored by the provider, carrying the R7 receipt fields (and round):

T="<slug>" A="codex" F="/tmp/rt-codex.txt" DUR="41s" python -c "import os; from attune.roundtable import Board; b=Board(); print(b.post_message(os.environ['T'], os.environ['A'], 'position', open(os.environ['F']).read(), round=1, duration=os.environ['DUR']))"

Add token/cost figures as extra kwargs when the CLI reported them.

Absent seat (R6): a member whose CLI is missing, unauthenticated, or times out never blocks the table. Post kind='position', body ABSENT — <reason>, extra absent=True, and proceed. The table degrades to however many seats answered.

Member-originated items (R9): if a reply contains a follow-up question or an unprompted suggestion, post it as its own message (kind='question' or 'suggestion', author = that provider, reply_to = the position's id). Origination grants no execution rights — triage it to the chair in Step 5.

Step 4 — Further rounds (bounded)

Run another round only if member follow-up questions (R9) need answers or positions genuinely diverge on a decidable point. The round-N brief appends the prior round's positions (as plain text, attributed by seat) and the open follow-ups. Repeat Steps 2–3 with round=N.

Halt early on convergence. At the ceiling (3 rounds) or any budget the chair set, stop and post the halt (R5):

T="<slug>" python -c "import os; from attune.roundtable import Board; Board().post_message(os.environ['T'], 'moderator', 'halt', 'round ceiling (3) reached')"

Step 5 — Synthesize and present

Post one synthesis message (author moderator): where seats agree, where they split and why, and the moderator's read. Then present to the chair: a compact per-seat position table, the synthesis, member-originated items needing triage, and promotion candidates. Read the thread back any time with:

T="<slug>" python -c "import os, json; from attune.roundtable import Board; print(json.dumps([vars(m) for m in Board().read_thread(os.environ['T'])], ensure_ascii=False, default=str))"

Step 6 — Chair rules; promote per item (R4, R10, D2)

Present the promotion candidates as discrete items — each with its board message id — and ask the chair per item: promote, decline, or another round. Use AskUserQuestion with multiSelect (or an elicitation form) — never assume. On promotion:

1. Recommend an artifact tier per the contract's artifact-selection table — inline edit / structured one-shot / XML task / spec — sized to what the table produced. The chair ratifies the tier.
2. Destination (D2, local-first per docs/specs/local-first-reports/): the FULL transcript report always goes machine-local to ~/.attune/reports/roundtable/<slug>.md — it is the moderator's development data and is never tracked. Promoted content goes to the owning spec's decisions.md when a spec exists; else a CURATED STUB at docs/reports/roundtable/<slug>.md carrying only the chair-promoted sections plus a pointer to the local transcript. The artifact records the thread id it came from.
3. Write the artifact, then mark the thread, passing the chair-approved message ids so the board records exactly what was promoted (an unknown id rejects the whole call, no meta change):

T="<slug>" D="$HOME/.attune/reports/roundtable/<slug>.md" IDS="2,4" python -c "import os; from attune.roundtable import Board; Board().promote(os.environ['T'], os.environ['D'], item_ids=[int(i) for i in os.environ['IDS'].split(',')])"

Post the chair's decision as a ruling message (author chair). Declined items get no file writes — git status stays clean.

The steelman round (chair-leans variant)

When the chair's lean conflicts with a round's consensus — especially a unanimous one — do not force a bare overrule-vs-capitulate choice. Offer the chair a bounded STEELMAN round (it counts against the D3 ceiling):

• Brief every seat with: the chair's stance, a faithful summary of the prior round's positions, and any NEW facts the moderator can inject (settled rulings are stated as binding — seats must not re-litigate them).
• Each seat must either DESIGN the strongest version of the chair-leaned position — concrete, not conciliatory — or state exactly "NO -SHAPED DESIGN EXISTS" plus one sentence why. Both are honest completions; a seat holding its ground is not a failure.
• The post-steelman consensus is decisive under a chair rule of the form "my lean stands unless the table is against it": if the consensus dissolves, the chair rules among REAL alternatives; if it holds unanimously, the chair has a fair-hearing record for either accepting it or overruling with eyes open.

Worked example: thread q-ops-memory-multi-llm-pages-001 (2026-07-22, report in docs/reports/roundtable/) — a unanimous 3/3 "close the memory page" dissolved to 2/3 keep-with-redesign, with two seats independently converging on the same exceptions-first design that shipped; the third seat's held objection ("no page-shaped design exists") was preserved in the ruling as the demote clause. The steelman produced a better outcome than either the consensus or the overrule would have.

The lesson lane (chair rulings, thread lessons-flow-001)

When — and only when — a deliberation yields reusable cross-session knowledge (a verified gotcha, a rationale that will be asked again), draft a lesson candidate. Default is NO candidate; most threads produce none. Before presenting it to the chair, lint it — the gate is mechanical: no receipt AND no chair waiver → blocked:

TI="<title>" B="<body>" E="<evidence or empty>" T="<slug>" python -c "import os; from attune.roundtable import LessonCandidate; c=LessonCandidate(title=os.environ['TI'], body=os.environ['B'], evidence=os.environ['E'], thread=os.environ['T']); print(c.lint() or c.render())"

• evidence is a receipt from the real system (command run, failure observed, fixing diff) — transcript consensus never qualifies.
• The chair may waive the receipt for a strong design rationale (waived=True): the rendered entry then carries the visible unverified — design rationale (chair-waived) tag and upgrades to a normal entry when evidence lands. The waiver is the chair's, per item — never self-granted.
• Approved entries append to .claude/lessons.md (or the owning spec's decisions.md); Redis re-derives at next hydration. The table never touches the lessons corpus directly.

Deliberation is TTL'd; only promoted content is durable. If the chair wants a raw thread kept past 7 days, promotion to a machine-local report (~/.attune/reports/roundtable/) is the mechanism — say so rather than extending TTLs ad hoc.

Spec-authoring loops (V2-P1/P2)

For a spec-authoring deliberation (drafter + critics per the producing-team spec), run every round output through the compiler lints BEFORE posting it to the board — the TR-4 mechanical gate:

F="/tmp/rt-round.md" K="draft" python -c "import os; from attune.roundtable import compiler; f=open(os.environ['F']).read(); print(getattr(compiler, 'lint_' + os.environ['K'])(f) or 'clean')"

K is draft (round 1: REQ-ID items + acceptance bullets), critique (round 2: targeted, cited items + VERDICT line), or final (round 3: every item tagged, dissent register present or attested). A lint-dirty output goes back to its seat, not to the board. Use role-aware budgets (compiler.ROLE_REPLY_CHARS) when invoking seats — drafter documents need more room than positions. After the chair rules per item, assemble the tracked file deterministically with compiler.parse_draft + compiler.link_critiques + compiler.compile_requirements (approved items only; declined/unruled ids recorded in the header; thread id in provenance).

Solution generation (V2-P3)

When the chair approves implementation of spec items, run the solution loop — members propose code as TEXT (R1 holds), the moderator is the only materializer:

1. Packet: brief each proposing seat with the approved item ids, exact scope, relevant source excerpts, and required checks. Proposals come back as full-file blocks (--- file: <path> + fenced content) or a unified diff.
2. Materialize in an ISOLATED scratch worktree — never a tracked branch (attune.roundtable.solutions.materialize; invalid/traversal paths raise, a non-applying diff fails clean).
3. Validate with the named checks, serially (solutions.validate) — every check yields an exact-tail receipt; zero receipts is NOT green.
4. One repair round (counts against D3): a failing candidate's receipts go back to its author seat once.
5. Cross-seat review: a DIFFERENT seat than the author reviews solutions.diff_against_base output + the receipts and issues a verdict.
6. Chair: present diff + receipts + reviewer verdict + tier. Approval → the moderator applies to a real branch and ships per repo discipline; rejection or a still-failing candidate → solutions.discard (TAC-4: failures are presented failed-with-receipts or withheld — never laundered green).

Routines (P3 — headless table runs)

A routine convenes the table on a recurring question with the same gates (R5 cap, R6 absent seats) and one extra: a routine NEVER promotes (R8) — its digest thread waits on the board for the chair. Manual-first is ratified: run it by hand, arm a schedule only after the chair reviews a proven run.

python -m attune.roundtable.routine clean-run            # real run
python -m attune.roundtable.routine clean-run --dry-run  # checks + brief only, no board/LLM

Routine #1 is clean-run (the weekly health check): keyless check battery (collaboration preflight + unit suite) → seats deliberate the results → one synthesis pass → digest thread routine-clean-run-<date>. Review it with /roundtable read <thread>; promote per-item via Step 6.

Producing runs (V2-P4 — headless spec-authoring routines)

A producing run executes the full spec-authoring loop headlessly (attune.roundtable.producing): draft → critique → final, every round gated by the compiler lints before posting, then an UNRULED candidate compilation staged on thread producing-<slug>-<slot> — at most 7 promotable candidates (TR-6, chair-ruled), overflow held as deferred_over_cap, R8 absolute (the run never promotes).

python -m attune.roundtable.producing <slug> "<subject>" <pack.md> --slot <slot>

• Per-spec arming (chair-ruled): the chair queues a grounding pack per subject; there is no standing spec cadence.
• Rotation is computed from the owning spec's decisions.md (attune.roundtable.rotation.rotation_status): fixed roles until an explicit P4-ROTATION: armed chair line exists; the drafter pointer (next_owed) advances only on served drafts, over the rotation ledger (TTL-exempt, Board.ledger_read).
• Failure honesty: a closed 12-code taxonomy (producing.FAILURE_CODES); every degradation is receipted in the digest, failures and dissent BEFORE candidates; BOARD_UNREACHABLE receipts land in the launchd log (the one class that cannot reach the board). R5 cap: max_invocations=10 (chair-ratified).
• Review a run with /roundtable read producing-<slug>-<slot>; the chair rules per item and the moderator recompiles with the rulings (compiler.compile_requirements) — Step 6 unchanged.

Arguments

• /roundtable <question> — full deliberation (Steps 0–6).
• /roundtable read <thread> — read and render an existing thread (Step 5's read snippet); no member invocations.
• /roundtable promote <thread> — jump to Step 6 for a thread that already deliberated.
• /roundtable routine <name> — run a registered routine (above) and present its digest to the chair.