Contributing

We love contributions — code, docs, triage, examples, and tests. Start on Discord so scope is clear before you invest time.

Daily contributor sync: every day at 10:00 PM IST

• Discord → questions, mentoring, sync, realtime unblocking
• GitHub → bugs, proposals, design threads, review

Non-trivial work? Comment on the issue or ping Discord first. Get a thumbs-up, then build.

Ways to contribute

Type	Examples
Code	Fixes, features, adapters, performance
Docs	README, docs/, architecture notes
Triage	Repro bugs, tighten reports, label suggestions
Examples / tests	Recipes, edge cases, flaky-test hunts

Quick start

1. Join Discord — say hi and get guidance
2. Read the contract — AGENTS.md (layout, commands, hard rules, PR hygiene)
3. Pick something focused — open issues; prefer good-first-issue / help wanted
4. Claim it — comment I'd like to work on this and wait for assignment
5. Open a clear PR — narrow change, link the issue, user-visible impact, tests
6. Iterate — address review; maintainers merge

Need the product/run overview first? Start with README.md, docs/architecture.md, and docs/development.md.

Two onboarding notes matter on current main:

• On fresh Linux setups, prefer cd frontend && npm run package unless you have also installed distro packaging tools such as rpm/rpmbuild for npm run make.
• Mobile companion app docs are still being filled in. Do not assume packages/mobile/README.md is a complete headless setup guide on this branch.

Bugs and features

Use the GitHub issue forms (Bug report / Feature request) so reports stay reproducible. Bug reports should include AO version, environment, repro steps, and expected vs actual behavior.

Pull requests

New PRs are prefilled from .github/pull_request_template.md. Also follow PR hygiene in AGENTS.md: branch from main, one issue per PR, conventional commits, explain intentional omissions, and keep CI green for the area you touched.

Code of Conduct

Be respectful, constructive, and assume good intent. Report problems to maintainers via Discord DM.

Thanks for making agent-orchestrator better for the next person who shows up.