Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/othmanadi/mddesign/handoffgit clone --depth 1 https://github.com/OthmanAdi/MDDesignWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00028 | $0.00389 |
| Opus 5 | $0.00014 | $0.00195 |
| Sonnet 5 | $0.00006 | $0.00078 |
| Haiku 4.5 | $0.00003 | $0.00039 |
Grade A, and why
handoff scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
/mddesign:handoff
Manual session handoff operations.
Subcommands
/mddesign:handoff catchup (default)
Runs the SessionStart catchup logic now. Read-only.
- Read
task_plan.md,findings.md,progress.md. - Glob
.agents/memory/scratch/**/*.md, read recent entries. - Recall last WHY from MemPalace via
/memory-router. - Print a one-paragraph "where we are" preamble.
- Surface any nudges (missing DESIGN.md, missing planning files, missing memory router).
/mddesign:handoff promote
Runs the Stop promotion logic now. Useful before a planned /clear.
- Dispatch
memory-keepersubagent to classify recent work. - For each WHY candidate, HITL gate (named checkpoint:
before_mempalace_write). - On approval,
memory-layerskill drives/memory-routersave. - Append
### Handoff <timestamp>toprogress.md.
Usage examples
/mddesign:handoff # same as catchup
/mddesign:handoff catchup # read planning + scratch + last WHY, print preamble
/mddesign:handoff promote # pre-emptive stop promotion before /clear
Boundaries
- catchup never writes.
- promote writes only under HITL approval.
- Never edits
task_plan.md.
See skills/session-handoff/SKILL.md for full logic.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 45 lines · 28 tokens per session scan A ff0baa30d77c
handoff is a command published in the GitHub repository OthmanAdi/MDDesign (13 stars, last pushed 4mo ago), licensed Apache-2.0. It adds 28 tokens to every session and 389 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other commands, from other repositories
work
通过 v3 流程发起正式工作请求 (entry gate).
tdd
Guide Test-Driven Development workflow (Red-Green-Refactor).
verify
Run comprehensive pre-PR verification (5-phase quality check).
commit-push-pr
Create git commit, push to remote, and create/merge pull request.
gha
Analyze GitHub Actions CI failures.
handoff
Generate context handoff document for session continuity.