core-framework 2.3.2__tar.gz → 3.0.0__tar.gz

{core_framework-2.3.2 → core_framework-3.0.0}/.cursor/skills/sync-host-rules/SKILL.md

@@ -31,6 +31,17 @@ Diff by **basename** against the host's **`.cursor/`** and applicable **`docs/`*
 
 **Do not overwrite** host-only rules, skills, or product docs.
 
+### `docs/deployments/guides/` layout
+
+Core walkthroughs live under **`docs/deployments/guides/setup/`** (one-time install) and **`docs/deployments/guides/playbook/`** (ops / incident runbooks) — not a flat **`guides/`** directory.
+
+When syncing **`docs/deployments/`** to a host:
+
+1. **Match the directory layout** — create **`guides/setup/`** and **`guides/playbook/`** on the host; move or rewrite files into those paths. Do **not** leave stale flat **`guides/*.md`** copies beside the new tree.
+1. **Basename alone is not enough** — a host may still have **`guides/ubuntu-server-setup.md`** while core has **`guides/setup/ubuntu-server-setup.md`**. Diff by relative path under **`docs/deployments/`**, then port.
+1. **Renames** — e.g. **`postgres-backup-ops.md`** → **`guides/playbook/postgres-backup-playbook.md`**. Delete the old host path after porting.
+1. **Adapt host paths** in playbooks (Compose project dir, image names, **`app_configs/<host>/`**) — keep Henry-specific notes in host **`deploy-playbook.md`** / **`release-playbook.md`**.
+
 ## Docs boundaries
 
 **Core `docs/` must stay host-agnostic** — no references to specific consuming applications.