> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent-mintlify-f21cea86.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AI society simulations

> Have specialized agents collaborate, debate, and vote.

Run an inspectable multi-agent decision simulation:

```bash theme={null}
arka society "should we split this service?"
arka society "choose a caching strategy" --json
```

The default society includes architecture, implementation, risk, and user
advocacy roles. Each role proposes independently, the skeptic and architect
debate tradeoffs, and weighted votes produce a reversible decision. The
simulation is advisory and does not modify your repository.

Generate code from the voted decision with explicit opt-in:

```bash theme={null}
arka society "add a health endpoint" --generate
arka society "add a health endpoint" --generate --output src/health.py
```

Code is printed by default. `--output` creates a new file and refuses to
overwrite an existing one; review and test it before use.


## Related topics

- [AI agent guide — use Arka over MCP](/guides/ai-agents.md)
- [Arka — AI terminal agent documentation](/index.md)
- [Persona chat](/guides/personas.md)
- [AI teammate review](/guides/teammate-review.md)
- [Maximize free AI credits](/guides/free-credits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.