Handoff

Apply this skill to explicit requests to create or resume a handoff. Do not auto-apply it to general summaries, status questions, or ordinary “continue” requests.

Keep the roles separate.

• .tigerkit/seed.md: the task contract defining what must be done, why, and under which conditions
• .tigerkit/handoff.md: the progress snapshot recording what has been done and the current state

A Handoff neither replaces nor copies the Seed.

UI literal propagation

Handoff does not investigate new UI evidence. When the Seed or current verified evidence contains a user-visible string, copy that literal exactly into the handoff/resume explanation: preserve language, case, punctuation, and spacing, and do not translate, paraphrase, or normalize it. An enum, code identifier, route, domain term, or i18n key without verified rendered evidence remains a code literal; keep its Unverifiable qualifier and do not invent a label.

New handoff

Read the current repository evidence.

• branch / HEAD / worktree
• the exact path and status of the current Seed, if present
• actual changed files
• commands actually executed
• actual verification results
• completed and remaining work
• current blockers and next action

Mark only observed facts as verified and only decisions confirmed with the user as confirmed. Commands not executed, prior claims, and model inferences are unverified.

The default path is .tigerkit/handoff.md. Write to a temporary file in the same directory, atomically replace the target, and read it back. Creating the artifact itself does not grant permission to change the product, Git, or remote state.

Preserve at least the following meaning in the Handoff.

Goal/Seed: <seed path 또는 current goal reference>
Status: pending | in_progress | completed | aborted | Blocked
Repository state: <branch, HEAD, worktree>
Decisions: <confirmed progress-relevant decisions>
Changed files: <observed paths | none>
Commands: <actually executed commands | none>
Verification: <check/result/evidence>
Completed work: <done items | none>
Remaining work: <unfinished items | none>
Open questions: <required decisions | none>
Risks: <remaining failure/regression risk>
Next step: <one executable immediate action>
Resume hints: <environment/order/command hints>
Disposition: reported | applied | pending

Do not copy the Seed’s goal/scope/AC/implementation guidance into the Handoff. When needed, reference the exact Seed section/path.

🔴 CHECKPOINT · 🛑 STOP · Write/Resume Boundary

Before writing a new Handoff or continuing a --resume:

• STOP and report Unverifiable when the current Seed, Handoff, branch, HEAD, worktree, or required verification cannot be fresh-read.
• STOP and mark Blocked when evidence conflicts or the Seed contract has drifted; do not resolve either condition inside the Handoff.
• STOP before writing if atomic replacement cannot be completed or readback fails; use .tigerkit/handoff.md by default and honor an explicit --output <path> exactly.
• STOP at any product, Git, or remote publication approval boundary; the artifact does not grant that permission.
• If none of these conditions applies, continue without asking an extra question for a routine artifact update.

Resume

--resume requests resuming work by comparing the handoff snapshot against the current Git and files.

First, fresh-read:

• the current Seed and handoff
• branch/HEAD/worktree
• changed files
• relevant verification evidence
• current remote state, if a PR exists

Then classify drift.

--resume may authorize continuing the work, but it does not replace approval to change the Seed’s goal/scope/decision/AC or permission to publish remotely.

Output

After successfully creating a new handoff, show only the path, current status, and next action briefly in chat. Do not dump the full Handoff body or evidence ledger.

When resuming, explain completed work, remaining work, blockers, and the immediate next action in a way that is easy for a person to understand.

Do not use .tigerkit/ as an archive, current pointer, or global state. Do not modify .gitignore or automatically commit/publish.