handoff-log-update

cdrguru's avatarfrom cdrguru

Append a structured entry to the handoff log when an agent completes work, is blocked, or needs to pass ownership.

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025
[Agent Observability]

When & Why to Use This Skill

This Claude skill automates the generation of structured handoff logs to ensure seamless continuity in agentic workflows. By recording work status, blockers, and ownership transitions in a standardized format, it provides a clear audit trail and maintains context across multi-agent systems or human-agent collaborations.

Use Cases

  • Multi-Agent Task Delegation: Use this skill to document the transfer of responsibility when one agent completes a specific phase of a project and hands it off to another specialized agent.
  • Incident and Blocker Tracking: Record precise details when an agent is blocked by external dependencies or errors, allowing developers to quickly diagnose issues through the append-only log.
  • Human-in-the-Loop Transitions: Provide a structured summary of progress and pending tasks when an agent requires human intervention, ensuring the human operator has all necessary context to take over.
  • Project State Auditing: Maintain a chronological history of agent activities and decisions for compliance, debugging, and performance evaluation in complex software engineering tasks.
namehandoff-log-update
descriptionAppend a structured entry to the handoff log when an agent completes work, is blocked, or needs to pass ownership.
short-descriptionAppend a structured handoff entry to the log

Handoff Log Update

When to use

Use when you need to record a handoff, status, or next actions in the append-only log.

Procedure

  1. Gather the required fields: agent name, summary, handoff target, tasks, and references.
  2. Run the log update script with explicit flags:
python3 .agent/tools/utilities/update_agent_conversation_log.py \
  --agent <agent> \
  --summary "<summary>" \
  --handoff <next-owner> \
  --task "<next task>" \
  --reference "<path>"
  1. Confirm the entry was appended to .agent/docs/agent_handoffs/agent_conversation_log.md.

Inputs and outputs

  • Inputs: agent, summary, handoff target, tasks, references, optional context/status
  • Outputs: appended entry in .agent/docs/agent_handoffs/agent_conversation_log.md

Constraints

  • Never edit or delete existing log entries
  • Keep summaries and tasks concise
  • ASCII-only

Examples

  • $handoff-log-update