Small, explicit, reviewable
Contribute to Switchyard
A short path from a bounded problem to a high-quality pull request. The full contributor contract remains authoritative in the repository.
Choose a bounded issue
Start with a confirmed defect, good-first-issue query, or focused proposal. Keep one coherent vertical slice per change.
Find a starter issue →Read the architecture rules
Begin with AGENTS.md, the relevant implementation-plan phase, and accepted ADRs. Create an ADR before reversing an accepted decision.
Architecture overview →Bootstrap locally
Use the pinned Go, Node, pnpm, and Rust toolchains. The repository bootstrap generates all contracts and installs frontend dependencies.
git clone https://github.com/dcuellar322/switchyard.git
cd switchyard
make bootstrap
make repository-checkImplement and verify
Add behavior and tests together. Cover failure, cancellation, permission, and reconciliation paths when they apply.
Submit a small pull request
Explain the user-visible outcome and architecture impact, include validation evidence, and complete the repository checklist.
Open a pull request →Before requesting review
Complete the focused quality gate.
- Preserve adapter → application → domain dependency direction.
- Keep HTTP, CLI, MCP, UI, Tauri, and provider adapters thin.
- Do not expose unrestricted shell operations or bypass project trust.
- Regenerate API, schema, and agent-readable contracts.
- Update the relevant progress evidence honestly.
- Use a conventional commit with one intent.