session-logging

Initialize standardized session JSON logs for multi-agent workflows.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/j-mckerracher/agent-research --skill session-logging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-logging
Source: https://github.com/j-mckerracher/agent-research/tree/main/dated-agents/4-6-2026/.claude/skills/session-logging
Command: npx skills add https://github.com/j-mckerracher/agent-research --skill session-logging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agent session logging enables reliable, structured logs for every spawned agent in multi-agent workflows, reducing debugging time and ensuring auditable traces.

Core Features & Use Cases

  • Standard log file naming convention using {CHANGE-ID}/logs/{agent_name}/{YYYYMMDD_HHMMSS}_session.json
  • Required log fields including log_type, timestamp, change_id, iteration, session_summary, decisions_made, issues_encountered, and notes
  • Log content guidelines detailing input/output artifacts, librarian queries, and key decisions with rationale
  • Automated initialization via scripts/init-session-log.py to create properly named log files
  • Use Case: For every agent spawn in a workflow, generate and store a session log to support debugging and auditing

Quick Start

Run the init-session-log.py script to create a timestamped session JSON log under the change's logs directory.

Frequently Asked Questions about session-logging

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

FAQPage Schema
How do I capture structured agent session logs for multi-agent workflows?

You can capture structured agent session logs by running an initialization script that creates timestamped JSON files, enforcing standardized naming conventions and required fields like log_type, change_id, and session_summary for every spawned agent.

What fields are required for a standardized agent session log?

Required fields for a standardized agent session log include log_type, timestamp, change_id, iteration, session_summary, decisions_made, issues_encountered, and notes to ensure consistent, auditable session records across workflows.

How do I generate a timestamped JSON log file for an agent spawn?

You generate a timestamped JSON log file by running the automated init-session-log.py script, which creates a properly named log under the change's logs directory using the YYYYMMDD_HHMMSS_session.json format.

What is the best way to maintain auditable session records across multiple agents?

The best way to maintain auditable session records is to enforce a standardized log file naming convention and content guidelines for every agent spawn, capturing input/output artifacts, librarian queries, and key decisions with rationale.

Can I use this session logging approach across different workflow stages like QA and task generation?

Yes, session logging is applicable during every agent spawn across stages such as intake, task generation, software execution, QA, and lessons optimization, ensuring consistent records throughout the entire workflow.