AGENTS.ctx: Pi Council

Level 2 (Topic) — Multi-actor deliberation system roles, rounds, orchestration.

Concept

Pi Council is a multi-actor deliberation system where multiple AI agents play different roles to tackle complex tasks. It is orchestrated by council.sh and follows a structured round model.

Roles

RoleFunction
FocalizzatoreDefines the task, scopes the problem, selects experts, merges results
Esperti (Experts)Parallel agents working on subtasks independently
Giudice (Judge)Evaluates expert outputs against criteria
Pianificatore (Planner)Produces the final execution plan from accepted outputs

Rounds

The council executes in rounds:

  1. Preparation: Focalizzatore defines scope and selects experts
  2. Parallel execution: Experts work independently (merged after barrier)
  3. Evaluation: Giudice reviews outputs
  4. Planning: Pianificatore produces final plan
  5. Repeat if needed

Key Design Decisions

  • Experts run in parallel (not sequential) for efficiency
  • Barrier + merge pattern ensures all experts contribute before evaluation
  • The system is implemented in Python for reliable parallel orchestration
  • Each expert gets a focused sub-prompt rather than the full task

See Also