Architecture: How to fix session/git/MCP inconsistency across all agent pl...

Documentation for Sessions

🏗️ Architecture: How to fix session/git/MCP inconsistency across all agent pl...

Date: 2026-03-08
Time: 16:31:12 UTC
Session: gspace1-193.2
Agent: documentation
Confidence: 95%
Status: ✅ Documented

📋 Decision Context

Question:

How to fix session/git/MCP inconsistency across all agent platforms (Cursor, Claude Code, Vitto, Cowork)?

Task: Not specified

🎯 Decision Made

Chosen:

4-phase approach: (1) Fix critical misconfigs (MCP path, platform detection, branch naming), (2) Achieve Claude Code parity with Cursor (commands, hooks), (3) Automate friction points (auto-manifest, stale cleanup, branch alignment), (4) Create unified agent onboarding protocol for all platforms including Vitto and Cowork as first-class types

Options Considered:

Fix only the MCP path and leave the rest as-is
Full rewrite of session system from scratch
4-phase incremental approach fixing root causes and adding automation

💭 Reasoning

Root causes identified: .claude/mcp.json pointed to wrong workspace (editor2 instead of gspace1), start-server.sh unconditionally set CURSOR_AGENT=true overriding CLAUDE_CODE_AGENT, preflight.ts expected workspace-prefixed branch names while SAGP says session-{N}, 163 stale branches with no cleanup mechanism, Claude Code had zero commands/hooks/rules while Cursor had full setup. Fix all root causes rather than symptoms. Add Vitto and Cowork as platform types since the goal is for Vitto to execute full sessions autonomously from the platform.

📁 Files Involved

.claude/mcp.json
.claude/settings.json
.claude/commands/session.md
.claude/hooks/session-check.sh
CLAUDE.md
AGENTS.md
MCP/mcp-gograb-ai/start-server.sh
MCP/mcp-gograb-ai/src/tools/preflight.ts
MCP/mcp-gograb-ai/src/session/session-detector.ts
MCP/mcp-gograb-ai/src/types/index.ts
MCP/mcp-gograb-ai/src/storage/docs-data-integration.ts
sessions/schemas/session-manifest.schema.json
tools/scripts/database/session-manager.js
package.json
docs/english/AI/architecture/UNIFIED-AGENT-PROTOCOL.md

🔗 Related

Decision ID: dev_1772987472705_2ydtms2
Session: 193
Workspace: gspace1

Auto-generated by MCP Smart Consolidation