roboco/.tasks/templates/journal.md

# Agent Journey: TASK-{ID}

This file documents the agent's journey through this task. It provides context for future agents, enables handoffs, and builds organizational knowledge.

---

## Session 1

**Date**: YYYY-MM-DD HH:MM
**Agent**: {agent-id}
**Duration**: ~{X} hours
**Session State**: {started / continued / completed / paused}

### Context Restored
{If resuming: how you restored context}

### What I Did
- {Action 1}
- {Action 2}
- {Action 3}

### What I Learned
- {Learning 1 - something new discovered}
- {Learning 2 - something understood better}

### What I Struggled With
- {Struggle 1 - what was difficult}
- {Struggle 2 - where I got stuck}

### Decisions Made
- **{Decision}**: {Why I made this choice}

### Code Notes
{Any important notes about the code written}

```python
# Key snippet or reference
```

### Commits This Session
| Commit | Description |
|--------|-------------|
| {hash} | {description} |

### Progress
- [x] {Completed sub-task}
- [x] {Completed sub-task}
- [ ] {Remaining sub-task}

### Next Steps
When resuming, I should:
1. {Next step 1}
2. {Next step 2}

### Session End State
{Brief description of where things stand}

---

## Session 2

**Date**: YYYY-MM-DD HH:MM
**Agent**: {agent-id}
**Duration**: ~{X} hours
**Session State**: {started / continued / completed / paused}

### Context Restored
{How context was restored from previous session}

### What I Did
- {Action 1}
- {Action 2}

### What I Learned
- {Learning 1}

### What I Struggled With
- {Struggle 1}

### Decisions Made
- **{Decision}**: {Rationale}

### Commits This Session
| Commit | Description |
|--------|-------------|
| {hash} | {description} |

### Progress
- [x] {Completed sub-task}
- [ ] {Remaining sub-task}

### Next Steps
{If more work needed}

### Session End State
{Current state}

---

## Summary (For Handoff)

**Total Sessions**: X
**Total Time**: ~X hours
**Agents Involved**: {agent-id}, {agent-id}

### Key Learnings
1. {Most important learning}
2. {Second most important}
3. {Third}

### Key Decisions
1. {Decision 1}: {Why}
2. {Decision 2}: {Why}

### Gotchas for Future Work
- {Gotcha 1 - something that tripped you up}
- {Gotcha 2 - something to watch out for}

### Reusable Patterns
- {Pattern that could be used elsewhere}

### Related Tasks
- {Related task IDs or topics}