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.