---
title: "Handoff Artifacts"
description: "Structured, self-contained markdown documents that bridge context across session boundaries and multi-agent workflows."
section: "concepts"
type: "concept"
created: "2026-08-22"
updated: "2026-08-27"
confidence: "high"
tags: ["agents", "context-engineering", "workflow"]
canonical: "https://pyweb.dev/wiki/handoff-artifacts"
---
# Handoff Artifacts

A **Handoff Artifact** is a structured, immutable summary document created at a phase boundary to transfer essential state, decisions, and unblocked tasks from one context window or agent to another.

## Why Raw Transcripts Fail
When migrating work across sessions or tools, passing the full unedited conversation transcript introduces immense noise, outdated assumptions, and token bloat. A handoff artifact acts as a lossy compression filter that preserves signal while discarding intermediate dead-ends.

## Anatomy of a Great Handoff Artifact
1. **Objective:** A one-sentence summary of what was accomplished and what the next session must achieve.
2. **Current State:** Verifiable facts backed by tool output (git commit SHA, passing test counts, created file paths).
3. **Decisions Made:** Architectural choices and hard constraints established in the prior session.
4. **Immediate Frontier:** A concrete, ordered checklist of next actions with blockers clearly identified.

## When to Use Handoffs
- Transitioning from an exploratory prototype branch back to the main feature branch.
- Crossing from planning/spec creation into ticket execution.
- Handing off tasks between different agent harnesses and sessions.

## Related
[smart zone](/wiki/smart-zone), [context rot](/wiki/context-rot), [idea to ship flow](/wiki/idea-to-ship-flow), [progressive disclosure](/wiki/progressive-disclosure), [ai coding taxonomy](/wiki/ai-coding-taxonomy).

---

## Agent Navigation

cluster: person (170 pages) | betweenness: 2.3

### References (outbound)
- [Smart Zone](https://pyweb.dev/wiki/smart-zone.md)

### Referenced by (inbound)
- [AI Coding Taxonomy & Agent Experience](https://pyweb.dev/wiki/ai-coding-taxonomy.md)
- [Generator-Evaluator Loop](https://pyweb.dev/wiki/generator-evaluator-loop.md)
- [Smart Zone](https://pyweb.dev/wiki/smart-zone.md)

### Evidence (verified primary sources)
- [aihero-dev-homepage-2026](https://pyweb.dev/wiki/raw/articles/aihero-dev-homepage-2026.md) | origin: https://www.aihero.dev/ | ingested: 2026-08-22 | sha256: 231157fed45f82922924a050e09b5b81a443891814fc1d72c874d864a6075419
- [mattpocock-skills-repo-2026](https://pyweb.dev/wiki/raw/articles/mattpocock-skills-repo-2026.md) | origin: https://github.com/mattpocock/skills | ingested: 2026-08-22 | sha256: 1a38fb49eb8ebbaf1c4397d21232a405ba8565744e0c8306cf5beec4f94b4224
- [aihero-ai-coding-dictionary-2026](https://pyweb.dev/wiki/raw/articles/aihero-ai-coding-dictionary-2026.md) | origin: https://www.aihero.dev/ai-coding-dictionary | ingested: 2026-08-27 | sha256: 52b0a5da7c9f6dd60dfdbf29031bcf6107c2765b6ef5b3a7f96cc607f42b06c7

### Machine endpoints
- Knowledge graph: https://pyweb.dev/api/graph.json
- Graph analysis: https://pyweb.dev/api/graph-analysis.json
- Context index: https://pyweb.dev/llms.txt