From ef778936b6174fdca9f80164c08fcebe64e7001a Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Thu, 29 Jan 2026 09:55:39 +0000
Subject: [PATCH] docs: add next steps for docs sync setup

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/plans/docs-sync-next-steps.md | 43 ++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 docs/plans/docs-sync-next-steps.md

diff --git a/docs/plans/docs-sync-next-steps.md b/docs/plans/docs-sync-next-steps.md
new file mode 100644
index 00000000..d360a05c
--- /dev/null
+++ b/docs/plans/docs-sync-next-steps.md
@@ -0,0 +1,43 @@
+# Docs Sync Setup - Next Steps
+
+After moving repo to `~/Code/host-uk/core`:
+
+## 1. Add to repos.yaml
+
+Add this to `/Users/snider/Code/host-uk/repos.yaml` under `repos:`:
+
+```yaml
+  # CLI (Go)
+  core:
+    type: foundation
+    description: Core CLI - build, release, deploy for Go/Wails/PHP/containers
+    docs: true
+    ci: github-actions
+```
+
+## 2. Test docs sync
+
+```bash
+cd ~/Code/host-uk
+core docs list          # Should show "core" with docs
+core docs sync --dry-run  # Preview what syncs
+```
+
+## 3. Add CLI section to VitePress (core-php)
+
+Edit `core-php/docs/.vitepress/config.js`:
+- Add `/cli/` to nav
+- Add sidebar for CLI commands
+
+## 4. Sync and verify
+
+```bash
+core docs sync --output ../core-php/docs/cli
+```
+
+---
+
+Current state:
+- CLI docs written in `docs/cmd/*.md` (12 files)
+- `docs/index.md` updated with command table
+- All committed to git