rob
/
orchestrated-discussions
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Multi-agent AI discussion orchestration
1 Commit 1 Branch 0 Tags 987 KiB
Python 97.2%
Shell 1.6%
Dockerfile 1.2%
Go to file
rob 3b0c0339f7 Initial project structure for Orchestrated Discussions 
- Core modules: markers, voting, participant, discussion, runner, cli
- Bundled participants: architect, security, pragmatist, etc.
- Example discussion file demonstrating format
- Comprehensive design document
- Basic test suite for markers and voting

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 		2025-12-08 07:57:43 -04:00
config Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00
docs Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00
examples Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00
src/discussions Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00
tests Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00
.gitignore Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00
README.md Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00
pyproject.toml Initial project structure for Orchestrated Discussions 2025-12-08 07:57:43 -04:00

README.md

Orchestrated Discussions

Multi-agent AI discussion orchestration with voting and phases.

Conduct structured discussions between multiple AI personas, each with distinct perspectives, expertise, and voting behavior.

# Create a discussion
discussions new "Add user authentication" --template feature

# Run a turn with specific participants
discussions turn auth-discussion.md @architect @security @pragmatist

# Check status
discussions status auth-discussion.md
# Output: Phase: initial_feedback, Votes: READY: 1, CHANGES: 2

# Interactive mode
discussions ui auth-discussion.md

Installation

pip install orchestrated-discussions

# For TUI support
pip install orchestrated-discussions[tui]

Requirements

  • Python 3.10+
  • SmartTools (installed automatically)
  • At least one AI CLI tool (Claude, Codex, OpenCode, etc.)

Quick Start

# Create your first discussion
discussions new "My Feature" --template feature

# See bundled participants
discussions participants list

# Run a turn
discussions turn my-feature.md @architect @pragmatist

# Add your own comment
discussions comment my-feature.md "I think we should..." --vote READY

How It Works

  1. Discussions are markdown files with structured comments
  2. Participants are AI personas with distinct perspectives (architect, security, pragmatist, etc.)
  3. Phases guide the discussion through stages (feedback → review → vote)
  4. Votes (READY/CHANGES/REJECT) determine consensus
  5. Markers (Q:, TODO:, DECISION:) capture structured information

Documentation

Project Context

This is part of a three-project ecosystem:

  1. SmartTools - AI provider abstraction and tool execution
  2. Orchestrated Discussions (this project) - Multi-agent conversation orchestration
  3. CascadingDev - Git-driven automation (uses both above)

License

MIT