# hermes-converter-mvp

## Goal
Conversion infrastructure для Hermes-rollout (Nous Research). Источник истины
остаётся `claude-skills/skills/`; converter читает `hermes/mapping.yaml` и пишет
`dist-hermes/<category>/<name>/` в Hermes-formate. MVP: 4 universal-скила
(`pulling-before-work`, `active-platform`, `project-discipline`,
`using-markitdown`) проходят через converter и оседают в `dist-hermes/`.
Остальные 18 скилов имеют `mode: skip` или `mode: pending` (deferred to
`hermes-mvp-coverage` / `hermes-flavour-mcp-setups`).

## Key files
- `.wiki/concepts/hermes-skills-rollout-design.md` — design, audit-table, Q1-Q8
- `hermes/mapping.yaml` — schema + per-skill mode/category/replace-rules (NEW)
- `scripts/build-hermes.py` — converter (NEW)
- `dist-hermes/<cat>/<name>/SKILL.md` — output (NEW, committed)
- `dist-hermes/SKIPPED.md` — skip-log (NEW)

## Decisions log
- 2026-05-06: Python only — `build-hermes.py`. Bash variant out-of-scope (task
  block writes `{sh,py}` but next_action says "Python предпочтительнее"; YAML
  + template logic clearer in Python).
- 2026-05-06: mapping uses 4 modes — `auto` / `manual` / `skip` / `pending`.
  `pending` = listed but not built yet, lands in SKIPPED.md with rationale.
  Forces every `skills/<name>/` to have an explicit mapping entry — no silent
  drops.
- 2026-05-06: replace-rules applied as ordered string-substitutions on SKILL.md
  before write. For Linux-default platform-switch on `active-platform`.

## Open questions
- [ ] Hermes `~/.hermes/skills/` exact category names — `software-development`,
      `productivity`, `mcp`, `research` per design doc; verify against Hermes
      docs in `hermes-mvp-coverage`.

## Completed steps
- [x] mapping.yaml schema (22 skills mapped, 4-mode: auto/manual/skip/pending)
- [x] build-hermes.py (PyYAML; replace-rules; strict-mapping)
- [x] dist-hermes/ for 4 universals (software-development/×3 + productivity/×1)
- [x] SKIPPED.md auto-generated (8 skip + 10 pending with intended-mode)
- [x] README.md "Build for Hermes" section + Layout update
- [x] commit `6b36b31 feat(hermes): MVP converter + 4 universal skills converted`
- [x] task closed via post-commit prompt + coverage check (using-tasks v1.1.0 self-applied)
- [ ] push (next step)

## Closing notes (2026-05-07)
- Acceptance criteria 5 (security templates) — infrastructure shipped; content
  deferred to `[hermes-flavour-mcp-setups]` (manual-mode files in
  `hermes/skills/setup-projects-meta/`, `hermes/skills/setup-context7/`).
- Coverage check used `[using-tasks-close-coverage-gate]` v1.1.0 rule —
  acceptance walked criterion-by-criterion before flipping to 🟢.

## Notes
- Per-task started under «давай без меня все» grant — autonomous push allowed
  for this task.