How does the skill handle content filtering or API 400 errors?

It includes an automatic recovery mechanism that retries blocked writes using safer, neutral language to ensure the handoff workflow continues without manual intervention.

Where is the state of the handoff stored?

State is maintained in handoff-state.json and role assignments in ai-handoff.yaml, ensuring project orientation is preserved across different sessions.

Can this skill be used for human-in-the-loop workflows?

Yes, the skill includes a specific 'needs-human' state that pauses the AI workflow and prompts for human intervention in the cycle file.

What is the difference between a Lead and a Reviewer in this skill?

The Lead is responsible for creating plans and implementations, while the Reviewer examines the work, provides feedback, requests changes, or grants final approval.

When should I use the /handoff status command?

Use /handoff status whenever you need to re-orient yourself with the current project phase, the current round of review, and to see whose turn it is to act.

AI Workflow Handoff

Name: AI Workflow Handoff
Author: jblacketter

byjblacketter

0•

Productividad y Flujo de Trabajo

Manages structured collaboration between AI agents and human reviewers with automated state tracking and role-based feedback loops.

The Handoff skill provides a robust framework for managing multi-agent or AI-human development cycles within Claude Code. By implementing a standardized Lead and Reviewer protocol, it ensures that technical plans and implementations undergo rigorous review before progression. The skill automatically tracks state across configuration files, handles error recovery for sensitive content blocks, and provides a clear audit trail of development phases, making it an essential tool for maintaining consistency and quality in complex, collaborative AI-driven engineering tasks.

Características Principales

01Lead and Reviewer role-based state management

02Persistent state tracking via JSON and YAML configuration files

030 GitHub stars

04Automated tracking of plan and implementation review cycles

05Built-in error recovery for API 400 and content filtering blocks

06Standardized handoff status and orientation reporting

Casos de Uso

01Coordinating complex feature development between multiple Claude instances

02Implementing a formal code review process for AI-generated contributions

03Ensuring project continuity across different coding sessions or development phases

Características Principales

01Lead and Reviewer role-based state management

02Persistent state tracking via JSON and YAML configuration files

030 GitHub stars

04Automated tracking of plan and implementation review cycles

05Built-in error recovery for API 400 and content filtering blocks

06Standardized handoff status and orientation reporting

Casos de Uso

01Coordinating complex feature development between multiple Claude instances

02Implementing a formal code review process for AI-generated contributions

03Ensuring project continuity across different coding sessions or development phases