assignment.yaml

File location: ~/.disclaw-team/assignment.yaml

Purpose: Maps bots to roles, stores Discord server info, defines human team members, and optionally overrides protocol behavior. This is the primary configuration file in the new format.

Minimal valid example:

discord:
  guild_id: "123456789012345678"
  channel_id: "987654321098765432"

assignments:
  bot-1: orchestrator
  bot-2: researcher

Full example:

discord:
  guild_id: "123456789012345678"
  channel_id: "987654321098765432"

workspace: /Users/you/projects/my-workspace
model: opus

assignments:
  bot-1: tech-lead
  bot-2: researcher
  bot-3: validator

humans:
  owner:
    name: Jane Doe
    discord_id: "555666777888999000"
    role: owner

overrides:
  protocol:
    communication:
      selective_replies: true
      react_before_responding: true
      default_reaction: "👀"
      completion_reaction: "✅"
    validation:
      require_validation: true
      never_skip_for:
        - security changes
        - database migrations
    escalation:
      human_approval_required:
        - deploy to production
        - access customer data

Field reference:

Field	Type	Required	Default	Description
`discord.guild_id`	string	Yes	—	Discord server (guild) ID
`discord.channel_id`	string	Yes	—	General channel ID for bot communication
`workspace`	string	No	cwd	Working directory for bots
`model`	string	No	`opus`	Default model: `opus`, `sonnet`, `haiku`
`assignments`	object	Yes	—	Maps bot IDs to role filenames (without `.yaml`)
`humans`	object	No	—	Human team members
`humans.<id>.name`	string	Yes	—	Human display name
`humans.<id>.discord_id`	string	Yes	—	Human Discord user ID
`humans.<id>.role`	string	No	`owner`	Human’s role
`overrides.protocol`	object	No	—	Persistent protocol customizations

Protocol overrides sub-fields:

Field	Type	Description
`communication.selective_replies`	bool	Only reply when @mentioned
`communication.acknowledge_teammates`	bool	Send a brief acknowledgement when a teammate delivers work
`communication.react_before_responding`	bool	React to messages before replying
`communication.default_reaction`	string	Emoji for “working on it”
`communication.completion_reaction`	string	Emoji for “done”
`validation.require_validation`	bool	Require teammate sign-off before shipping
`validation.never_skip_for`	array	Conditions that always require validation
`escalation.human_approval_required`	array	Conditions that require human approval

Related: bots.yaml, Role Files, CLI: assign