Files
claude-skills/.tasks/session-handoff-hermes-mapping.md
vitya 358ba143eb meta(hermes): register session-handoff (mode: pending, intended: auto/productivity)
Without an entry, scripts/build-hermes.py fails ("unmapped skill" — every
skill in skills/ must appear in mapping exactly once). Registered under
the pending block alongside using-yt-tools and using-vds-ops because the
skill has bidirectional file-system side effects (read/write
.tasks/NEXT_SESSION.md) and warrants a behavioral audit before promotion.

intended.category = productivity (mirrors using-tasks/setup-tasks —
workflow-state continuity primitive, not engineering toolchain).

Build now reports 28 skills (14 auto / 2 manual / 9 skip / 3 pending).
SKIPPED.md gains an entry under "Pending" with the intended block
preserved across MVP iterations.

Closes [session-handoff-hermes-mapping].
Promotion to mode: auto deferred to a separate post-audit task.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-24 23:14:11 +03:00

2.9 KiB
Raw Blame History

session-handoff-hermes-mapping

Goal

Зарегистрировать скил session-handoff в hermes/mapping.yaml в режиме pending с intended: { mode: auto, category: productivity }. Без entry'а scripts/build-hermes.py падает с exit 1 ("unmapped skill" — каждый скил в skills/ обязан appear в mapping ровно один раз). После entry'а SKIPPED.md показывает session-handoff под Pending с full intended-block.

Key files

  • hermes/mapping.yaml:147-166 — pending block получил третий entry (session-handoff после using-vds-ops)
  • scripts/build-hermes.py — converter, читает mapping, пишет dist-hermes/
  • dist-hermes/SKIPPED.md — auto-generated, отражает pending entries с intended-блоком

Decisions log

  • 2026-05-24: mode = pending (не auto), потому что:
    • file-system write side-effect (.tasks/NEXT_SESSION.md)
    • bidirectional (read on start + write on end)
    • первое promotion требует behavioral audit на Hermes side
    • precedent: using-yt-tools (shells external CLI + writes cwd), using-vds-ops (touches infra) — оба сидят в pending до test-trigger task'и
  • 2026-05-24: intended.category = productivity, не software-development. Аналогично using-tasks / setup-tasks — это session-state / workflow-continuity primitive, не engineering toolchain. session-lifecycle ближе к task-state continuity (productivity) чем к build/test/ci (software-development).
  • 2026-05-24: intended.mode = auto (после audit'а). Cross-machine handoff value сохраняется на Hermes-машинах так же как на Claude-Code — skill не зависит от Claude-specific harness primitives кроме trigger-line discovery (которая в Hermes тоже работает).
  • 2026-05-24: comment header bumped from "pending (1 — ...)" to "pending (3 — ...)" — three pending entries теперь (using-yt-tools, using-vds-ops, session-handoff).

Open questions

  • нет — promotion в mode: auto отдельная work-item, не часть этой таски

Completed steps

  • read hermes/mapping.yaml, identify nearest precedent (using-yt-tools / using-vds-ops pending pattern)
  • add session-handoff entry with mode: pending + intended block + reason
  • update comment header count "(1)" → "(3)"
  • python scripts\build-hermes.py → 28 skills, 3 pending, exit 0
  • verify SKIPPED.md pending block contains session-handoff with intended
  • STATUS.md → 🟢
  • commit (next)

Notes

Promotion pending → auto запланирован через follow-up task (по аналогии с using-yt-tools-test-trigger smoke pass'ом). Не нужно делать в одной session с registration — clean session separation для fresh-eyes audit.