# Agent Handoff Protocol — Template
# Version: 1.0.0
# License: CC BY 4.0

# ── Session identity ──
session:
  id: "{SESSION_ID}"
  started: "{ISO_TIMESTAMP}"
  agent: "{AGENT_NAME}"
  model: "{MODEL_NAME}"

# ── Task summary ──
task:
  goal: "{WHAT_WAS_REQUESTED}"
  status: completed | in_progress | blocked | failed

# ── Decisions made ──
decisions:
  - decision: "{WHAT_WAS_DECIDED}"
    why: "{RATIONALE}"
  - decision: "{WHAT_WAS_DECIDED}"
    why: "{RATIONALE}"

# ── Completed work ──
completed:
  - "{THING_DONE}"
  - "{THING_DONE}"
  - "{THING_DONE}"

# ── Files changed ──
files:
  created:
    - "{PATH}"
  modified:
    - "{PATH}"
  deleted:
    - "{PATH}"

# ── Open questions ──
open:
  - "{QUESTION_FOR_NEXT_AGENT}"
  - "{QUESTION_FOR_NEXT_AGENT}"

# ── Next steps ──
next:
  - "{NEXT_ACTION}"
  - "{NEXT_ACTION}"
  - "{NEXT_ACTION}"

# ── Known pitfalls (for next agent) ──
pitfalls:
  - "{PITFALL_TO_AVOID}"
  - "{PITFALL_TO_AVOID}"

# ── Environment state ──
environment:
  working_directory: "{PATH}"
  active_branch: "{BRANCH}"
  last_commit: "{SHA}"
  port: {PORT_NUMBER}