add comprehensive readme covering usage, format specifiers, features, and implementation details. Co-authored-by: Claude <noreply@anthropic.com>