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.