Files

dtoro 5c5016b3c7 docs: reshape runbooks into .agents/skills/<name>/SKILL.md (phase 4)

Problem: runbooks are agent-executable procedures but lived at the repo root,
separate from the other agent instruction now under .agents/.

Change:
- Move runbooks/<name>.md -> .agents/skills/<name>/SKILL.md (folder per skill,
  matching the wiki-hq skills layout). Frontmatter (name, risk_class, inputs,
  verification, docs_update_checklist, transition) preserved.
- Rewrite links (inbound from plans; between-skill siblings) via the move map.
- Update prose references in AGENTS.md, HERMES.md, .agents/OIKOS.md, and the
  operations schema; fix a pre-existing stale link to operations/commands.md.

No code consumed runbooks/ by path, so nothing else changes.

Verification: all SKILL.md frontmatter parses with valid risk_class; every
lifecycle transition resolves to an oikos/ontology.yaml state; broken-link
count 127 -> 126 (fixed one, introduced none).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-06 14:39:31 +02:00

1.9 KiB

Raw Blame History

name, risk_class, inputs, verification, docs_update_checklist, transition

name

risk_class

inputs

verification

docs_update_checklist

transition

lifecycle-migrate-node

config_mutation

node_name

source_host

target_host

homelab node <name> relations (re-check blast radius); homelab service <svc> health for every hosted service

doc_page_migration_note

inventory_host_and_lan_ip

active -> migrating -> active

Lifecycle: migrate a node

Modeled on the strong Phase 1+2 migration (plans/2026-06-03_110000-library-ssd-migration-to-ludo-mini.md). Requires (ontology): preflight + backup-verified before migrating; post-verify + Caddy backends checked + mounts checked + docs updated before returning to active.

homelab change preflight <every service the node hosts> — capture current health as a baseline.
Verify backups are current for anything with data at rest on the node (see backs-up-to edges once populated).
Set state: migrating in inventory.yaml.
Perform the migration (pct/qm move, or create-on-target + data-copy + destroy-source, per the specific case).
Update inventory.yaml: new host:, lan_ip, mesh addresses for the node; update every services: entry whose backend pointed at it if the backend name itself changes (usually it doesn't — only the host:/lan_ip on the guest entry moves).
Post-verify: re-run the Week-1 drift check by hand — confirm Caddy's backend IP for each affected service matches the new lan_ip (automatic in Week 3's drift detector), confirm mounts still resolve.
homelab service <name> health for every service the node hosts.
Set state: active. Add a migration note to the node's doc page (old host/IP → new, date, phase reference) — this repo's convention for every past migration (see containers/101-jellyfin.md, containers/129-house.md).

Regenerate: python3 mcp/build_host_files.py && python3 oikos/gen-topology.py.

1.9 KiB Raw Blame History

Lifecycle: migrate a node

1.9 KiB

Raw Blame History