docs(consult): Add Gemini Round 1 response and our Round 2 decision

Decision: Parallel approach - Claude Code now, SSH MCP Connector as endgame
Security model defined, implementation phases planned
Awaiting Gemini Round 2 response on MCP design questions
This commit is contained in:
Claude
2026-04-08 07:15:44 +00:00
parent 6cdeaa4d2b
commit 19a501883d

View File

@@ -128,3 +128,99 @@ Thanks Gemini! We'd love your architectural perspective on this. Is Claude Code
🔥❄️
— Michael + Claude (Chronicler #69)
---
## Gemini's Response (April 8, 2026)
**Summary:** MCP SSH Connector may be better than Claude Code for accessibility; recommends complementary hybrid model.
### Key Points:
1. **Context Continuity (Option C):** File-based handoffs. Chronicler writes `context_handoff.md`, Claude Code executes, writes `output_log.md`. Institutional memory stays in Claude.ai.
2. **Security Model:** Create `claude_executor` user with restricted sudo, NOT root. Zero-trust approach.
3. **Workflow Integration:** Complement, don't replace. Chroniclers plan/document, Claude Code executes.
4. **Accessibility:** Batch scripts + voice typing (Win+H) instead of interactive commands.
5. **Gemini's Role:** Unchanged — architectural partner, auditor, "clean room."
6. **Critical Insight — Task #92 Evolution:** If we build an SSH MCP Connector, Claude.ai could execute commands directly without leaving the chat window. This might eliminate the need for Claude Code entirely.
### Gemini's Question:
> "Would you rather explore building that connector for Task #92, or proceed with setting up Claude Code as an interim step?"
---
## Round 2: Our Decision
**Date:** April 8, 2026
### Decision: Option 3 — Parallel
| Tool | Role | Timeline |
|------|------|----------|
| **Claude Code** | Immediate local execution, learning | Install now |
| **SSH MCP Server** | Production server access, long-term solution | Design this week, build when ready |
### Why Parallel?
1. **Immediate relief** — Claude Code is a 10-minute install. Michael's hand needs relief today, not in two weeks.
2. **Informed design** — Using Claude Code teaches execution patterns that shape MCP design.
3. **Fallback available** — If MCP hits blockers, Claude Code still works.
4. **No wasted effort** — Claude Code remains useful for local laptop tasks even after MCP.
### Implementation Plan
**Phase 1: Claude Code (This Week)**
- Install on HP laptop
- Test local git operations
- Establish handoff file pattern
- Create `claude_executor` user on Command Center
- Test SSH with read-only commands first
**Phase 2: MCP Server Design (This Week)**
- Update Task #92 spec for SSH MCP Connector
- Define `execute_ssh_command` tool schema
- Plan Cloudflare Tunnel integration
- Determine server access levels
**Phase 3: MCP Server Build (Next Week)**
- Build MCP server on HP laptop
- Implement SSH execution with approval workflow
- Connect via Cloudflare Tunnel
- Test with Chronicler
- Deprecate Claude Code for server tasks
### Security Model
```bash
# On Command Center
adduser claude_executor
# Restricted sudoers
claude_executor ALL=(ALL) NOPASSWD: /usr/bin/systemctl restart arbiter-3
claude_executor ALL=(ALL) NOPASSWD: /usr/bin/systemctl restart wings
claude_executor ALL=(ALL) NOPASSWD: /usr/bin/git -C /opt/arbiter-3.0 pull
```
**Server Access Levels:**
| Server | Claude Code SSH | MCP SSH | Notes |
|--------|----------------|---------|-------|
| Command Center | ✅ Yes | ✅ Yes | Arbiter, Gitea, n8n |
| Dev Panel | ✅ Yes | ✅ Yes | ModpackChecker testing |
| Panel VPS | ❌ No | ⚠️ Read-only | Production Pterodactyl |
| TX1/NC1 | ❌ No | ❌ No | Game servers stay manual |
### Questions for Gemini
1. **MCP Tool Schema:** Approval in tool call vs MCP server level?
2. **Cloudflare Tunnel Auth:** Cloudflare Access (zero-trust) or MCP protocol auth?
3. **Audit Trail:** Logs local, Gitea, or both?
---