workflowgenerate-handoff

name	workflow/generate-handoff
description	Generates a structured handoff artifact with guard rails.
version	0.1.0
status	experimental
family	workflow
role	Strategist
allowed-tools	["list_dir","write_to_file"]
policies	["A.15.1 U.Work"]
outputs	["HandoffRecord"]

Workflow: Generate Handoff

1. Context

This skill generates a structured handoff artifact with validated instructions and guard rails, producing deterministic file paths.

2. Inputs

• context (required): Bounded context name (safe path segment).
• session_id (required): Session identifier (safe path segment).
• from_agent_type (optional): Issuing agent type (default: strategist).
• to_agent_type (required): Receiving agent type (safe path segment).
• instructions (required): Semicolon-delimited instructions.
• acceptance_criteria (optional): Semicolon-delimited acceptance criteria.
• constraints (optional): Semicolon-delimited constraints.
• prohibited_actions (optional): Semicolon-delimited prohibited actions.
• artifacts (optional): Semicolon-delimited artifact paths.
• notes (optional): Freeform notes.
• agent_model (optional): Agent model identifier.
• role_assignment (optional): RoleAssignment for U.Work logging (default: Strategist).
• decisions (optional): Semicolon-delimited DRR ids/paths.
• timestamp_start (optional): ISO-8601 timestamp for deterministic output.

3. Outputs

• runtime/contexts/<context>/handoffs/<session_id>.<to_agent_type>.<n>.handoff.yaml

4. Procedure

1. Validate inputs and ensure guard rails are present.
2. Determine the next handoff counter for the target agent type.
3. Write the handoff YAML record.
4. Emit U.Work via telemetry/log-work when available.