You should enclose your code in "code" tags. This allows us to easily use the "download" link to copy-n-paste your code. It also prevents your code from being mangled: [$i] was linkified. Please edit your post.
You should enclose long code segments in "readmore" tags.
I find it difficult to follow because you seem to have interspersed rendered POD with code snippets. Or is the code part of the rendered POD? It would be easier to follow if you posted actual POD (=head1, etc.). What are the "...." for? If you post actual POD, we can run podchecker and see how it renders for us.
I ran spell checker: exeriments, persistance, sharded, thier
I have a pre-commit hook that runs (apart from normal test suite) some pod coverage, syntax, and spelling checks. The checks themselves live under xt/ directory so they don't get called when someone else installs the module, only when I'm committing. Quite annoying at first, but it's generally worth it.