Handover
Produce a concise ownership-transfer artifact after agentic work.
The default output is a shallow handover. It should be useful to the human now and to a future agent later.
Artifact
When this skill is active, create or update:
handover/shallow-handover.md
Path selection:
- If the target repository follows Agentic Rails and an active implementation-plan folder is identifiable, write to
handover/shallow-handover.mdunder that folder. - Otherwise write to
handover/shallow-handover.mdunder the target project's context or documentation folder. - Load references/path-selection.md if the correct location is not obvious.
Inputs To Review
Use what is available. Missing optional files are not failures.
- Current conversation context, if available.
- Recent git commit or diff information, if available and relevant.
plan.md, when present.implementation-log.md, when present.- Optional sibling artifacts:
thinking.md,evidence.md,complaining.md. - Source files, test output, or documentation needed to verify claims.
Output Shape
Write shallow-handover.md with these sections:
# Shallow Handover
## Summary
## Scope Covered
## Outcome
## Evidence Reviewed
## Key Decisions
## Risks And Open Questions
## Suggested Next Step
Claim Standard
Label claims honestly:
- Verified: directly supported by source, command output, commit, or artifact.
- Inferred: likely based on available evidence, but not directly proven.
- Assumed: accepted because the task context required it.
- Unknown: not enough evidence.
Operating Model
- Identify the target project root and handover path.
- Review available context and artifacts.
- Run lightweight source or git inspection if needed to avoid unsupported claims.
- Write the shallow handover in the selected path.
- Mention missing optional artifacts only when their absence matters to confidence.
- Do not create
thinking.md,evidence.md, orcomplaining.mdunless those skills are also active.
Validation
handover/shallow-handover.mdexists in the selected path.- The handover cites the evidence reviewed.
- Claims are labeled when confidence varies.
- Missing optional files are handled gracefully.