Summary

Create a comprehensive guide for the 18 writer types in logger_system, documenting the decorator pattern composition, and providing recommended writer stack configurations for common use cases.

Parent Issue

Part of: [EPIC] docs: Address documentation gaps across all ecosystem systems (kcenon/common_system#325)

Background (Why)

logger_system has 18 writer types in include/kcenon/logger/writers/ that compose via the decorator pattern. While individual writers may be partially documented, there is no guide explaining:

• How writers compose (decorator stacking order)
• Which writers are base writers vs decorators
• Recommended combinations for common scenarios
• The full catalog of available writers

This is one of the most user-facing features of logger_system (4.34M msg/sec, 148ns latency) and the decorator composition is non-obvious.

Scope (What)

Create docs/WRITER_GUIDE.md covering:

1. Writer Architecture

• Base writer vs decorator writer pattern
• base_writer → decorator_writer_base inheritance chain
• How decorators wrap base writers (stack visualization)

2. Complete Writer Catalog

Base Writers (Output Destinations)

Decorator Writers (Processing Pipeline)

3. Composition Patterns

[Application Code]
    ↓
[filtered_writer] ← Drop DEBUG in production
    ↓
[formatted_writer] ← Add timestamp, level, source
    ↓
[async_writer] ← Non-blocking
    ↓
[batch_writer] ← Accumulate 100 messages
    ↓
[composite_writer]
    ├→ [rotating_file_writer] ← Local files
    └→ [network_writer] ← Remote server

4. Recommended Stacks

5. Code Examples

• Development setup (3 lines)
• Production file logging
• Encrypted compliance logging
• Multi-destination setup

6. Performance Impact

• Throughput per decorator layer
• Latency added per decorator
• Memory usage per configuration

Acceptance Criteria

• All 18 writers cataloged with descriptions
• Base vs decorator distinction clear
• At least 5 composition patterns documented
• Recommended stacks for 5+ use cases
• Code examples for each recommended stack
• Performance impact per decorator documented
• Stack visualization diagrams included