Repository navigation
Commit 1fea513
Add Opencode orchestration planning documentation with comprehensive concept analysis, integration architecture, and deep technical research (#2)
* Initial plan
* Add comprehensive Opencode orchestration planning documentation
- Create opencode-orchestration.md: Main architecture and strategy doc
- Create opencode-implementation-guide.md: Technical implementation details
- Create opencode-experiments.md: Validation experiments checklist
- Create opencode-decisions.md: Decision points and open questions
- Create opencode-index.md: Navigation hub for all Opencode docs
All documents are well-organized, cross-referenced, and avoid being giant
unmaintainable documents. Each serves a specific purpose with clear audience
and use cases. Includes discussion of options, areas requiring experimentation,
and tracking mechanisms for decisions and assumptions.
Co-authored-by: rothnic <[email protected]>
* Add quick start guide and update design directory README
- Create opencode-quickstart.md: One-page summary for fast onboarding
- Create/update design/README.md: Index all design docs including Opencode section
- Improve discoverability and navigation
Co-authored-by: rothnic <[email protected]>
* Add comprehensive Gastown concept analysis for Claude Code coupling
- Create opencode-concept-analysis.md: Analyzes all 23 Gastown concepts
- Identifies coupling levels: 13 concepts already runtime-agnostic
- Documents minimal abstractions needed: Update 5 manager files (~200-300 LOC)
- Provides priority list: Use runtime config everywhere (straightforward)
- Update opencode-index.md, opencode-quickstart.md, README.md to reference analysis
Key findings:
- Most concepts (Beads, Convoys, Molecules, etc.) already runtime-agnostic
- Runtime config abstraction already exists, just needs adoption
- Main work: Update agent managers to use runtime config instead of calling claude. directly
- Estimated effort: 1-2 weeks for core implementation + testing
Co-authored-by: rothnic <[email protected]>
* Add comprehensive Opencode integration architecture with research
- Create opencode-integration-architecture.md: Detailed Opencode research and integration strategy (30KB, 940 lines)
- Research findings: Opencode plugins, SDK, custom tools, agents, HTTP API, permissions
- Integration patterns: Core logic extraction + thin adapters for Claude/Opencode
- Concept-by-concept integration with code examples (Mayor, Polecat, Mail, Handoff, Convoy, Nudge)
- Plugin examples: gastown-mayor.js, gastown-polecat.js, gastown-mail.js, gastown-convoy.js
- Custom tool examples: mail.ts, convoy.ts, worktree.ts, seance.ts
- Multi-session orchestration via HTTP API for remote sessions
- Configuration management with layered opencode.json hierarchy
- 4-phase implementation roadmap with core logic extraction first
- Design principles: Extract core logic, create thin adapters, use plugins/tools to bridge
- Update opencode-index.md, opencode-quickstart.md, README.md to reference new architecture doc
Key insight: Opencode's plugin system, custom tools, and HTTP API provide natural integration
points. Extract Gastown core logic into runtime-agnostic modules, then create thin adapters
for both Claude (hooks) and Opencode (plugins/tools) that call the same core logic.
Co-authored-by: rothnic <[email protected]>
* Reorganize Opencode docs under docs/opencode/ with deep technical research
- Move all opencode documentation from docs/design/ to docs/opencode/
- Create docs/opencode/README.md: Comprehensive documentation index
- Create docs/opencode/technical-research.md: Deep dive into Opencode repository (21KB, 670 lines)
* Session forking (session/fork) from ACP draft spec with links to agentclientprotocol.com
* Configuration schema reference: https://opencode.ai/config.json
* ACP (Agent Client Protocol) integration details
* Plugin system internals with event catalog
* Custom tools architecture
* HTTP API endpoints and remote orchestration
* Research gaps identification (EXP-007, EXP-010, EXP-011, EXP-012)
- Update docs/design/README.md: Point to new docs/opencode/ location
Technical Research Findings:
- session/fork exists in ACP draft (UNSTABLE): https://agentclientprotocol.com/rfds/session-fork
- Issue #7978 documents ACP draft methods: anomalyco/opencode#7978
- Config schema at https://opencode.ai/config.json with layered hierarchy
- Plugin events: session.created, tool.execute.before/after, stop
- HTTP API for remote orchestration via /session endpoints
- Permissions with wildcards: "git *": "allow", "rm *": "deny"
All documentation now centralized in docs/opencode/ using Opencode GitHub repository as source of truth.
Co-authored-by: rothnic <[email protected]>
---------
Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: rothnic <[email protected]>1 parent 39f519e commit 1fea513
11 files changed
Lines changed: 6283 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | + | |
| 187 | + | |
| 188 | + | |
| 189 | + | |
| 190 | + | |
| 191 | + | |
| 192 | + | |
| 193 | + | |
| 194 | + | |
| 195 | + | |
| 196 | + | |
| 197 | + | |
| 198 | + | |
| 199 | + | |
| 200 | + | |
| 201 | + | |
0 commit comments