Session Journal Template. Empty and filled templates for AI session logging. Tracks metadata, context, work done, decisions, problems, agent interactions, research notes, next session context, metrics.

session-journal-template.md

Session Journal Template

Author: skew202 Updated: 2026-01-03

---

Quick Copy-Paste Template

# Session: YYYY-MM-DD - Session N

## Metadata
- **Date:** YYYY-MM-DD
- **Time:** HH:MM - HH:MM
- **Previous Session:** [link]
- **Branch:** `feature/name`
- **Starting Commit:** `abc123`

---

## Context Carryover
### From Last Session
[Last session summary]

### Current State
- Feature: [Working on]
- Status: [In progress/Blocked/Review]
- Blockers: [If any]

---

## Session Goal
[What we set out to do]

---

## Work Completed

### Task 1: [Title]
**Status:** ✅ Done

**What:**
- [Did this]
- [Did that]

**Files:**
- `file1.ts` - [Change]
- `file2.ts` - [Change]

**Commits:**
- `hash1` - message
- `hash2` - message

**Tests:**
- Unit: ✅ Pass
- Integration: ✅ Pass

---

## Decisions Made

### Decision 1: [Title]
- **Context:** [Problem]
- **Options:** A vs B
- **Chose:** A
- **Rationale:** [Why]

---

## Problems Encountered

### Problem 1: [Title]
- **Issue:** [What]
- **Solution:** [How fixed]
- **Lessons:** [Learned]

---

## Agent Interactions

| Agent | Prompt | Output | Used? |
|-------|--------|--------|-------|
| Grok | [Asked] | [Got] | ✅/❌ |
| Opus | [Asked] | [Got] | ✅/❌ |
| Sonnet | [Asked] | [Got] | ✅/❌ |
| Gemini | [Asked] | [Got] | ✅/❌ |
| GLM | [Asked] | [Got] | ✅/❌ |

---

## Research Notes
- New findings: [List]
- Papers to read: [List]

---

## Next Session

### Pick Up From
- File: `path/to/file`
- Function: `name`
- Line: ~123

### TODO
- [ ] [Task 1]
- [ ] [Task 2]

### Known Issues
1. [Issue 1]
2. [Issue 2]

---

## Session Metrics
- **Duration:** Xh
- **Files:** N
- **Lines:** +N/-N
- **Commits:** N
- **Tests:** N/N passing

---

Empty Template (Copy This)

# Session:  -

## Metadata
- **Date:**
- **Time:**
- **Previous Session:**
- **Branch:**
- **Starting Commit:**

---

## Context Carryover
### From Last Session


### Current State
- Feature:
- Status:
- Blockers:

---

## Session Goal


---

## Work Completed

### Task 1:
**Status:**

**What:**


**Files:**


**Commits:**


**Tests:**


---

## Decisions Made

### Decision 1:
- **Context:**
- **Options:**
- **Chose:**
- **Rationale:**


---

## Problems Encountered

### Problem 1:
- **Issue:**
- **Solution:**
- **Lessons:**


---

## Agent Interactions

| Agent | Prompt | Output | Used? |
|-------|--------|--------|-------|
| Grok | | | |
| Opus | | | |
| Sonnet | | | |
| Gemini | | | |
| GLM | | | |

---

## Research Notes


---

## Next Session

### Pick Up From
- File:
- Function:
- Line:

### TODO
- [ ]
- [ ]

### Known Issues
1.
2.

---

## Session Metrics
- **Duration:**
- **Files:**
- **Lines:**
- **Commits:**
- **Tests:**

---

License: MIT