log

Append structured entries to project journal markdown files with lint validation.

37|2|Updated Jun 28, 2025
One-click install
npx skills add https://github.com/jellyrock/jellyrock --skill log-jellyrock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: log
Source: https://github.com/jellyrock/jellyrock/tree/main/.claude/skills/log
Command: npx skills add https://github.com/jellyrock/jellyrock --skill log-jellyrock

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually maintaining multiple structured project journals (decisions, followups, signals, running work) across separate markdown files with unique formatting rules is tedious, error-prone, and leads to inconsistent record-keeping that breaks downstream tooling like staleness banners and audit trails.

Core Features & Use Cases

  • Four Journal Types: Supports logging architectural decisions (agent-gated, routed to ADRs or sub-ADR notes), open followups, upstream version signals, and in-flight work cursors.
  • Automated Routing & Formatting: Automatically routes entries to the correct file and matches existing formatting, eliminating manual lookup and formatting work.
  • Guardrails & Validation: Enforces significance gating for decision entries to prevent decision-log creep, runs automatic linting to validate journal schema and staleness metadata after every write.
  • Use Case: A developer working on JellyRock can log a new architectural decision about Roku SceneGraph event handling with a single command and have it automatically routed to the correct ADR file with proper formatting, no manual file editing required.

Quick Start

Invoke the log skill with the entry type and your content to automatically append the correctly formatted entry to the appropriate project journal file.

Frequently Asked Questions about log

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

FAQPage Schema
How do I append entries to multiple structured project journals without manual formatting errors?

Automated journal logging appends entries to architectural decisions, open followups, upstream version signals, and in-flight work cursors with a single command. It routes content to the correct file, matches existing formatting, and runs lint validation to eliminate manual errors.

What's the best way to capture architectural decisions and route them to ADR files automatically?

Capturing architectural decisions is handled through agent-gated significance classification that routes qualifying entries directly to ADR files. This gating mechanism prevents decision-log creep by ensuring only significant decisions are recorded, while routine notes bypass the gate.

How does automatic lint validation maintain journal schema and staleness metadata after logging?

Automatic lint validation runs after every journal write to validate the schema and staleness metadata of project journals. This ensures downstream tooling like staleness banners and audit trails continue to function correctly without manual consistency checks.

Can I track open followups and upstream version signals in the same workflow as in-flight work cursors?

Tracking open followups, upstream version signals, and in-flight work cursors is supported natively within the same logging workflow. Each entry type is mechanically appended to its respective structured markdown file, maintaining unique formatting rules across all four journal types.

Why does manually maintaining separate markdown journal files break downstream tooling and audit trails?

Manually maintaining separate markdown journals is error-prone and leads to inconsistent record-keeping that breaks downstream tooling. Automated logging enforces schema compliance and significance gating to preserve the integrity of staleness banners and audit trails.

When do I need agent-gated significance classification for decision logging?

Agent-gated significance classification is required specifically for architectural decision entries to prevent decision-log creep. Routine captures like followups and signals use direct mechanical appends, bypassing the gate to streamline standard project logging.