Himmel

Panel-only CR gate for Codex — runs the shell critic panel and CodeRabbit CLI pass over the branch diff, records ledger evidence, and clears the CR marker through the sanctioned chokepoint only when both the panel and CodeRabbit findings are clean (no Critical/Important blockers). Use when the user asks to run /pr-check or clear the CR gate under Codex.

Use when the user says "new epic", "new task", "new standalone", "end session", "update status", "handover", "handover-resume

Arm the OS scheduler to relaunch claude at a given time with a given handover. Dedup-guarded. Use when the user asks to arm a resume / schedule a relaunch or run /handover-arm-resume.

Arm/inspect/remove the recurring luna clip-pipeline cadence (daily harvest+triage, daily synthesize+archive, daily health) via schtasks/cron, each leg pinned to a cheap --model. Dedup-guarded. Use when the user asks to arm/check/disarm the clip-pipeline cadence or runs /pipeline-cadence.

Use when the per-project auto-memory store (`~/.claude/projects/<project-slug>/memory/`: the always-loaded `MEMORY.md` index + one topic file per fact) is approaching or over its load budget (~24.4KB) — the harness emits a size-limit warning at session load when over budget (e.g. "MEMORY.md is NN KB (limit 24.4KB)"), content past the limit is silently dropped = partial recall. Losslessly compounds the DURABLE gotchas out of the auto-memory into qmd-searchable luna / himmel reference notes (read-many → propagation review → write-once → qmd gate → slim index → delete sources), so the always-loaded index stays lean and adopter-generic learnings land in himmel docs (memory + vault never propagate to other users). Lean-invoke, operator-run on demand — NOT an always-on hook (HIMMEL-569).

Use when turning an idea into an implementation plan — runs brainstorm → spec → plan as ONE pipeline with an ADVERSARIAL CRITIC LOOP between each stage. Trigger on "build/implement/design X", "/minerva", or any feature/capability work that should pass through a spec + plan before code. Composes superpowers brainstorming + writing-plans (no fork); adds a spec-critic and a plan-critic.

Decision guide for delegating to caveman-style subagents. Tells the main thread WHEN to spawn `cavecrew-investigator` (locate code), `cavecrew-builder` (1-2 file edit), or `cavecrew-reviewer` (diff review) instead of doing the work inline or using vanilla `Explore`. Subagent output is caveman-compressed so the tool-result injected back into main context is ~60% smaller — main context lasts longer across long sessions. Trigger: "delegate to subagent", "use cavecrew", "spawn investigator/builder/reviewer", "save context", "compressed agent output".

CONTRA passes over the luna vault (LUNA-96/97 — spinoff of the Contrarian Loop concept). Default mode GHOST-SELF: for topics active in the last 14 days, load same-topic notes older than --min-age (default 6 months) and write a short reaction in the voice of past-you to current-you, using ONLY verbatim quotes from the old notes. --bridge mode: force one analogy between a technical-domain note and a personal/philosophical-domain note. Lean-invoke only — never scheduled (manual-proof-first, HIMMEL-177). Triggers on /contra at the user prompt or programmatic Skill dispatch.

Use when the operator wants to lint a vault, run a vault health check, perform a wiki audit, or find orphans and broken wikilinks. Filesystem-only, report-only (no auto-fix in v1). Runs a single deterministic Python pass that converges on large PARA vaults where agent-crawl lint does not. Vault-agnostic — works on any Obsidian vault, not just luna.

Search markdown knowledge bases, notes, and documentation using QMD. Use when users ask to search notes, find documents, or look up information.

Use when bringing up, stopping, snapshotting, provisioning, running e2e probes against, or triggering/arming a claude session ON the himmel test VMs (ubuntu_new / win11_base_himmel). Trigger on "start/stop/snapshot a VM", "run the VM e2e", "provision the VM", "trigger/arm a session on the VM", or "/vm". Front door to the central VM-control SDK (scripts/lib/vmsdk.py, HIMMEL-491/493/835).

Use when backfilling salus health series for one vault time-bucket (HIMMEL-355). Extracts (date, metric, value) tuples for the tracked vitals from the bucket's notes — deterministic structured entries via the luna-vitals CLI, plus an LLM pass over prose/timeline — and writes ONE per-bucket review artifact for operator review. One bucket per armed slot (single-writer). Never writes 50-Vitals/ directly.

Use when ingesting a github OR bitbucket.org repo / issue / PR URL into the luna Obsidian vault — repo URLs fetch metadata + README, follow 1-hop references, classify each (integrate / take-parts / inspire / skip / api_failure) and write a structured tech-ingest note under 30-Resources/Tech/; issue URLs (github.com or bitbucket.org) fetch the issue and write an issue note; bitbucket PR URLs (HIMMEL-329) write a PR note. Triggers on /luna-ingest <url> at user prompt OR programmatic Skill-tool dispatch from inside another runbook (e.g. obsidian-triage:harvest-clips repo-URL dispatch branch). Host-routed: github.com via gh, bitbucket.org via the himmel bitbucket CLI. Rejects twitter / article inputs.

Print the per-critic agreed/availability scorecard and surface drop advice. Use when the user asks for CR critic scores or runs /cr-scores.

Backfill old Claude session transcripts into the luna vault as structured session notes. TOKEN-INTENSIVE — recommend --dry-run first. Use when the user asks to backfill sessions into luna or runs /luna-backfill.

Run a noisy command quietly — one OK/ERR line + log path. Use when the user asks to run something quietly or runs /quiet-run.

Infer a himmel-canonical session name (TICKET-ID + meaningful name) from the current branch and print a ready-to-paste built-in /rename line. Use when the user asks to retitle/rename the session or runs /retitle.

Embedding-indexed lookup over installed skills/commands/agents — eliminates wrong-namespace mistakes. Use when the user asks which skill/command/agent fits an intent, or runs /skill-find.

Mid-session jump to a fresh claude session when the context window approaches the soft budget. Sibling of handover-arm-resume. Use when the user asks to context-hop or run /context-hop.

Auto-commit *.md changes in the handover root (Mode B / external HANDOVER_DIR only). Use when the user asks to commit handover state or run /handover-commit.

Session-end consolidation sweep across handover/* branches — push unpushed, open missing PRs, report merged. Use when the user asks to flush handover branches or run /handover-flush.

Report or check where Claude reads/writes handover state (inline ./handovers or external $HANDOVER_DIR). Use when the user asks where handover state lives or runs /handover-link.

Squash-merge the PR for the current handover/<TICKET>-<slug> branch. Plain merge (no --admin by default). Use when the user asks to merge the handover PR or run /handover-pr-merge.

Open or update the PR for the current handover/<TICKET>-<slug> branch. Idempotent. Use when the user asks to open/refresh the handover PR or run /handover-pr-open.

Use inside a Salus medical vault to FILE a medical item into its structured place (skin photo → photo archive + capture note; lesion/symptom note; lab/PDF → 00-Sources) and auto-commit, OR to QUERY the vault for a health follow-up (grounded answer + flagged, non-diagnostic morphology read). Triggers on "file this photo / note / lab", "log this into the medical vault", "ask the medic", or any health follow-up while cwd = the medical vault. Organize & surface only — never diagnose (posture-A).

Prune merged-PR worktrees AND create a new one in one shot. Use when the user asks to run /clean_garden or prune-and-create a worktree.

Prune merged-PR worktrees (no create). Use when the user asks to clean worktrees or run /clean.

Pre-flight guardrail simulator — flags/rewrites predictable himmel guardrail collisions in planned bash commands before they stall a run. Use when the user asks to simulate guardrails or run /guardrail-sim.

Pre-emptive advisory shell lint (shellcheck + BOM + errexit-leak) on staged shell before commit. Use when the user asks to lint shell or run /shell-lint.

Create a git worktree under .claude/worktrees/ for a type/slug branch (feat|fix|chore|docs|refactor|test). Use when the user asks to make a worktree or run /worktree.

Use when a Telegram message (text, a bare URL, or a forward) arrives that is worth saving into the luna vault — files it as a LUNA-2 Web-Clipper-shaped clip note in Clippings/ so obsidian-triage:harvest-clips ingests it on its next pass. Triggers on /telegram-clip at the user prompt OR programmatic Skill-tool dispatch from the interactive telegram channel session when inbound content should be captured. Provenance (sender, ts, message-id) is preserved; idempotent per message-id. LUNA-58.

Use when an existing luna-second-brain vault needs to pull newer himmel template updates — refreshed bundled-plugin assets, .obsidian config, _CLAUDE.md operating-manual changes, scripts/hooks, scaffold docs, and the PLUGINS-SETUP manual-install list — WITHOUT touching user content (journal, notes, clips). Previews the change plan (dry-run), surfaces any _CLAUDE.md merge conflict or changed manual-install table, asks the operator to confirm, then applies. Triggers on /luna-upgrade at the user prompt OR programmatic Skill-tool dispatch. Distinct from himmel harness self-update and Claude Code marketplace autoUpdate — this is VAULT content/config (HIMMEL-389).

Use when multiple luna-second-brain vaults need to be brought up to the current himmel template in one best-effort pass — dry-run-first sweep across all discovered vaults, per-vault operator-confirmed apply, backup/restore safety net, and a conflict-brainstorm layer that proposes a concrete _CLAUDE.md merge resolution instead of just failing. Triggers on /luna-upgrade-all at the user prompt OR programmatic Skill-tool dispatch. NEVER auto-applies; every apply is confirmed by the operator. Distinct from /luna-upgrade (single vault) and /himmel-update (harness self-update) — this is the MULTI-vault sweep layer above the proven single-vault engine (HIMMEL-462).

Use ONLY when user explicitly asks to bootstrap, set up, initialize, or verify GitHub CLI authentication. Triggers on phrases like "set up gh", "init gh", "check gh auth", "verify github login", "is gh logged in". Do NOT trigger on routine GitHub PR ops (view/list/create/checks) — those have their own skills. Do NOT trigger on Jira setup (HIMMEL-N format or "jira" → himmel-jira plugin).

Use when the operator wants a cross-source roadmap from the luna vault — aggregates actionable items across daily-note action items, the clipper pipeline backlog (_deferred.md), synthesis proposals, promotion candidates, and the component inventory, clusters them into sequenced themes (effort/impact + code vs vault-only target), dedups candidate tickets against the operator's configured Jira projects, and writes a 60-Maps/ roadmap note. Proposals only — never auto-files tickets or restructures the vault. Triggers on /roadmap-clips at the user prompt OR programmatic Skill-tool dispatch. Idempotent per day. LUNA-59.

Use when user asks to list, show, or enumerate Jira issues (e.g. "what jira tickets are open", "list HIMMEL stories", "show me in-progress jira"). MUST mention "jira" or a project key (HIMMEL, LUNA, etc.) or an explicit ticket pattern. Do NOT trigger on "list PRs", "show issues" without context, or GitHub references.

Ultra-compressed commit message generator. Cuts noise from commit messages while preserving intent and reasoning. Conventional Commits format. Subject ≤50 chars, body only when "why" isn't obvious. Use when user says "write a commit", "commit message", "generate commit", "/commit", or invokes /caveman-commit. Auto-triggers when staging changes.

Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra, wenyan-lite, wenyan-full, wenyan-ultra. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.

Use when stuck on one of himmel's own guardrails — an auto-mode Bash/Jira write was DENIED, a command fell through to the auto-mode classifier, a permission prompt hung then aborted, or a pre-push gate failed on a missing attestation trailer (`Platforms tested:` / `Security reviewed:`). Surfaces the operational escape-hatches that deliberately do NOT live in the always-on root CLAUDE.md (HIMMEL-211). Triggers on the denial/friction symptom, not on a slash command. Load-on-trigger, zero always-on token cost.

Use when user asks about CI/check status for a specific GitHub PR ("is PR N passing", "are the checks green on PR 42", "CI status for