b633ae81f6
README.md: - GitHub-friendly documentation - Installation instructions - Plugin overview with commands review plugin: - /review:security - Security-focused review - /review:pr - PR review - hooks.json - Post PR create suggestion - scripts/post-pr-create.sh verify plugin: - /verify:ready - Quick readiness check - /verify:tests - Test verification - hooks.json - Pre-push warning - scripts/pre-push-check.sh qa plugin: - /qa:check - Report only, no fixes - /qa:lint - Lint with fix option - hooks.json - QA output filtering ci plugin: - /ci:status - CI status display - /ci:run - Trigger workflows - /ci:fix - Analyse and fix failures - hooks.json - Post-push CI hint - scripts/post-push-ci.sh Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
119 lines
2.9 KiB
Markdown
119 lines
2.9 KiB
Markdown
# core-agent
|
|
|
|
A monorepo of [Claude Code](https://claude.ai/code) plugins for the Host UK federated monorepo.
|
|
|
|
## Plugins
|
|
|
|
| Plugin | Description | Commands |
|
|
|--------|-------------|----------|
|
|
| **[code](./claude/code)** | Core development - hooks, scripts, data collection | `/code:remember`, `/code:yes` |
|
|
| **[review](./claude/review)** | Code review automation | `/review:review`, `/review:security`, `/review:pr` |
|
|
| **[verify](./claude/verify)** | Work verification before commit/push | `/verify:verify`, `/verify:ready` |
|
|
| **[qa](./claude/qa)** | Quality assurance fix loops | `/qa:qa`, `/qa:fix`, `/qa:check` |
|
|
| **[ci](./claude/ci)** | CI/CD integration | `/ci:ci`, `/ci:workflow`, `/ci:fix` |
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
# Install all plugins via marketplace
|
|
claude plugin add host-uk/core-agent
|
|
|
|
# Or install individual plugins
|
|
claude plugin add host-uk/core-agent/claude/code
|
|
claude plugin add host-uk/core-agent/claude/review
|
|
claude plugin add host-uk/core-agent/claude/qa
|
|
```
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Code review staged changes
|
|
/review:review
|
|
|
|
# Run QA and fix all issues
|
|
/qa:qa
|
|
|
|
# Verify work is ready to commit
|
|
/verify:verify
|
|
|
|
# Check CI status
|
|
/ci:ci
|
|
```
|
|
|
|
## Core CLI Integration
|
|
|
|
These plugins enforce the `core` CLI for development commands:
|
|
|
|
| Instead of... | Use... |
|
|
|---------------|--------|
|
|
| `go test` | `core go test` |
|
|
| `go build` | `core build` |
|
|
| `golangci-lint` | `core go lint` |
|
|
| `composer test` | `core php test` |
|
|
| `./vendor/bin/pint` | `core php fmt` |
|
|
|
|
## Plugin Details
|
|
|
|
### code
|
|
|
|
The core plugin with hooks and data collection skills:
|
|
|
|
- **Hooks**: Auto-format, debug detection, dangerous command blocking
|
|
- **Skills**: Data collection for archiving OSS projects (whitepapers, forums, market data)
|
|
- **Commands**: `/code:remember` (persist facts), `/code:yes` (auto-approve mode)
|
|
|
|
### review
|
|
|
|
Code review automation:
|
|
|
|
- `/review:review` - Review staged changes or commit range
|
|
- `/review:security` - Security-focused review
|
|
- `/review:pr [number]` - Review a pull request
|
|
|
|
### verify
|
|
|
|
Work verification:
|
|
|
|
- `/verify:verify` - Full verification (tests, lint, format, debug check)
|
|
- `/verify:ready` - Quick check if ready to commit
|
|
|
|
### qa
|
|
|
|
Quality assurance:
|
|
|
|
- `/qa:qa` - Run QA pipeline, fix all issues iteratively
|
|
- `/qa:fix <issue>` - Fix a specific issue
|
|
- `/qa:check` - Check without fixing
|
|
|
|
### ci
|
|
|
|
CI/CD integration:
|
|
|
|
- `/ci:ci` - Check CI status
|
|
- `/ci:workflow <type>` - Generate GitHub Actions workflow
|
|
- `/ci:fix` - Analyse and fix failing CI
|
|
|
|
## Development
|
|
|
|
### Adding a new plugin
|
|
|
|
1. Create `claude/<name>/.claude-plugin/plugin.json`
|
|
2. Add commands to `claude/<name>/commands/`
|
|
3. Add hooks to `claude/<name>/hooks.json` (optional)
|
|
4. Register in `.claude-plugin/marketplace.json`
|
|
|
|
### Testing locally
|
|
|
|
```bash
|
|
claude plugin add /path/to/core-agent
|
|
```
|
|
|
|
## License
|
|
|
|
EUPL-1.2
|
|
|
|
## Links
|
|
|
|
- [Host UK](https://host.uk.com)
|
|
- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
|
|
- [Issues](https://github.com/host-uk/core-agent/issues)
|