Squad & Shared Memory
Run a Debate Between Agents
By TermSquad · Last reviewed
A Squad debate asks two equal peers to analyze a decision and challenge each other’s reasoning. It is useful when there are meaningful tradeoffs, such as choosing a migration strategy.
Debate is analysis-only. It does not authorize the peers to edit project files or implement a proposal.
Prepare a useful topic
Include the question, constraints, available evidence, and what would make an approach acceptable. Configure Peer A and Peer B under Settings → Squad → Debate.
For example:
Debate whether this project’s background jobs should stay in the existing process or move to a separate worker. Compare failure recovery, deployment effort, and the current traffic level. Do not modify files.
Start a debate from the terminal
Inside your Herdr project session:
squad debate "Compare the two background-job designs using the repository's current constraints." --rounds 3The command uses the configured peers when no explicit agent override is supplied. Supported round counts are 1 through 8.
Interpret the result
The peers first form independent positions, then examine the opposing reasoning. Agreement requires an explicit proposal and acceptance. A result with no consensus can still be useful: read the unresolved tradeoffs rather than treating disagreement as failure.
The transcript and result are stored under ~/.termsquad/squad/debates/. They are not automatically copied into shared memory. Save an accepted durable decision explicitly after evaluating it.
Use squad debate resume DEBATE_ID for a supported interrupted debate. See Squad command reference and project knowledge.