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.