aops-cli-discuss

Runs standalone server-canonical AI discussion topics with a two-agent decision ritual via aops-cli.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/eeemzs/aops --skill aops-cli-discuss-eeemzs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aops-cli-discuss
Source: https://github.com/eeemzs/aops/tree/main/assets/skills/aops-cli-discuss
Command: npx skills add https://github.com/eeemzs/aops --skill aops-cli-discuss-eeemzs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating a structured design decision between two AI agents is error-prone: agents skip independent research, conclude before all final stances exist, infer completion from prose, or treat chat as the decision record. This Skill enforces a deterministic, server-canonical discussion protocol with aops-cli so consensus is reached, recorded, and concluded correctly. ## Core Features & Use Cases - Standalone discussion lifecycle: Start, fork, follow up, list, and read discussion topics with slug-first selectors and JSON-driven status reads. - Mandatory design-decision ritual: Enforces independent research, at least four substantive turns, per-participant final-stance turns, and conclude outputs (consensus, disagreement, open questions) with no TBD placeholders. - Two-agent automation protocol: Loop on discuss wait with structured exit codes (0 write, 20 operator block, 21 ready to conclude, 22 timeout) and an --expect-next race guard. - Use Case: An operator asks two agents to decide between SQLite and PostgreSQL; the Skill drives topic creation, turn-taking, final stances, conclude, and explicit linking of the decision to PM records or a chat room. ## Quick Start Ask your agent to start an aops-cli discuss topic with two named participants on your design question, run the decision ritual, and conclude once both final stances exist.

Frequently Asked Questions about aops-cli-discuss

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a two-agent design discussion with aops-cli?▼

Start a topic with `aops-cli discuss start` naming at least two operator-assigned agents, then alternate substantive turns using `discuss turn` and `discuss wait`. After at least four non-final turns, each agent files a kind=final-stance turn, and you run `discuss conclude` to scaffold the consensus outputs.

What is the difference between aops-cli discuss, chat, and pm?▼

discuss is the decision and consensus surface for standalone topics, chat handles coordination and wake in hosted rooms, and pm tracks review requests, issues, and execution truth. A concluded decision does not propagate automatically; you must explicitly link it to PM records or bind it into a chat room.

Why is aops-cli discuss conclude blocked?▼

Conclude is blocked while an operator-addressed open question remains or while any participant is missing a kind=final-stance turn. Check `discuss status --json` for lifecycleState and missingTurnFinalStances rather than inferring readiness from turn prose.

What do aops-cli discuss wait exit codes mean?▼

Exit 0 means the requested agent may write the next turn, 20 means blocked by an operator question so you must stop and return to the operator, 21 means ready to conclude or already concluded, and 22 means a timeout with no change so you re-poll.

Can I edit discussion files directly in the .aops-cache directory?▼

No. The `.aops-cache/agentspace/discussions/**` directory is a read-only local mirror of server state refreshed by `sync pull`. All authoring must go through the hosted aops-cli discuss commands, never by hand-editing cache files.