From c3d85eb94841a9458d29c80e6f6192ca2c6e1459 Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Thu, 29 Jan 2026 15:35:06 +0000
Subject: [PATCH] docs: clarify dev command scope

- dev is for portable LinuxKit environment, not multi-repo commands
- Multi-repo commands (work, health, commit, etc.) are root-level
- Added See Also link to work/ for multi-repo docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/cmd/dev/index.md | 22 ++++++----------------
 docs/cmd/index.md     |  2 +-
 2 files changed, 7 insertions(+), 17 deletions(-)

diff --git a/docs/cmd/dev/index.md b/docs/cmd/dev/index.md
index 4f063b4..1ba0d29 100644
--- a/docs/cmd/dev/index.md
+++ b/docs/cmd/dev/index.md
@@ -1,22 +1,8 @@
 # core dev
 
-Multi-repo development workflow and portable dev environment.
+Portable development environment based on LinuxKit.
 
-## Multi-Repo Commands
-
-| Command | Description |
-|---------|-------------|
-| [work](work/) | Full workflow: status + commit + push |
-| `health` | Quick health check across repos |
-| `commit` | Claude-assisted commits |
-| `push` | Push repos with unpushed commits |
-| `pull` | Pull repos that are behind |
-| `issues` | List open issues |
-| `reviews` | List PRs needing review |
-| `ci` | Check CI status |
-| `impact` | Show dependency impact |
-
-## Dev Environment Commands
+## Commands
 
 | Command | Description |
 |---------|-------------|
@@ -339,3 +325,7 @@ Images are stored in `~/.core/images/`:
     ├── core-devops-linux-amd64.qcow2
     └── manifest.json
 ```
+
+## See Also
+
+- [work](work/) - Multi-repo workflow commands (`core work`, `core health`, `core commit`, etc.)
diff --git a/docs/cmd/index.md b/docs/cmd/index.md
index aa22970..b45be86 100644
--- a/docs/cmd/index.md
+++ b/docs/cmd/index.md
@@ -11,7 +11,7 @@ Unified interface for Go/PHP development, multi-repo management, and deployment.
 | [build](build/) | Build projects |
 | [ci](ci/) | Publish releases |
 | [sdk](sdk/) | SDK validation |
-| [dev](dev/) | Multi-repo workflow + dev environment |
+| [dev](dev/) | Portable dev environment (LinuxKit) |
 | [pkg](pkg/) | Package management |
 | [vm](vm/) | LinuxKit VM management |
 | [docs](docs/) | Documentation management |