simple-logger-usage
simple-logger-usage
Expert guide for adding structured logging to any TypeScript application using @alcyone-labs/simple-logger.
When to Apply
- Adding logging to new or existing TypeScript project
- Need consistent logging across files (frontend/backend/services)
- Want typed logs with metadata/data separation
- Need scoped loggers per file/module
- Building Chrome MV3 extensions with service workers
Golden Rules
- Create file-scoped logger at top of each file using
useLogging - Pass contextual metadata (service, file, component, requestId)
- Separate
message(human-readable) fromdata(structured) - Use
data.metadatafor tags/labels,data.*for structured fields - Never pass secrets/passwords in logs
More from alcyone-labs/agent-skills
chrome-extension-architect
Privacy-first Chrome Manifest Version 3 extension architect - sidePanel design, MV3 service worker lifecycle, least-privilege permission audits, storage strategy, cross-browser sidebar patterns, and headless Playwright testing.
9aquaria-docs
Expert Aquaria documentation architect. Enforce documentation principles, golden rules, templates, folder structure, and quality gates. Creates compliant docs from templates, validates against Golden Rules checklist.
6arg-parser
Type-safe CLI argument parser with MCP integration Zod validation auto-generated tools and interactive prompts
5git-commit-writer
Write consistent high-quality Git commits following project conventions
5skill-forge
Builds precise production-ready custom Agent Skills following AgentSkills.io guidelines. Use when user requests to create, refine or package Skills
4large-file-refactorer
Scans codebase for large files and orchestrates refactoring workflows using a test-first protocol
4