bf02ad0d5c
* refactor: Rename repository to OpenAgents Control Update all project references from "OpenAgents" to "OpenAgents Control": - Updated core config files (package.json, registry.json) - Updated documentation (README.md, docs/) - Updated scripts (install.sh, update.sh, test scripts) - Updated agent and command files - Updated integrations and packages - Updated all GitHub URLs to use OpenAgentsControl Naming convention: - Display name: "OpenAgents Control" - Repository URL: OpenAgentsControl * feat: Enable subagent-to-subagent delegation (ContextScout integration) Allow coding-related subagents to call ContextScout for context discovery: - CoderAgent: Can now discover coding standards on-demand - TestEngineer: Can now discover test coverage and TDD guidelines - CodeReviewer: Can now discover code review and security patterns - BuildAgent: Can now discover build validation standards - DocWriter: Can now discover documentation formatting guidelines Changes per subagent: - Added `task: true` to tools section - Added permission allowlist for ContextScout only (deny all other delegation) - Added Context Discovery workflow section with when-to-call guidance This enables subagents to be self-sufficient for finding relevant standards instead of relying on orchestrator to provide all context files. Benefits: - Subagents can discover what they need when context isn't explicit - Maintains security (only ContextScout allowed via task tool) - Follows existing patterns (uses task tool like main agents) * fix: Set OPENCODE_BRANCH in CI tests to use PR branch for downloads - Add OPENCODE_BRANCH environment variable to E2E tests - Add OPENCODE_BRANCH environment variable to profile smoke tests - Ensures tests download files from the PR branch instead of main - Fixes E2E test failures after repository rename to OpenAgentsControl
194 lines
4.6 KiB
Markdown
194 lines
4.6 KiB
Markdown
# Quick Start: System Builder
|
|
|
|
## 🎯 What is System Builder?
|
|
|
|
An **interactive AI system generator** that creates complete `.opencode` architectures tailored to your domain.
|
|
|
|
**Input:** Your requirements (via interview)
|
|
**Output:** Complete AI system with agents, context, workflows, and commands
|
|
|
|
---
|
|
|
|
## 📦 Installation
|
|
|
|
### For Developers Who Want System Builder
|
|
|
|
```bash
|
|
# Install Advanced profile (includes system builder)
|
|
curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced
|
|
```
|
|
|
|
**What you get:**
|
|
- ✅ All development tools (19 components)
|
|
- ✅ Business tools (5 components)
|
|
- ✅ System builder (7 components)
|
|
- ✅ Additional tools (1 component)
|
|
- ✅ **Total: 32 components**
|
|
|
|
---
|
|
|
|
### Add to Existing Installation
|
|
|
|
Already have `developer` or `full` profile? Add system builder:
|
|
|
|
```bash
|
|
# Run advanced profile
|
|
curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced
|
|
|
|
# When prompted about collisions:
|
|
# Choose: 1) Skip existing
|
|
|
|
# Result: Only system-builder components added
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Usage
|
|
|
|
### Step 1: Run the Command
|
|
```bash
|
|
/build-context-system
|
|
```
|
|
|
|
### Step 2: Answer Interview Questions
|
|
|
|
**Phase 1: Domain & Purpose**
|
|
- What's your domain? (e-commerce, data engineering, etc.)
|
|
- What's the purpose? (automate tasks, coordinate workflows, etc.)
|
|
- Who are the users? (developers, business users, etc.)
|
|
|
|
**Phase 2: Use Cases**
|
|
- What are your top 3-5 use cases?
|
|
- What's the complexity? (simple/moderate/complex)
|
|
- Any dependencies between tasks?
|
|
|
|
**Phase 3: Complexity & Scale**
|
|
- How many specialized agents needed?
|
|
- What types of knowledge? (domain/process/standards/templates)
|
|
- State management needs?
|
|
|
|
**Phase 4: Integrations**
|
|
- External tools/APIs?
|
|
- File operations?
|
|
- Custom commands needed?
|
|
|
|
**Phase 5: Review & Confirm**
|
|
- Review architecture summary
|
|
- Confirm or revise
|
|
- Generate system
|
|
|
|
### Step 3: Get Your Custom System
|
|
|
|
**Generated structure:**
|
|
```
|
|
.opencode/
|
|
├── agent/
|
|
│ ├── {your-domain}-orchestrator.md # Main coordinator
|
|
│ └── subagents/
|
|
│ ├── {specialist-1}.md
|
|
│ ├── {specialist-2}.md
|
|
│ └── {specialist-3}.md
|
|
├── context/
|
|
│ ├── domain/ # Your domain knowledge
|
|
│ ├── processes/ # Your workflows
|
|
│ ├── standards/ # Quality rules
|
|
│ └── templates/ # Reusable patterns
|
|
├── workflows/
|
|
│ ├── {workflow-1}.md
|
|
│ └── {workflow-2}.md
|
|
├── command/
|
|
│ ├── /{custom-command-1}.md
|
|
│ └── /{custom-command-2}.md
|
|
└── README.md # Usage guide
|
|
```
|
|
|
|
---
|
|
|
|
## 💡 Use Cases
|
|
|
|
### For Developers
|
|
```bash
|
|
/build-context-system
|
|
|
|
Domain: Software Development
|
|
Purpose: Automate code review and testing
|
|
Result: Custom dev workflow system
|
|
```
|
|
|
|
### For Business Users
|
|
```bash
|
|
/build-context-system
|
|
|
|
Domain: Customer Support
|
|
Purpose: Automate ticket routing and responses
|
|
Result: Custom support automation system
|
|
```
|
|
|
|
### For Data Teams
|
|
```bash
|
|
/build-context-system
|
|
|
|
Domain: Data Engineering
|
|
Purpose: Automate ETL pipelines and validation
|
|
Result: Custom data pipeline system
|
|
```
|
|
|
|
### For Content Teams
|
|
```bash
|
|
/build-context-system
|
|
|
|
Domain: Content Marketing
|
|
Purpose: Generate and schedule content
|
|
Result: Custom content workflow system
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Components Installed
|
|
|
|
When you install **advanced** profile, you get:
|
|
|
|
**System Builder Components:**
|
|
1. `system-builder` (agent) - Main orchestrator
|
|
2. `domain-analyzer` (subagent) - Analyzes domains
|
|
3. `agent-generator` (subagent) - Creates agents
|
|
4. `context-organizer` (subagent) - Organizes context
|
|
5. `workflow-designer` (subagent) - Designs workflows
|
|
6. `command-creator` (subagent) - Creates commands
|
|
7. `build-context-system` (command) - Interactive interface
|
|
|
|
**Plus all development tools:**
|
|
- openagent, task-manager, opencoder
|
|
- All core subagents (reviewer, tester, etc.)
|
|
- All development commands
|
|
- Tools and plugins
|
|
|
|
---
|
|
|
|
## 📚 Learn More
|
|
|
|
- **Full Documentation**: [README.md](README.md)
|
|
- **Detailed Guide**: [guide.md](guide.md)
|
|
- **Architecture Details**: `.opencode/agent/system-builder.md`
|
|
- **Command Reference**: `.opencode/command/build-context-system.md`
|
|
|
|
---
|
|
|
|
## ✅ Summary
|
|
|
|
**Installation:**
|
|
```bash
|
|
curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s advanced
|
|
```
|
|
|
|
**Usage:**
|
|
```bash
|
|
/build-context-system
|
|
```
|
|
|
|
**Result:**
|
|
Complete custom AI system tailored to your domain! 🎉
|
|
|
|
---
|
|
|
|
**Ready to build your own AI system?** Install advanced profile and run `/build-context-system`!
|