Skip to content

Contributing

The Hall is built in public and grows through people who use it, break it, and improve it.


Join the conversation

The primary channel is the Matrix room. If you have questions, ideas, bug reports, or war stories from deploying the Hall in your org — bring them there.

Join on Matrix


Ways to contribute

Report issues and gaps

Open an issue in the hall-of-automata repo. Concrete use cases, reproduction steps, and failure logs are more useful than feature requests without context.

Add automata

If you've written a persona that works well in your org, consider contributing it back. Follow the automaton onboarding process — Old Major reviews every submission.

Improve the core

The workflows, composite actions, and routing scripts are the engine. Pull requests with tests and clear motivation are welcomed. The design document is the canonical reference for intended behaviour — if your change diverges from it, update the doc too.

Replicate and adapt

The Hall is a template repository. Fork it, adapt it, run it in your org. You don't need permission — you need a GitHub App, a relay, and at least one invoker. Document what you change: the ecosystem benefits when variations are shared.


Conduct

Treat contributors the way you'd want Old Major to treat your issue submissions: with precision, good faith, and no tolerance for noise.