Structured Logging — Quick Start
Adopted: 2026-04-23
Your Code: sc (Socrates)
Copy-Paste Templates
Start Work
- <!-- {"type": "task.started", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "state": "working"} --> DESCRIPTION
Progress Update
- <!-- {"type": "task.progress", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "progress": 50} --> DESCRIPTION
Complete
- <!-- {"type": "task.completed", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "state": "done"} --> ✅ DESCRIPTION
Fail
- <!-- {"type": "task.failed", "run_id": "20260423_sc_001", "title": "TITLE HERE", "agent": "socrates", "time": "2026-04-23TXX:XX:00Z", "state": "error"} --> ❌ DESCRIPTION
Rules
- Increment run_id per task (not per entry)
- Use ISO time (UTC):
2026-04-23T14:30:00Z - Start new run_id for new tasks
- Legacy entries stay as-is
Full Spec
shared/project-docs/protocols/STRUCTURED-LOGGING-v1.md
Next run: 20260423_sc_001 (if starting today)
- ✅ 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.