FINAL-ARCHITECTURE-DECISION.md 2.3 KB
NexusAgent - Final Architecture Decision
Date: 2025-10-29
Status: APPROVED FOR BUILD
Decision: OpenCode-First with Shareable Core
The Decision
Build for OpenCode primarily, make context shareable secondarily.
What This Means
.opencode/ # PRIMARY - Full NexusAgent for OpenCode
├── agent/ # OpenCode agents (full support)
├── command/ # OpenCode commands (full support)
├── context/ # SHAREABLE - other tools can read
└── governance/ # SHAREABLE - other tools can read
OpenCode: Full feature support, all profiles, complete integration
Other Tools: Can read shared context/governance if compatible (user configures)
Why This Approach
- Focus: 95% effort on making OpenCode experience perfect
- Simple: No multi-tool maintenance burden
- Flexible: Context naturally shareable (markdown + JSON)
- Clean: Standard OpenCode structure
- Optional: Users can bridge to other tools via shared context
What We Build
Core System (OpenCode)
- ✅ Installation scripts
- ✅ Three profiles (default, governance, content)
- ✅ Full agent system
- ✅ Context-aware orchestration
- ✅ Data governance system
- ✅ Complete documentation
Optional Helpers
- ✅ Bridge scripts (cursor, claude, aider)
- ✅ Integration examples
- ✅ User can adapt as needed
What We Don't Build
- ❌ Full Cursor integration
- ❌ Full Claude integration
- ❌ Multiple maintained versions
- ❌ Complex adapter system
Repository Structure
nextsystems/nexus/
├── scripts/
│ ├── install.sh # Main installer
│ └── optional/
│ └── bridge-*.sh # Optional bridges
├── profiles/
│ ├── default/
│ ├── governance/
│ └── content/
└── docs/
├── opencode-usage.md # Primary docs
└── optional/
└── *-integration.md # Examples
Next: Start Building
Now that architecture is finalized, let's build:
- Create GitHub repository
- Build installation scripts
- Build default profile
- Build governance profile
- Build content profile
- Test & document
- Launch!
Estimated: 6 weeks to v1.0