OpenWriterControle/docs/features/system-builder/quick-start.md
darrenhinde 5f2cec1404 ✨ feat: introduce OpenAgent universal agent with session management
Major architectural refactoring:

- Add OpenAgent as universal primary agent for questions, tasks, and workflows
- Implement session-based context management with manifest tracking
- Reorganize subagents into logical categories (code/core/utils)
- Add dynamic context discovery and loading system
- Introduce cleanup script for stale sessions
- Update registry with new categorization (essential/standard/extended/specialized/meta)
- Rename 'core' profile to 'essential' and add 'business' profile
- Add comprehensive documentation with visual diagrams
- Update installation script with new profiles

Breaking changes:
- Subagent paths changed from analysis/core to code/core/utils
- Profile 'core' renamed to 'essential' (backward compatible)

New features:
- Session isolation for concurrent agent instances (.tmp/sessions/)
- Automatic stale session cleanup (>24 hours)
- Manifest-based context indexing and discovery
- Business profile for content-focused workflows
- OpenAgent with plan-approve-execute-validate-summarize workflow

Components: 32 total (3 agents, 13 subagents, 8 commands, 2 tools, 2 plugins, 2 contexts, 2 config)

Documentation:
- docs/agents/openagent.md - Comprehensive guide with Mermaid diagrams
- docs/guides/building-with-opencode.md - Power user formula
- scripts/README.md - Script documentation
- .opencode/context/core/context-management.md - Session management strategy
2025-11-18 18:45:42 +00:00

4.6 KiB

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

# Install Advanced profile (includes system builder)
curl -fsSL https://raw.githubusercontent.com/darrenhinde/opencode-agents/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:

# Run advanced profile
curl -fsSL https://raw.githubusercontent.com/darrenhinde/opencode-agents/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

/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

/build-context-system

Domain: Software Development
Purpose: Automate code review and testing
Result: Custom dev workflow system

For Business Users

/build-context-system

Domain: Customer Support
Purpose: Automate ticket routing and responses
Result: Custom support automation system

For Data Teams

/build-context-system

Domain: Data Engineering
Purpose: Automate ETL pipelines and validation
Result: Custom data pipeline system

For Content Teams

/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
  • Detailed Guide: guide.md
  • Architecture Details: .opencode/agent/system-builder.md
  • Command Reference: .opencode/command/build-context-system.md

✅ Summary

Installation:

curl -fsSL https://raw.githubusercontent.com/darrenhinde/opencode-agents/main/install.sh | bash -s advanced

Usage:

/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!