session-journal

Log decisions and project lessons to preserve session context across work tasks.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/yairbederman/EngineeringAgency --skill session-journal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-journal
Source: https://github.com/yairbederman/EngineeringAgency/tree/main/skills/session-journal
Command: npx skills add https://github.com/yairbederman/EngineeringAgency --skill session-journal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintains session continuity by logging decisions, progress, and rationale to preserve context across work sessions. Core principle: check for project lessons at the start and log significant decisions during work.

Core Features & Use Cases

  • At Session Start: loads project lessons from your workspace path <workspace>/.ai-memory/lessons/ and announces the number loaded or indicates none were found.
  • During Work: logs significant decisions to brain/<conversation-id>/sessions/<YYYY-MM-DD>.md with timestamps and rationale.
  • At Session End: summarizes accomplishments, notes open threads, and detects recurring patterns to trigger lessons-capture.

Session Log Format

  • Session: YYYY-MM-DD
  • Lessons Loaded: [list of applied lessons]
  • Decisions
    • HH:MM - [Decision]: [Rationale]
  • Open Threads: [list]

Quick Start

Enable the session journal at the start of a work session to load lessons and begin logging decisions.

Frequently Asked Questions about session-journal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I log architectural decisions and preserve context across coding sessions?▼

Session journaling preserves context by logging architectural decisions and rationale to a standardized markdown file with timestamps at the start of and during work sessions.

What is the best way to capture project lessons and apply them in future work sessions?▼

Capturing project lessons involves loading existing lesson files from a workspace memory directory at session start, then detecting recurring patterns at session end to trigger automated lessons-capture for future application.

How do I track session progress and identify open threads in a project workspace?▼

You can track session progress and identify open threads by generating an end-of-session summary that notes accomplishments, lists unresolved items, and detects recurring patterns within your project workspace.

Do I need a specific workspace memory directory to start logging decisions?▼

Yes, you need a workspace memory directory to store and retrieve project lessons. The skill loads lessons from a designated workspace path and logs decisions to a structured brain directory during active work.

How does session decision logging work during ongoing design reviews?▼

During design reviews, decision logging works by recording significant choices to a dated markdown file with timestamps and rationale, creating a chronological record of architectural and design decisions within the conversation context.

Can I use markdown files for session logging and context management?▼

Yes, markdown files are used for session logging and context management. Decisions are recorded in a standardized markdown format with timestamps, rationale, and open threads for cross-session continuity.