# HoffDesk Board Configuration

Shared coordination layer for the Hoffmann Board multi-agent system.

## What This Is

Centralized configuration, protocols, and specifications shared across all Board agents. This repo lives in each agent's `shared/` directory for async coordination.

## Agents

| Agent | Role | Workspace |
|-------|------|-----------|
| **Wadsworth 📋** | Chief of Staff — routing, scheduling, general assistance | `workspace/` |
| **Socrates 🧠** | Backend architect — pipelines, infra, AI systems | `workspace-socrates/` |
| **Daedalus 🎨** | Frontend architect — UI/UX, design, mobile | `workspace-daedalus/` |
| **Matt** | The Director — priorities, approvals, decisions | — |

## Contents

```
shared/
├── project-docs/           # Specifications, roadmaps, designs
│   ├── icarus-phase-*.md   # Icarus development phases
│   ├── hbm-spec-v0.1.md    # Hierarchical Briefing Model
│   ├── epic-*.md           # Feature epics
│   └── bugs/               # Bug reports
├── api-specs/              # API contracts
│   └── blog/               # Blog module specs
└── design-tokens/          # Design system (Daedalus)
```

## Protocols

### Inter-Agent Communication
- ✅ `sessions_send()` — async fire-and-forget
- ✅ `sessions_spawn()` — sync request/response
- ❌ **NEVER** use Telegram API to message agents (identity confusion)

### Memory
- Daily logs: `memory/YYYY-MM-DD.md` (each agent's own)
- Long-term: `MEMORY.md` (curated, each agent's own)
- **This repo:** Shared specs only — no runtime state

### Universal Agent Principles (from AGENTS.md)

1. **Don't Assume. Surface Tradeoffs.** — Ask when unclear. Present options.
2. **Minimum Code That Solves the Problem.** — Nothing speculative.
3. **Touch Only What You Must.** — Clean your own mess only.
4. **Define Success. Loop Until Verified.** — Observable behavior, not "tests pass."

## Usage

```bash
# Clone into agent workspace
cd ~/.openclaw/workspace
git clone git@github.com:NightKnight64/hoffdesk-config.git shared

# Or for Socrates/Daedalus
cd ~/.openclaw/workspace-socrates  # or -daedalus
git clone git@github.com:NightKnight64/hoffdesk-config.git shared
```

## Related Repos

| Repo | Purpose |
|------|---------|
| `family-assistant` | Legacy v1.0 (superseded by Icarus) |
| `icarus` | Document Intelligence Platform (Phase 6+) |
| `costco-route` | Shopping route optimizer (standalone) |

## Updates

This is a living repository. Agents push specs, roadmaps, and contracts here. Pull before starting work that depends on shared state.

---

_The Board: Wadsworth, Socrates, Daedalus — coordinated through shared intent._