handoff · diff

git:20261101.0db12c0 to git:20261118.549ccf7

12 added, 19 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

---
name: handoff
- description: Checkpoints current Scrum Sprint progress, active ticket state, downstream seam notes, and the single immediate next action into .scratch/handoff.md and docs/sprint/SPRINT.md. Use when ending a session, switching context, or handing off work to a fresh agent session.
+ description: Checkpoints current Scrum Sprint progress, active ticket state, downstream seam notes, and the single immediate next action into .scratch/handoff.md and docs/sprint/SPRINT.md. Use when ending a session, switching context, or handing off work to a fresh session.
---
- # Handoff (Multi-Session Scrum & Context Continuity)
+ # Handoff (Multi-Session Continuity)
- Checkpoint the active session state into `.scratch/handoff.md` (and sync `docs/sprint/SPRINT.md` if present) using [resources/handoff-template.md](resources/handoff-template.md) so the next session can resume in seconds with zero context loss.
+ Checkpoint active session state into `.scratch/handoff.md` (and sync `docs/sprint/SPRINT.md` if present) using [resources/handoff-template.md](resources/handoff-template.md).
## Decision tree
- 1. **Are there uncommitted functional changes in `git status` that already pass tests and satisfy the current ticket's DoD?**
- - **Yes** → If the user authorized commits in this session, commit them with an atomic Conventional Commit and update the ticket's `Completion Log` before writing the handoff. If not, record the ready-to-commit file list and proposed message in both places instead of committing.
- - **No (stopping mid-ticket / WIP)** → Explicitly record the completed sub-tasks, remaining sub-tasks, and current failing/passing test state in both the ticket file and `.scratch/handoff.md`.
- 2. **Did domain glossary terms or architectural decisions settle during this session?**
- - **Yes** → Update `CONTEXT.md` (or `docs/adr/`) first so permanent domain knowledge is never trapped in ephemeral handoff notes.
- - **No** → Proceed to the handoff workflow below.
+ 1. **Are there uncommitted functional changes passing full verification and satisfying the current ticket DoD?**
+ - **Yes** → If commits were authorized in this session, create an atomic Conventional Commit and log the SHA. Otherwise leave the tree green and record the ready file list + proposed commit message.
+ - **No (WIP)** → Record completed steps, remaining steps, and exact failing/passing test output in both the ticket file and `.scratch/handoff.md`.
+ 2. **Did codebase index facts, shared components, or domain invariants change?**
+ - **Yes** → Update `CONTEXT.md` (or `docs/adr/`) first so durable facts are not trapped in ephemeral `.scratch/handoff.md`.
+ - **No** → Write `.scratch/handoff.md`.
- ## Handoff workflow
+ ## Workflow
- 1. **Inspect Git & Sprint State**:
- - Run `git status -sb` and `git log -3 --oneline` via `run_command`.
- - Read `docs/sprint/SPRINT.md` (if present) to verify ticket statuses (`done`, `in-progress`, `ready`, `blocked`) and active Wave progress.
- 2. **Write `.scratch/handoff.md`**:
- - Populate [resources/handoff-template.md](resources/handoff-template.md).
- - Link directly to `docs/sprint/SPRINT.md`, active ticket files (`docs/sprint/tickets/<NN>-<slug>.md`), and modified code files rather than pasting large file dumps.
- - Document **Downstream Seam & Contract Notes** (exact exported functions, types, or invariants introduced in this session that the next ticket depends on) and **Falsified Approaches** (dead-ends the next session must not repeat).
- - Redact any credentials, tokens, or secrets as `<REDACTED>`.
- - Specify **exactly one** concrete, runnable command or ticket invocation (`/implement docs/sprint/tickets/<NN>-<slug>.md`) under `## 5. Immediate Next Session Action`.
+ 1. Run `git status -sb` and `git log -3 --oneline` via `run_command`, and read `docs/sprint/SPRINT.md` if present.
+ 2. Populate [resources/handoff-template.md](resources/handoff-template.md) with file links (no large code dumps), **Downstream Seam & Contract Notes**, **Falsified Approaches**, redacted secrets (`<REDACTED>`), and **one** runnable next-session command (`/implement docs/sprint/tickets/<NN>-<slug>.md`).