diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..0df9ef4 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,35 @@ +{ + "name": "oac-marketplace", + "description": "OpenAgents Control - Multi-agent orchestration and automation plugins", + "owner": { + "name": "NextSystems", + "url": "https://github.com/darrenhinde/OpenAgentsControl" + }, + "plugins": [ + { + "name": "oac", + "source": "./claude-plugin", + "description": "Multi-agent orchestration and automation for Claude Code. Provides intelligent code review, testing, documentation, and task management capabilities.", + "version": "1.0.0", + "tags": [ + "agents", + "automation", + "orchestration", + "development", + "testing", + "code-review", + "documentation" + ], + "author": "NextSystems", + "license": "MIT", + "repository": "https://github.com/darrenhinde/OpenAgentsControl" + } + ], + "categories": [ + { + "name": "Development Tools", + "description": "Tools for software development and automation", + "plugins": ["oac"] + } + ] +} diff --git a/claude-plugin/.claude-plugin/plugin.json b/claude-plugin/.claude-plugin/plugin.json new file mode 100644 index 0000000..391c8c6 --- /dev/null +++ b/claude-plugin/.claude-plugin/plugin.json @@ -0,0 +1,19 @@ +{ + "name": "oac", + "description": "OpenAgents Control - Multi-agent orchestration and automation for Claude Code", + "version": "1.0.0", + "author": "NextSystems", + "license": "MIT", + "repository": "https://github.com/darrenhinde/OpenAgentsControl", + "tags": [ + "agents", + "automation", + "orchestration", + "development", + "testing", + "code-review" + ], + "compatibility": { + "claude": ">=1.0.0" + } +} diff --git a/claude-plugin/INSTALL.md b/claude-plugin/INSTALL.md new file mode 100644 index 0000000..bfb23cc --- /dev/null +++ b/claude-plugin/INSTALL.md @@ -0,0 +1,102 @@ +# OAC Plugin - Installation Guide + +Quick guide to install and test the OAC (OpenAgents Control) plugin for Claude Code. + +## πŸš€ Quick Install + +### Method 1: From GitHub (After Push) + +```bash +# Add the marketplace +/plugin marketplace add darrenhinde/OpenAgentsControl + +# Install the plugin +/plugin install oac + +# Verify it works +/oac:hello +``` + +### Method 2: Local Development (Now) + +```bash +# Navigate to the repo +cd /path/to/OpenAgentsControl + +# Start Claude with the plugin +claude --plugin-dir ./claude-plugin + +# In Claude Code, test the plugin +/oac:hello +``` + +## πŸ“‹ Verification Steps + +After installation, verify everything works: + +1. **Check plugin is loaded**: + ```bash + /plugin list + ``` + You should see "oac" in the list. + +2. **Test the hello skill**: + ```bash + /oac:hello + ``` + You should get a friendly response confirming the plugin is working. + +3. **Check available commands**: + ```bash + /help + ``` + Look for `/oac:*` commands. + +## πŸ”§ Troubleshooting + +### Plugin not found +- Make sure you're in the correct directory +- Check that `claude-plugin/.claude-plugin/plugin.json` exists +- Verify the symlink: `ls -la claude-plugin/context` + +### Skill not working +- Check the skill file exists: `claude-plugin/skills/hello/SKILL.md` +- Restart Claude Code +- Try: `claude --plugin-dir ./claude-plugin --verbose` + +### Context not loading +- Verify symlink: `cd claude-plugin && ls -la context` +- Should point to: `../.opencode/context` +- Check context files exist: `ls .opencode/context/` + +## πŸ“¦ What Gets Installed + +When you install the plugin, Claude Code copies: + +``` +~/.claude/plugins/cache/oac/ +β”œβ”€β”€ .claude-plugin/plugin.json +β”œβ”€β”€ skills/hello/SKILL.md +β”œβ”€β”€ context/ (symlink content) +β”œβ”€β”€ agents/ (empty for now) +β”œβ”€β”€ hooks/ (empty for now) +└── commands/ (empty for now) +``` + +## 🎯 Next Steps + +After successful installation: + +1. **Explore the context**: The plugin has access to all OpenAgents Control context files +2. **Wait for more skills**: Code review, testing, documentation skills coming soon +3. **Contribute**: Add your own skills to `claude-plugin/skills/` + +## πŸ†˜ Need Help? + +- **Issues**: https://github.com/darrenhinde/OpenAgentsControl/issues +- **Discussions**: https://github.com/darrenhinde/OpenAgentsControl/discussions + +--- + +**Version**: 1.0.0 +**Last Updated**: 2026-02-16 diff --git a/claude-plugin/QUICK-START.md b/claude-plugin/QUICK-START.md new file mode 100644 index 0000000..5d51012 --- /dev/null +++ b/claude-plugin/QUICK-START.md @@ -0,0 +1,180 @@ +# OAC Plugin - Quick Start + +**Status**: βœ… Ready to test locally +**Version**: 1.0.0 +**Date**: 2026-02-16 + +--- + +## βœ… What's Been Created + +``` +OpenAgentsControl/ +β”œβ”€β”€ .claude-plugin/ +β”‚ └── marketplace.json # Marketplace catalog +β”‚ +└── claude-plugin/ + β”œβ”€β”€ .claude-plugin/ + β”‚ └── plugin.json # Plugin manifest (name: "oac") + β”œβ”€β”€ skills/ + β”‚ └── hello/ + β”‚ └── SKILL.md # Test skill + β”œβ”€β”€ agents/ # (empty - ready for future agents) + β”œβ”€β”€ hooks/ # (empty - ready for future hooks) + β”œβ”€β”€ commands/ # (empty - ready for future commands) + β”œβ”€β”€ context -> ../.opencode/context/ # Symlink to shared context + β”œβ”€β”€ README.md # Full documentation + β”œβ”€β”€ INSTALL.md # Installation guide + └── QUICK-START.md # This file +``` + +--- + +## πŸš€ Test It Now (Local) + +```bash +# 1. Make sure you're in the repo root +cd /path/to/OpenAgentsControl + +# 2. Start Claude with the plugin +claude --plugin-dir ./claude-plugin + +# 3. In Claude Code, test the plugin +/oac:hello +``` + +**Expected output**: A friendly message confirming the OAC plugin is working. + +--- + +## πŸ“¦ Publish to GitHub (Next Step) + +Once you've tested locally and it works: + +```bash +# 1. Add the files +git add claude-plugin/ .claude-plugin/ + +# 2. Commit +git commit -m "feat: add Claude Code plugin (OAC)" + +# 3. Push +git push origin main + +# 4. Users can then install via marketplace +# /plugin marketplace add darrenhinde/OpenAgentsControl +# /plugin install oac +``` + +--- + +## 🎯 Available Commands (After Install) + +- `/oac:hello` - Test skill to verify plugin is working + +--- + +## πŸ”œ Coming Soon + +### Skills to Add +- `/oac:code-review` - Intelligent code review +- `/oac:test` - TDD-driven test creation +- `/oac:docs` - Documentation generation +- `/oac:task-breakdown` - Feature decomposition +- `/oac:context-scout` - Smart context discovery + +### Hooks to Add +- Auto-format on file write +- Auto-commit after changes +- Test runner on save +- Documentation sync + +### Agents to Add +- Code Reviewer +- Test Engineer +- Doc Writer +- Task Manager + +--- + +## πŸ“ How to Add More Skills + +1. **Create skill directory**: + ```bash + mkdir -p claude-plugin/skills/my-skill + ``` + +2. **Create SKILL.md**: + ```markdown + # My Skill + + Description of what this skill does. + + ```claude + You are a helpful assistant that... + ``` + ``` + +3. **Test it**: + ```bash + claude --plugin-dir ./claude-plugin + /oac:my-skill + ``` + +4. **Commit and push**: + ```bash + git add claude-plugin/skills/my-skill/ + git commit -m "feat: add my-skill to OAC plugin" + git push + ``` + +--- + +## πŸ”— Key Files + +| File | Purpose | +|------|---------| +| `claude-plugin/.claude-plugin/plugin.json` | Plugin metadata (name, version, etc.) | +| `claude-plugin/skills/*/SKILL.md` | Skill definitions | +| `claude-plugin/context` | Symlink to shared context | +| `.claude-plugin/marketplace.json` | Marketplace catalog | + +--- + +## πŸ†˜ Troubleshooting + +### "Plugin not found" +- Check you're in the repo root +- Verify: `ls claude-plugin/.claude-plugin/plugin.json` + +### "Skill not working" +- Check: `ls claude-plugin/skills/hello/SKILL.md` +- Restart Claude Code + +### "Context not loading" +- Verify symlink: `ls -la claude-plugin/context` +- Should show: `context -> ../.opencode/context` + +--- + +## πŸ“š Documentation + +- **Full README**: `claude-plugin/README.md` +- **Installation Guide**: `claude-plugin/INSTALL.md` +- **Main Repo Docs**: `.opencode/docs/` +- **Planning Docs**: `docs/planning/` + +--- + +## βœ… Next Steps + +1. **Test locally** (see above) +2. **Add more skills** (code-review, test, docs) +3. **Push to GitHub** +4. **Share with users** + +--- + +**Ready to test!** πŸŽ‰ + +Run: `claude --plugin-dir ./claude-plugin` and then `/oac:hello` diff --git a/claude-plugin/README.md b/claude-plugin/README.md new file mode 100644 index 0000000..f314754 --- /dev/null +++ b/claude-plugin/README.md @@ -0,0 +1,169 @@ +# OAC - Claude Code Plugin + +OpenAgents Control (OAC) - Multi-agent orchestration and automation for Claude Code. + +## 🎯 Overview + +OpenAgents Control brings powerful multi-agent capabilities to Claude Code, including: + +- **Intelligent Code Review** - Automated code quality and security analysis +- **Test Engineering** - TDD-driven test creation and validation +- **Documentation** - Automated documentation generation and maintenance +- **Task Management** - Break down complex features into manageable tasks +- **Context Discovery** - Smart context file discovery and loading + +## πŸ“¦ Installation + +### Option 1: From Marketplace (Recommended) + +```bash +# Add the OpenAgents Control marketplace +/plugin marketplace add darrenhinde/OpenAgentsControl + +# Install the plugin +/plugin install oac +``` + +### Option 2: Local Development + +```bash +# Clone the repo +git clone https://github.com/darrenhinde/OpenAgentsControl.git +cd OpenAgentsControl + +# Load plugin locally +claude --plugin-dir ./claude-plugin +``` + +## πŸš€ Quick Start + +After installation, test the plugin: + +```bash +# Verify installation +/oac:hello +``` + +## πŸ“š Available Skills + +### Current Skills + +- **hello** - Test skill to verify plugin installation + +### Coming Soon + +- **code-review** - Intelligent code review with security and quality checks +- **test-engineer** - TDD-driven test creation +- **doc-writer** - Documentation generation +- **task-breakdown** - Feature decomposition into tasks +- **context-scout** - Smart context discovery + +## πŸ”§ Configuration + +The plugin uses shared context from the main OpenAgents Control repository via symlinks. + +### Context Structure + +``` +claude-plugin/ +β”œβ”€β”€ .claude-plugin/plugin.json +β”œβ”€β”€ skills/ # Claude-specific skills +β”œβ”€β”€ agents/ # Claude-specific agents +β”œβ”€β”€ hooks/ # Event-driven automation +β”œβ”€β”€ commands/ # Custom slash commands +└── context -> ../.opencode/context/ # Symlinked shared context +``` + +## πŸ› οΈ Development + +### Adding New Skills + +1. Create skill directory: + ```bash + mkdir -p claude-plugin/skills/my-skill + ``` + +2. Create `SKILL.md`: + ```markdown + # My Skill + + Description of what this skill does. + + ```claude + You are a helpful assistant that... + ``` + ``` + +3. Test locally: + ```bash + claude --plugin-dir ./claude-plugin + /oac:my-skill + ``` + +### Adding Hooks + +Create `hooks/hooks.json`: + +```json +{ + "hooks": { + "PostToolUse": [{ + "matcher": "Write|Edit", + "hooks": [{ + "type": "command", + "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format.sh", + "timeout": 30 + }] + }] + } +} +``` + +## πŸ”— Related Projects + +- **OpenAgents Control** - Main repository (OpenCode native) +- **OAC CLI** - Command-line tool for multi-IDE management (coming soon) + +## πŸ“– Documentation + +- [Main Documentation](../.opencode/docs/) +- [Context System](../docs/context-system/) +- [Planning Documents](../docs/planning/) + +## 🀝 Contributing + +Contributions welcome! See the main [OpenAgents Control repository](https://github.com/darrenhinde/OpenAgentsControl) for contribution guidelines. + +## πŸ“„ License + +MIT License - see [LICENSE](../LICENSE) for details. + +## πŸ†˜ Support + +- **Issues**: [GitHub Issues](https://github.com/darrenhinde/OpenAgentsControl/issues) +- **Discussions**: [GitHub Discussions](https://github.com/darrenhinde/OpenAgentsControl/discussions) + +## πŸ—ΊοΈ Roadmap + +### Phase 1: Foundation (Current) +- βœ… Plugin structure +- βœ… Marketplace catalog +- βœ… Test skill +- ⬜ Core skills (code-review, test-engineer, doc-writer) + +### Phase 2: Advanced Features +- ⬜ Hooks for automation +- ⬜ MCP server integration +- ⬜ Custom commands +- ⬜ Agent delegation + +### Phase 3: JSON Config System +- ⬜ Auto-generation from JSON config +- ⬜ Type-safe configuration +- ⬜ Multi-IDE conversion + +--- + +**Version**: 1.0.0 +**Last Updated**: 2026-02-16 +**Status**: Active Development diff --git a/claude-plugin/context b/claude-plugin/context new file mode 120000 index 0000000..fd8f278 --- /dev/null +++ b/claude-plugin/context @@ -0,0 +1 @@ +../.opencode/context \ No newline at end of file diff --git a/claude-plugin/skills/hello/SKILL.md b/claude-plugin/skills/hello/SKILL.md new file mode 100644 index 0000000..08c1d90 --- /dev/null +++ b/claude-plugin/skills/hello/SKILL.md @@ -0,0 +1,15 @@ +# Hello + +A simple test skill to verify OpenAgents Control plugin is working. + +```claude +You are a helpful assistant from the OpenAgents Control plugin. + +When invoked, you should: +1. Confirm that the OpenAgents Control plugin is successfully installed and working +2. Briefly explain what OpenAgents Control provides (multi-agent orchestration, automation, code review, testing) +3. List a few example commands users can try (once more skills are added) +4. Be friendly and encouraging + +Keep your response concise (2-3 sentences). +```