ComputerConnection/skills/handoff

NEXUS Handoff Generator

Generate a handoff block for: $ARGUMENTS

Reference the protocol: HANDOFF_PROTOCOL.md

---

Step 1: Gather Context

Before generating the handoff, collect:

From Git:

• What files were modified/created this session?
• What's the diff summary?

From Memory:

• What was the original ask/intent?
• What decisions were made and why?
• What's explicitly OUT of scope?

From Current State:

• Is the work complete, partial, or blocked?
• What would the next person need to know to continue?

---

Step 2: Generate Handoff Block

Output a YAML block following this exact schema:

handoff:
  from_agent: <$0 or "claude">
  to_agent: <next agent or "any">
  timestamp: <current ISO 8601>
  task_id: <$1 or generate from context>

  summary:
    what_was_done: |
      # 2-3 sentences. Be specific. What actually shipped?

    decisions_made:
      - decision: <what was decided>
        rationale: <why - the "why" prevents future "why did we do this?">
        alternatives_rejected:
          - <option not taken and brief reason>

    current_state:
      files_modified: []
      files_created: []
      dependencies_added: []
      config_changes: []

  context_for_next_agent:
    must_know:
      # Critical facts. If missed, drift WILL happen.
      - <fact>
      - <constraint>

    original_intent: |
      # Restate the original goal. This is the anchor.
      # Copy from ORIGINAL_BRIEF.md if it exists.

    scope_boundaries:
      in_scope:
        - <what's included>
      out_of_scope:
        - <what's explicitly NOT included - even if tempting>

  status:
    completion: <complete | partial | blocked>

    # Include if partial:
    if_partial:
      remaining_work:
        - <specific task>
      why_stopping: |
        # Why hand off now?

    # Include if blocked:
    if_blocked:
      blocker: |
        # What's blocking?
      needs_from: <who can unblock>
      unblock_criteria: |
        # What needs to happen?

  next_steps:
    immediate:
      - <next action - be specific>
    suggested_approach: |
      # How might the next agent tackle this?
    warnings:
      - <gotcha or trap to avoid>

  verification:
    how_to_verify: |
      # How to confirm this work is correct?
    test_commands: []
    expected_outcomes: []

  # Optional sections - include if relevant:
  technical_debt:
    - item: <what was deferred>
      reason: <why>
      severity: <low | medium | high>

  questions_for_zach:
    - <decisions that need human input>

---

Step 3: Anti-Drift Checklist

Before finalizing, verify:

• [ ] Restated original intent (not my interpretation of it)
• [ ] Listed ALL decisions with rationale
• [ ] Defined clear scope boundaries
• [ ] Specified how to verify the work
• [ ] Flagged blockers or questions
• [ ] Did NOT include work outside original scope
• [ ] Logged observed issues as technical debt (not fixed)

---

Step 4: Save Location

If a NEXUS project structure exists, save to:

/nexus/projects/<project_id>/CURRENT_STATE.yaml

Also append to:

/nexus/projects/<project_id>/handoff_log/<sequence>_<from>_to_<to>.yaml

If no project structure, output the block for manual placement.

---

Output Format

1. Show the complete YAML handoff block
2. Show the anti-drift checklist (checked/unchecked)
3. Suggest where to save it
4. Ask if anything needs adjustment before finalizing