docs: fix command prefixes - use 'core dev' not 'core'

Multi-repo commands are under 'core dev':
- core dev work, core dev health, core dev commit, etc.

Not root-level commands.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Snider 2026-01-29 15:40:13 +00:00
parent c3d85eb948
commit 5652b6b508
4 changed files with 43 additions and 46 deletions

View file

@ -1,8 +1,21 @@
# core dev # core dev
Portable development environment based on LinuxKit. Multi-repo workflow and portable development environment.
## Commands ## 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 |
| `impact` | Show dependency impact |
## Dev Environment Commands
| Command | Description | | Command | Description |
|---------|-------------| |---------|-------------|
@ -328,4 +341,4 @@ Images are stored in `~/.core/images/`:
## See Also ## See Also
- [work](work/) - Multi-repo workflow commands (`core work`, `core health`, `core commit`, etc.) - [work](work/) - Multi-repo workflow commands (`core dev work`, `core dev health`, etc.)

View file

@ -1,45 +1,44 @@
# core work # core dev work
Multi-repo git operations for managing the host-uk organization. Multi-repo git operations for managing the host-uk organization.
## Overview ## Overview
The `work` command and related commands (`health`, `issues`, `reviews`, `commit`, `push`, `pull`, `impact`, `ci`) help manage multiple repositories in the host-uk ecosystem simultaneously. The `core dev work` command and related subcommands help manage multiple repositories in the host-uk ecosystem simultaneously.
## Commands ## Commands
| Command | Description | | Command | Description |
|---------|-------------| |---------|-------------|
| `core work` | Multi-repo git operations | | `core dev work` | Full workflow: status + commit + push |
| `core health` | Quick health check across all repos | | `core dev work --status` | Status table only |
| `core issues` | List open issues across all repos | | `core dev health` | Quick health check across all repos |
| `core reviews` | List PRs needing review | | `core dev issues` | List open issues across all repos |
| `core commit` | Claude-assisted commits across repos | | `core dev reviews` | List PRs needing review |
| `core push` | Push commits across all repos | | `core dev commit` | Claude-assisted commits across repos |
| `core pull` | Pull updates across all repos | | `core dev push` | Push commits across all repos |
| `core impact` | Show impact of changing a repo | | `core dev pull` | Pull updates across all repos |
| `core ci` | Check CI status across all repos | | `core dev impact` | Show impact of changing a repo |
## core health ## core dev health
Quick health check showing status of all repos. Quick health check showing status of all repos.
```bash ```bash
core health core dev health
``` ```
Output shows: Output shows:
- Git status (clean/dirty) - Git status (clean/dirty)
- Current branch - Current branch
- Commits ahead/behind remote - Commits ahead/behind remote
- CI status
## core issues ## core dev issues
List open issues across all repositories. List open issues across all repositories.
```bash ```bash
core issues [flags] core dev issues [flags]
``` ```
### Flags ### Flags
@ -50,12 +49,12 @@ core issues [flags]
| `--label` | Filter by label | | `--label` | Filter by label |
| `--limit` | Max issues per repo | | `--limit` | Max issues per repo |
## core reviews ## core dev reviews
List pull requests needing review. List pull requests needing review.
```bash ```bash
core reviews [flags] core dev reviews [flags]
``` ```
Shows PRs where: Shows PRs where:
@ -63,12 +62,12 @@ Shows PRs where:
- PR is open and not draft - PR is open and not draft
- CI is passing - CI is passing
## core commit ## core dev commit
Create commits across repos with Claude assistance. Create commits across repos with Claude assistance.
```bash ```bash
core commit [flags] core dev commit [flags]
``` ```
### Flags ### Flags
@ -80,12 +79,12 @@ core commit [flags]
Claude analyzes changes and suggests conventional commit messages. Claude analyzes changes and suggests conventional commit messages.
## core push ## core dev push
Push commits across all repos. Push commits across all repos.
```bash ```bash
core push [flags] core dev push [flags]
``` ```
### Flags ### Flags
@ -95,12 +94,12 @@ core push [flags]
| `--all` | Push all repos with unpushed commits | | `--all` | Push all repos with unpushed commits |
| `--force` | Force push (use with caution) | | `--force` | Force push (use with caution) |
## core pull ## core dev pull
Pull updates across all repos. Pull updates across all repos.
```bash ```bash
core pull [flags] core dev pull [flags]
``` ```
### Flags ### Flags
@ -110,12 +109,12 @@ core pull [flags]
| `--all` | Pull all repos | | `--all` | Pull all repos |
| `--rebase` | Rebase instead of merge | | `--rebase` | Rebase instead of merge |
## core impact ## core dev impact
Show the impact of changing a repository. Show the impact of changing a repository.
```bash ```bash
core impact <repo> core dev impact <repo>
``` ```
Shows: Shows:
@ -123,21 +122,6 @@ Shows:
- Reverse dependencies - Reverse dependencies
- Potential breaking changes - Potential breaking changes
## core ci
Check CI status across all repos.
```bash
core ci [flags]
```
### Flags
| Flag | Description |
|------|-------------|
| `--watch` | Watch for status changes |
| `--failing` | Show only failing repos |
## Registry ## Registry
These commands use `repos.yaml` to know which repos to manage: These commands use `repos.yaml` to know which repos to manage:

View file

@ -11,7 +11,7 @@ Unified interface for Go/PHP development, multi-repo management, and deployment.
| [build](build/) | Build projects | | [build](build/) | Build projects |
| [ci](ci/) | Publish releases | | [ci](ci/) | Publish releases |
| [sdk](sdk/) | SDK validation | | [sdk](sdk/) | SDK validation |
| [dev](dev/) | Portable dev environment (LinuxKit) | | [dev](dev/) | Multi-repo workflow + dev environment |
| [pkg](pkg/) | Package management | | [pkg](pkg/) | Package management |
| [vm](vm/) | LinuxKit VM management | | [vm](vm/) | LinuxKit VM management |
| [docs](docs/) | Documentation management | | [docs](docs/) | Documentation management |

View file

@ -25,7 +25,7 @@ See [cmd/](cmd/) for full command documentation.
| [build](cmd/build/) | Build Go, Wails, Docker, LinuxKit projects | | [build](cmd/build/) | Build Go, Wails, Docker, LinuxKit projects |
| [ci](cmd/ci/) | Publish releases (dry-run by default) | | [ci](cmd/ci/) | Publish releases (dry-run by default) |
| [sdk](cmd/sdk/) | SDK validation | | [sdk](cmd/sdk/) | SDK validation |
| [dev](cmd/dev/) | Multi-repo workflow | | [dev](cmd/dev/) | Multi-repo workflow + dev environment |
| [pkg](cmd/pkg/) | Package search and install | | [pkg](cmd/pkg/) | Package search and install |
| [vm](cmd/vm/) | LinuxKit VM management | | [vm](cmd/vm/) | LinuxKit VM management |
| [docs](cmd/docs/) | Documentation management | | [docs](cmd/docs/) | Documentation management |