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>
2.9 KiB
2.9 KiB
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'и
- file-system write side-effect (
- 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.