📄 mono-repo-migration-briefing.md 2,502 bytes Apr 20, 2026 📋 Raw

Mono-Repo Migration Briefing

From: Matt (Director)
To: Socrates 🧠
Phase: 2 — The Consolidation

Context

Wadsworth completed Phase 1 (The Purge). Dreaming files removed from git tracking, .gitignore in place. We are now migrating to Option A: Mono-repo structure.

Your Tasks (Phase 2: The Consolidation)

1. Create New Directory Structure

Create: ~/hoffdesk-agents/ with these subdirectories:

~/hoffdesk-agents/
├── agents/
│   ├── wadsworth/
│   ├── socrates/
│   └── daedalus/
├── services/
│   └── family_assistant/
└── shared/
    ├── project-docs/
    ├── api-specs/
    └── design-tokens/

2. Consolidate family_assistant

  • Move canonical code to: ~/hoffdesk-agents/services/family_assistant/
  • Delete duplicates:
  • /workspace/scripts/family_assistant (backup first)
  • /workspace-socrates/scripts/family_assistant
  • Verify: /services/family_assistant/ becomes the single source of truth

3. Move Agent Files

Move each agent's bootstrap files to their new home:

Wadsworth → ~/hoffdesk-agents/agents/wadsworth/
- SOUL.md, AGENTS.md, IDENTITY.md, USER.md
- HEARTBEAT.md, TOOLS.md, MEMORY.md
- scripts/ (agent-specific only)
- memory/ (without .dreams/)

Socrates → ~/hoffdesk-agents/agents/socrates/
- SOUL.md, AGENTS.md, IDENTITY.md, USER.md
- HEARTBEAT.md, TOOLS.md, MEMORY.md, SPRINT-1-BRIEFING.md
- hoffdesk-api/
- scripts/ (agent-specific)
- memory/ (without .dreams/)

Daedalus → ~/hoffdesk-agents/agents/daedalus/
- SOUL.md, AGENTS.md, IDENTITY.md, USER.md
- HEARTBEAT.md, TOOLS.md, MEMORY.md, SPRINT-1-BRIEFING.md
- blog/, blog-admin/, dashboard/, prototype/
- memory/ (without .dreams/)

4. Draft Updated openclaw.json

Create: ~/hoffdesk-agents/openclaw.json
Update all workspace paths to point to new locations:
- main~/hoffdesk-agents/agents/wadsworth
- socrates~/hoffdesk-agents/agents/socrates
- daedalus~/hoffdesk-agents/agents/daedalus

Critical: Agents must wake up in the right house after restart.

Constraints

  • DO NOT commit yet — Matt is creating the GitHub repo
  • Preserve git history where possible (use git mv for moves within same repo)
  • Backup everything before destructive operations
  • Test the new config before final push

Questions?

Drop a note in this file or use sessions_send(label="wadsworth", message="...")

— Matt (Director)