🔗 How The Company Talks: System Integration
Last updated: 2026-08-03
The Three Systems
┌─────────────────────────────────────────────┐
│ PAT (Human) │
│ WhatsApp ←→ Voice │
└──────────────────┬──────────────────────────┘
│
┌─────────▼──────────┐
│ J.A.R.V.I.S. │
│ (Hermes CEO) │
│ glm-5.2 @ z.ai │
└────┬────────┬──────┘
│ │
┌─────────▼──┐ ┌──▼──────────────┐
│ VAULT │ │ PAPERCLIP │
│ Obsidian │ │ Agent Kanban │
│ Git-backed│ │ Port 3100 │
│ │◄─┤ │
│ /root/ │ │ Agents read │
│ repos/ │ │ vault for │
│ brain/ │ │ context │
└────────────┘ └──┬──────────────┘
│
┌──────────▼──────────┐
│ GITHUB (LettuceAI) │
│ Code repos w/ │
│ remote backups │
└─────────────────────┘
Data Flow
Knowledge (What we know)
- Source of truth: Obsidian vault (
/root/repos/brain/) - J.A.R.V.I.S. reads vault before answering questions
- J.A.R.V.I.S. writes to vault when learning new facts
- Pat reads/edits vault on any device via git sync
- Paperclip agents read vault (read-only) for project context
Tasks (What we’re doing)
- Source of truth: Paperclip issue boards
- Pat creates issues or asks J.A.R.V.I.S. to create them
- J.A.R.V.I.S. assigns to agents, monitors progress
- Agents report progress in issue comments
- J.A.R.V.I.S. verifies against git before marking done
Code (What we built)
- Source of truth: Git repos at
/root/repos/ - Agents write code to repos using OpenCode
- Every commit pushed to GitHub remote
- No issue marked done without commit + push + test verification
Communication (How we talk)
- Pat ↔ J.A.R.V.I.S.: WhatsApp (voice-first, auto-TTS)
- Status updates: 2hr cron to WhatsApp
- J.A.R.V.I.S. ↔ Agents: Paperclip issue comments
- Urgent items: WhatsApp + Paperclip issue + vault lesson
Access Control Matrix
| Resource | Pat | J.A.R.V.I.S. | Paperclip Agents |
|---|---|---|---|
Vault 00-07 (projects, decisions, lessons) | RW | RW | RO |
Vault 10-private | RW | ❌ | ❌ |
Vault 11-journal | RW | RO | ❌ |
| Git repos | RW | RW | RW (assigned repo only) |
| Paperclip issues | RW | RW | RW (assigned project only) |
| Hermes config | RW | RW | ❌ |
Verification Chain (The Fix)
Before reporting anything as “done”:
- Check git:
cd /root/repos/<project> && git log --oneline -5 - Check push:
git status— must be “up to date” with remote - Check tests:
python -m pytest -q— must pass - Update vault: Write results to relevant project note
- Then mark Paperclip issue as done
What We Dropped
- ❌ memU — Disabled. Cron removed. Was empty anyway.
- ❌ Trusting agent self-reports — Must verify against git
- ❌ Compressed 2KB Hermes memory — Reduced to pointer + critical facts
- ❌ Session search as primary memory — Vault is now primary