superpowers-sage:acorn-logging

Implement structured channel-based logging for Acorn in WordPress/Sage projects.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-acorn-logging-hekivo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-sage:acorn-logging
Source: https://github.com/hekivo/superpowers-sage/tree/main/skills/acorn-logging
Command: npx skills add https://github.com/hekivo/superpowers-sage --skill superpowers-sage-acorn-logging-hekivo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of making Acorn/WordPress logging reliable, searchable, and actionable by using Laravel’s Log facilities alongside proper channel configuration and WordPress debug integration.

Core Features & Use Cases

  • Structured logging with context arrays: attach machine-parseable metadata (IDs, gateways, trace IDs) instead of string interpolation for easier filtering.
  • Configurable log channels: route logs to daily rotating files, single files, syslog/errorlog, and custom channels per concern (payments, api, etc.).
  • Exception-aware reporting: log failures with stack traces and context, and optionally forward error-level events to Slack.
  • Environment-appropriate behavior: keep development verbose while production focuses on error-level signal using drivers like daily rotation.

Quick Start

Publish and configure Acorn logging by ensuring your theme has config/logging.php, then set LOG_CHANNEL to daily to start writing structured logs into storage/logs/acorn.log.

Frequently Asked Questions about superpowers-sage:acorn-logging

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

FAQPage Schema
How do I set up structured logging in Acorn for a WordPress Sage theme?

To configure structured logging in Acorn, publish a config/logging.php file in your theme, set LOG_CHANNEL to daily, and use the Log facade with context arrays to write machine-parseable records into storage/logs/acorn.log.

What is the best way to route Acorn application logs to specific channels per feature?

Channel-based logging in Acorn allows routing logs to separate daily rotating files or custom channels per concern, such as payments or API events, by defining distinct channels in your config/logging.php file.

Can I send Acorn exception stack traces and error logs to Slack?

Yes, Acorn logging supports exception-aware reporting that logs failures with stack traces and context arrays, and optionally forwards error-level events to external handlers like Slack via custom log channels.

Does Acorn structured logging integrate with the WordPress debug.log file?

Yes, Acorn structured logging integrates with WordPress debug.log, allowing you to capture application events and failures alongside standard WordPress debug output for unified troubleshooting.

How do I attach metadata to Laravel log facade calls in Acorn for better filtering?

By passing context arrays containing machine-parseable metadata like IDs, gateway names, and trace IDs to Log facade methods, you avoid string interpolation and achieve easier log filtering.