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}

# Key snippet or reference

Commits This Session

Commit	Description
{hash}	{description}

Progress

• {Completed sub-task}
• {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

• {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}