| name | demo-handoff |
| description | Use before presentation, judging, client delivery, sprint closeout, or team handoff. Prepares final demo script, runbook, handoff document, known limitations, change history, maintainer notes, and submission-readiness package. |
| argument-hint | [demo-or-release-context] |
Demo and Handoff
Use when
- Need presentation or live demo
- Need someone else to run the project
- Need final delivery package
- Need change history and known limitations
Do not use when
- No product flow exists; use flow/agent-loop first
Inputs to inspect
- PRD
- Feature spec
- Flow
- Architecture
- Eval plan
- Existing README/run commands
Files to create or update
docs/09_flow.mddocs/11_change-log.mddocs/12_handoff.md- Optional
docs/demo-script.md
Operating sequence
- Choose one persuasive end-to-end demo.
- Map every demo step to a real or mock-backed behavior.
- Separate demo shortcuts from production behavior.
- Write minute-by-minute script.
- Document setup/run commands and env vars.
- Add validation status.
- Add known limitations and next priorities.
- Update change log.
Demo Script Table
| Time | Screen/Action | Narration | Evidence Shown | Risk Control Shown | Failure Backup |
Fresh Maintainer Test
A maintainer who did not build the project should be able to:
- install dependencies,
- configure env vars,
- run the demo,
- identify known limitations,
- know the next safe change.
Quality gates
- No “ready” claim without run instructions.
- Known failures are disclosed.
- Change log is updated when scope changed.
Stop conditions
Stop and route backward when prerequisite artifacts are missing, when the requested action would erase user work, or when a high-risk workflow lacks evidence, approval, audit, or fail-closed handling.
Example invocation
/harness-engineering:demo-handoff
Apply this skill to the current repository. Inspect existing artifacts first, update only what is necessary, and report files changed, decisions, assumptions, validation, risks, and next skill.
Shared completion and integrity
End with the completion report in ../../references/common-completion-report.md and follow ../../references/common-integrity-rules.md.
