Custom Boards

Board composition

The default board has six members: Revenue, Product Strategist, Technical Architect, Contrarian, Compounder, and Moonshot. You can modify this composition by editing ceo-and-board-configuration.yaml.

Adding a member

To add a new board member:

  1. Create a persona file in .pi/ceo-agents/agents/{member-name}.md
  2. Add the member to board_members in the configuration

Persona file format

Each persona file defines the member’s optimization lens:

# {Role Name}

## Primary focus
What this member optimizes for.

## Directive
Specific instructions for how this member should analyze briefs.

## What to challenge
When to push back and what patterns to flag.

## Output expectations
How the member should structure their response.

Configuration entry

board_members:
  - name: risk-officer
    persona: agents/risk-officer.md
    color: "#e06c75"

Removing a member

Remove the member’s entry from board_members in the configuration. The persona file can remain for future use.

Modifying a member

Edit the persona file directly. Changes take effect on the next deliberation - there is no caching of persona content.

Role design guidelines

Effective board members have:

  • A clear optimization lens - one primary dimension they care about
  • A specific directive - what they should do, not just what they know
  • A contrasting perspective - value comes from disagreement, not agreement
  • Appropriate scope - narrow enough to be useful, broad enough to contribute

Avoid creating members that overlap heavily with existing roles. The board’s value comes from diverse perspectives, not redundant agreement.

Color selection

Colors are used in the terminal UI and artifact display. Choose colors that are:

  • Visually distinct from existing members
  • Readable on dark backgrounds
  • In the synthwave palette aesthetic (saturated, not pastel)

The default palette uses: pink, yellow, coral, orange, teal, and blue.

Naming

Member names should be:

  • Lowercase with hyphens (risk-officer, not RiskOfficer)
  • Descriptive of the role, not the person
  • Unique within the board