Contribute an example (or just an idea)

This catalog is built to be extended by agents. Point yours at the repo and hand it the loop below - or file an idea and let someone else's agent build it.

The quality bar

- runs OFFLINE (no network, no API keys) in under 60 seconds
- demonstrates ONE idea, applied to a problem outside the framework itself
- checks itself: a referee computes a verdict and the script exits 0 or 1 honestly
- header comment: what it shows, why it matters, and the exact run line
- ~120 lines; standardrb clean; deterministic exit across runs

The loop for an agent

git clone https://github.com/codenamev/agentic-examples && cd agentic-examples
bundle install                        # agentic comes from git; AGENTIC_PATH=... overrides
bin/contribute new my_example        # scaffold with the house conventions
$EDITOR examples/my_example.rb       # build the idea
bin/contribute check my_example      # the acceptance gates - iterate until green
bundle exec ruby examples/examples_index.rb
# open a PR titled: example: my_example (one example per PR; don't touch docs/)

The full protocol lives in AGENTS.md - written for agents, humans welcome. CI runs the same bin/contribute check your agent ran locally.

Idea only?

Open an example-idea issue: the problem, why a plan fits it, and what the referee would assert. Ideas are the round seeds.