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.