---
name: ethereal-session-memory
description: "Persistent session memory for Ethereal. Maintains context between Cowork sessions so nothing gets lost. Updates CLAUDE.md, tracks open tasks, records decisions, and ensures session handoffs are clean. Use at START and END of every session."
---

# Ethereal Session Memory

> **Purpose**: Prevent context loss between sessions. Every session starts informed and ends documented.

## Session Start Protocol

At the START of every new session:

### 1. Read Memory Files (in this order)
```
1. ~/ethereal/.claude/FAILURE_ANALYSIS_AND_PROTOCOL.md  (behavioral rules)
2. ~/ethereal/.claude/CLAUDE.md                          (project memory)
3. ~/ethereal/CLAUDE.md                                  (behavioral pointer)
4. ~/ethereal/docs/canon/ETHEREAL_CANON_V4.md            (business rules — skim Section 1-8)
```

### 2. Check Current State
```bash
# What branch am I on?
cd ~/ethereal && git branch --show-current

# Latest commits (what happened recently?)
git log --oneline -10

# Any uncommitted changes?
git status

# Sentry issues (is production broken?)
# → Use Sentry MCP: search_issues
```

### 3. Report to Fernando
```
SESSION START REPORT:
- Branch: [branch]
- Last commit: [hash] [message]
- Uncommitted changes: [yes/no, what]
- Open P0 blockers: [from CLAUDE.md TODO section]
- Sentry status: [# of issues]
- Ready to work on: [what Fernando asks]
```

## Session End Protocol

At the END of every session (before context runs out):

### 1. Update CLAUDE.md
Add to the "Completed" section:
```
### Completed (YYYY-MM-DD session N)
- **[Feature/Fix name]** (commit `abc1234`):
  - [What was done, 1-2 lines]
  - [Files changed]
  - [Status: complete/partial/blocked]
```

### 2. Update TODO Section
Move completed items to "Completed". Add new items discovered during session.

### 3. Push Memory Update
```bash
# Always push CLAUDE.md updates to repo
git add .claude/CLAUDE.md
git commit -m "memory: update session log [date]"
git push
```

### 4. Context Handoff Document
If session is ending due to context limit, write a BRIEF handoff:
```
SESSION HANDOFF:
- Active task: [what was being worked on]
- Progress: [% complete, what's done, what's not]
- Next step: [exactly what to do next]
- Open files: [files currently being modified]
- Blocked on: [anything waiting on Fernando/Codex/external]
```

## Ethereal Glossary (decode Fernando's shorthand)

| Term | Meaning |
|------|---------|
| SAGE | Autonomous AI agent system (brain + omni-brain + prime) |
| Mesa Real | 22-model consensus dispatch system |
| Canon | 8 immutable business rules (ETHEREAL_CANON_V4.md) |
| The Eye | Fernando-only admin dashboard (/os/the-eye) |
| Bridge | orchestrator-bridge-v2.ts — frontend↔backend HTTP layer |
| Concierge | Public-facing chat widget (PATH 1) |
| Brain | Internal SAGE dashboard (PATH 2) |
| Codex | OpenAI Codex assistant for parallel mechanical tasks |
| Manus | Execution agent for specific delegated tasks |
| CRD | Credits (SAGE credit system) |
| Docling | Python/FastAPI service on Railway |
| V33 APEX | Current version status |
| Imperium | AI council decision system |
| Bibliotecaria | Semantic codebase indexing for Mesa |
| Arena de Ideas | Adversarial debate system for proposals |

## Fernando Communication Patterns

| Pattern | Meaning | Correct Response |
|---------|---------|-----------------|
| ALL CAPS | Critical importance / frustration | Stop. Analyze. Don't code. |
| "analiza" | He wants analysis, NOT code | Deliver analysis document |
| "estoy harto" | He's frustrated with repeated failures | Acknowledge. Fix root cause. |
| "carajo" / "!!" | Extreme emphasis | This is a MUST-DO, not a suggestion |
| "primero X" | Do X FIRST, nothing else | Do X. Only X. Then ask about next. |
| Spanish instructions | Keep them in Spanish | NEVER translate to English |
| "no me importa" | He doesn't care about excuses | Just do it correctly |