Getting Started

What is Boardroom?

Boardroom is an opinionated Pi workflow pack for executive deliberation. It assembles a board of six specialist agents - Revenue, Product Strategist, Technical Architect, Contrarian, Compounder, and Moonshot - each optimizing for a different dimension of the decision.

The CEO agent synthesizes their positions into a final decision memo with ranked recommendations, tradeoffs, conditions, and next moves.

Prerequisites

  • Pi installed and configured
  • A model provider configured (Anthropic recommended)
  • Node.js 20+

Where it runs

Boardroom runs as a Pi extension. It is not a standalone application and it is not the substrate. In the layered stack, Pi is the runtime foundation and Boardroom is a reusable workflow that loads into it. The packaged install is published on npm as @justynclark/boardroom. When loaded, it registers two kickoff surfaces plus the converse and end_deliberation tools in your Pi session:

  • /ceo-begin
  • ceo-begin <brief-id>

All artifacts are stored locally in your repository under the .pi/ceo-agents/ directory. Nothing is sent to external services beyond the model API calls.

License

The source repository is published under Apache-2.0. That means Boardroom is open source, commercially usable, and includes an explicit patent grant for adopters.

Quick overview

  1. Write a structured brief with situation, stakes, constraints, and a key question
  2. Start the run with either /ceo-begin or ceo-begin <brief-id>
  3. The CEO converses with board members across one or more rounds
  4. Board members submit final positions and votes
  5. The CEO writes a decision memo
  6. All artifacts are persisted to disk

The deterministic text trigger exists on purpose. Boardroom is designed to be operable by humans in the Pi UI and by agents that need a stable, text-first way to start a run.

Typical cost: $0.15–$0.30 per deliberation. Typical duration: 1–5 minutes.

Next steps