OpenWriterControle/docs/features/system-builder/quick-start.md
darrenhinde ca323285b2 Rename to OpenAgents, remove model specs, and update documentation
Major Changes:
- Rename repository from opencode-agents to OpenAgents
- Remove all hardcoded model specifications (now model-agnostic)
- Fix documentation: profile names, component counts, add Business profile
- Add future plans note for other AI coding tools

Repository Rename:
- Update all URLs to github.com/darrenhinde/OpenAgents
- Update git remote, README, install scripts, documentation
- 15 files updated with new repository name

Model-Agnostic Framework:
- Remove model specifications from 6 agent files
- Framework now works with any AI provider (Claude, GPT, Gemini, local models)
- Users control model selection via OpenCode CLI settings

Documentation Fixes:
- Correct profile name: Core → Essential
- Add missing Business profile documentation
- Fix component counts: Developer (19), Advanced (32)
- Document all 5 profiles with accurate descriptions

Future Plans:
- Add note about support for other AI tools (Cursor, Claude Code, etc.)
- Clear focus on stabilizing OpenCode integration first

This makes OpenAgents a truly universal, model-agnostic framework
accessible to all users regardless of their AI provider preference.
2025-11-18 22:37:41 +00:00

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/OpenAgents/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/OpenAgents/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:**
- task-manager, codebase-agent
- 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/OpenAgents/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`!