# Structured Logging — Quick Start

**Adopted:** 2026-04-23  
**Your Code:** `sc` (Socrates)

---

## Copy-Paste Templates

### Start Work
```markdown
- <!-- {"type": "task.started", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "state": "working"} --> DESCRIPTION
```

### Progress Update
```markdown
- <!-- {"type": "task.progress", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "progress": 50} --> DESCRIPTION
```

### Complete
```markdown
- <!-- {"type": "task.completed", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "state": "done"} --> ✅ DESCRIPTION
```

### Fail
```markdown
- <!-- {"type": "task.failed", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "state": "error"} --> ❌ DESCRIPTION
```

---

## Rules

1. **Increment run_id per task** (not per entry)
2. **Use ISO time** (UTC): `2026-04-23T14:30:00Z`
3. **Start new run_id for new tasks**
4. **Legacy entries stay as-is**

---

## Full Spec

`shared/project-docs/protocols/STRUCTURED-LOGGING-v1.md`

---

**Next run:** `20260423_sc_001` (if starting today)
- <!-- {"type": "task.completed", "run_id": "20260423_sc_001", "title": "Email Pipeline v2 — Smart Classification", "agent": "socrates", "time": "2026-04-23T14:45:00Z", "state": "done"} --> ✅ Email classification pipeline verified. All 4 handlers (appointment, newsletter, family, other) correctly classifying and routing. Classification: qwen2.5-coder:7b. Test results: 4/4 passing.