Template · Jun 2026

Handoff Notes Template

A build-ready handoff format for scope, states, interactions, open questions, analytics, and QA.

Best for
Handoff · Engineering
Format
Markdown context file
Use with
AI agent context
Updated
Jun 2026
How to use it

Built as working context, not shelfware.

This resource is meant to be useful inside the tools where product work now happens: your codebase, your notes, and your AI-assisted workflow.

01

Paste the markdown into Claude, ChatGPT, Cursor, Codex, Gemini, or another AI agent as reusable project context.

02

Use it before a planning, implementation, review, or audit session so the agent has constraints, criteria, and working structure up front.

03

Adapt the sections to your product, team, or repo before asking the agent to execute against it.

Markdown previewhandoff-notes-template.md
# Handoff Notes Template

Use this when a design, prototype, or product spec needs to be safe for engineering to build without repeated interpretation.

## 1. Summary

```md
Feature:
Owner:
Design link:
Prototype link:
Spec link:
Target release:
Primary user job:
```

## 2. Build Scope

- In scope:
- Out of scope:
- Reused components:
- New components:
- Data needed:
- Dependencies:

## 3. States

| State | What triggers it | What user sees | Recovery |
| --- | --- | --- | --- |
| Loading |  |  |  |
| Empty |  |  |  |
| Error |  |  |  |
| Permission |  |  |  |
| Success |  |  |  |

## 4. Interaction Notes

- Keyboard behavior:
- Focus behavior:
- Mobile behavior:
- Validation:
- Undo/recovery:
- Analytics events:

## 5. Open Questions

| Question | Owner | Needed by | Decision |
| --- | --- | --- | --- |
|  |  |  |  |

## 6. QA Pass

- [ ] Happy path tested.
- [ ] Empty/error states tested.
- [ ] Long content tested.
- [ ] Mobile viewport tested.
- [ ] Accessibility basics checked.
- [ ] Analytics or event naming confirmed.
Let's build something

Got something you want shipped well?
Let's talk.

Open to work across senior product, UI/UX, full-stack, and AI-forward opportunities where design taste and shipping speed both matter.

Where
Bogotá, Colombia · remote worldwide
Response time
Usually within 24 hours
Find me
@jpcasabianca · everywhere