/handoff

Audit bead fields, acceptance criteria, and deliverables before subagent handoff.

8|1|Updated Jan 21, 2024
One-click install
npx skills add https://github.com/azigler/dotfiles --skill handoff-azigler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /handoff
Source: https://github.com/azigler/dotfiles/tree/main/agents/skills/handoff
Command: npx skills add https://github.com/azigler/dotfiles --skill handoff-azigler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents the next agent from inheriting an incomplete or ambiguous outcome by forcing a structured verification of bead readiness before the orchestrator proceeds.

Core Features & Use Cases

  • Checks handoff-critical bead fields: verifies the WHY, acceptance-criteria status, design decisions, notes for continuity, and external references are present and accurate.
  • Validates deliverables by bead type: applies different readiness rules for specs, decisions, tests, implementations, fixes, evaluations, epics, and notes.
  • Requires runtime verification for user-facing implementations: mandates live execution checks (e.g., running the artifact and confirming required components/endpoints) and records the evidence for the orchestrator.

Quick Start

Read your bead contents, then run the handoff checklist and include tests/lint/project gate results and, when applicable, runtime verification evidence in your final handoff message before committing.

Frequently Asked Questions about /handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify subagent work is ready before handing off to the next agent?

Subagent handoff readiness is verified by auditing completed bead fields, checking acceptance criteria status, and validating deliverables based on bead type before the orchestrator proceeds. This structured verification ensures the next agent inherits a complete outcome.

What is agent handoff verification in an orchestration workflow?

Agent handoff verification is the process of auditing a subagent's completed bead fields, acceptance criteria, and deliverables to prevent the next agent from inheriting incomplete or ambiguous outcomes during session transitions or wave dispatching.

How do I run a handoff checklist for different bead types like specs, tests, and implementations?

To run a handoff checklist, read your bead contents, apply bead-type-specific readiness rules for specs, decisions, tests, and implementations, then include tests, lint, project gate results, and runtime verification evidence in your final handoff message.

When should I perform commit readiness checks in a multi-agent workflow?

Commit readiness checks should be performed during subagent wrap-ups before a final commit and during orchestrator-level sanity checks prior to offboarding when transitioning sessions or dispatching the next wave of agents.

What happens if a bead is missing design decisions or notes for continuity?

If a bead is missing design decisions or notes for continuity, the handoff verification will fail the readiness check, preventing the orchestrator from proceeding until the incomplete or ambiguous fields are resolved.

Does the handoff process require mandatory bead readback?

Yes, mandatory bead readback is required to field-by-field acceptance verification, bead-type-specific readiness checks, and runtime verification evidence for user-facing implementation artifacts.