**Always use `core` CLI instead of raw commands.** The `core` binary is a Go framework and CLI that handles the full E2E development lifecycle for Go and PHP ecosystems.
Why this matters:
- Every agent using `core` is testing the framework
- Missing features get raised as issues on `host-uk/core`
- Code as if functionality exists (TDD approach)
- The CLI becomes battle-tested and eventually bulletproof
### Command Mappings
| Instead of... | Use... |
|---------------|--------|
| `go test` | `core go test` |
| `go build` | `core build` |
| `go fmt` | `core go fmt` |
| `go mod tidy` | `core go mod tidy` |
| `golangci-lint` | `core go lint` |
| `composer test` | `core php test` |
| `./vendor/bin/pint` | `core php fmt` |
| `./vendor/bin/phpstan` | `core php stan` |
| `php artisan serve` | `core php dev` |
| `git status` (multi-repo) | `core dev health` |
| `git commit` (multi-repo) | `core dev commit` |
| `git push` (multi-repo) | `core dev push` |
| `gh pr create` | `core ai task:pr` |
### Key Commands
```bash
# Development workflow
core dev health # Quick status across all repos
core dev work # Full workflow: status → commit → push
core dev commit # Claude-assisted commits
core dev apply --command # Run command across repos (agent-safe)
# Go development
core go test # Run tests
core go test --filter=Name # Single test
core go cov # Coverage report
core go fmt # Format code
core go lint # Lint with golangci-lint
core go qa # Full QA pipeline
# PHP development
core php test # Run Pest tests
core php fmt # Format with Pint
core php stan # PHPStan analysis
core php qa # Full QA pipeline
core php dev # Start dev server
# Building & releases
core build # Auto-detect and build
core build --targets=... # Cross-compile
core ci --we-are-go-for-launch # Publish release
# AI integration
core ai tasks # List available tasks
core ai task # Auto-select a task
core ai task:commit # Commit with task reference
core ai task:pr # Create PR for task
core ai task:complete # Mark task done
# Quality & security
core qa health # Aggregate CI health
core security alerts # All security alerts
core security deps # Dependabot alerts
core doctor # Check environment
```
### Missing Features?
If `core` doesn't have what you need:
1.**Raise an issue** on `host-uk/core` describing the feature
2.**Code as if it exists** - write the call you wish existed
3.**Write a TDD test** for the expected behaviour
4. The feature will get implemented and your code will work
This plugin is designed for use across the Host UK federated monorepo. It enforces the `core` CLI for multi-repo operations. See `/Users/snider/Code/host-uk/CLAUDE.md` for full monorepo documentation.
The `core` CLI source lives at `host-uk/core` - raise issues there for missing features.
