Handbook

board_game_coach_notes v1

Invariant: Coaching text must relate to provided legal_moves only; if focus_move_id is set, it must match one of the listed move_id values.

Updated

Input: player_view, legal_moves, optional focus_move_id (string or null), learner_level (string).

Output: {notes: string, pitfalls?: string, practice_prompt?: string, ...}.

Failure modes

  • TransportFailure — chat transport errors.
  • ParseFailure — assistant output not valid JSON.
  • SchemaFailure — input or output rejected vs contract schemas.
  • GatewayFailure — upstream/provider errors.

Verification

Task-internal validation and JSON schema checks per contract.json verification_policy.

Changelog

  • v1 — Maintained in catalog; see git history for semantic changes.