AI coding instruments are altering how open supply software program will get constructed. At Zcash Basis, we’ve seen this firsthand: AI-assisted contributions have helped us ship options quicker, enabled contributors who’re new to Rust or to the Zcash protocol to make significant contributions, and accelerated our growth velocity throughout 4 main releases—within the final three months alone.
We’re embracing this shift. And we’re being intentional about it.
Why This Is Essential For Zcash
Zebra is Zcash Basis’s consensus node implementation; the software program that validates each transaction on the Zcash community and enforces the protocol guidelines that shield customers’ monetary privateness. Following the zcashd deprecation and Community Improve 7, Zebra will develop into the first consensus implementation for all the Zcash community.
That is privacy-critical infrastructure. Each line of code in Zebra can have an effect on the privateness of thousands and thousands of individuals. A bug in consensus validation might reject legitimate shielded transactions or settle for invalid ones. A flaw in cryptographic verification might compromise zero-knowledge proof safety. An error in state administration might result in community forks or monetary loss.
This is the reason each change to Zebra (whether or not written by a human, assisted by AI, or something in between) goes by means of rigorous human evaluate by our engineering workforce. That hasn’t modified.
What Has Modified
What has modified is the amount. Like many open supply initiatives, we’ve seen a big improve in exterior pull requests. Some are glorious contributions from builders utilizing AI instruments to work extra successfully. Others lack context, prior coordination, or proof that the contributor understands the change they’re proposing.
The problem isn’t AI itself, it’s that opening a pull request comes with an actual price. Each PR requires a maintainer to learn the code, perceive the intent, consider correctness in opposition to Zcash’s consensus guidelines, and confirm that nothing compromises the privateness or safety ensures our customers rely on. That takes time, and our workforce’s evaluate capability is finite.
We’re not alone in navigating this. Tasks throughout the ecosystem — Reth, Lodestar, Ghostty, and plenty of others, have been creating approaches to take care of high quality whereas welcoming AI-assisted work. GitHub itself is exploring new instruments to assist maintainers handle this shift. We’ve drawn from these examples to construct an method that matches Zebra’s particular wants as privacy-critical infrastructure.
Our Strategy
We’ve launched three issues: clear pointers for contributors, machine-readable steerage for AI brokers, and clear standards for after we shut PRs.
For Contributors
Our up to date CONTRIBUTING.md now asks contributors to:
- Begin with a problem. Describe what you wish to change and why, and watch for a workforce member to reply earlier than writing code. A problem with no workforce acknowledgment doesn’t depend as prior dialogue.
- Disclose AI utilization. In the event you used AI instruments, inform us what instrument and the way you used it. This isn’t punitive, it helps reviewers calibrate their evaluate. You’re the sole accountable writer of your code no matter how it was written.
- Be prepared to elucidate your work. If we ask throughout evaluate, you must be capable to clarify the logic and design trade-offs of each change.
We’ve additionally made our PR closure standards specific. PRs could also be closed if there’s no prior workforce dialogue, if the change wasn’t requested, or if the contributor can’t clarify their work. This isn’t private; it’s about respecting everybody’s time, together with the contributor’s.
For AI Brokers
We’ve adopted the AGENTS.md commonplace: A common format for offering AI coding brokers with project-specific context. When a contributor makes use of Claude Code, GitHub Copilot, Cursor, or any of 20+ different instruments contained in the Zebra repository, the agent robotically reads our pointers earlier than producing code.
Our AGENTS.md offers brokers with:
- A contribution gate that prompts the agent to confirm the contributor has mentioned the change with our workforce earlier than opening a PR
- Zebra’s crate structure and dependency guidelines, so generated code respects our layered design
- Code patterns particular to Zebra: Tower service bounds, error dealing with conventions, numeric security necessities, async patterns
- Safety constraints crucial for a privacy-preserving node: bounded allocations, enter validation at system boundaries, cryptographic verification patterns
The purpose is easy: if an AI agent understands Zebra’s structure and insurance policies, it produces higher code and—simply as importantly—warns its consumer when a PR would probably be closed.
We’ve additionally added customized directions for GitHub Copilot Code Evaluation, tailored from evaluation of over 18,000 historic evaluate feedback on the Zebra repository. This provides Copilot Zebra-specific evaluate checks so it flags the problems our maintainers truly care about.
AI Is Making Zebra Higher
We wish to be clear about one thing: AI-assisted contributions have been a internet constructive for Zebra; our latest growth velocity speaks for itself. Within the final three months, we’ve shipped 4 releases: Zebra 3.0.0, 3.1.0, 4.0.0, and 4.1.0.
Contributors utilizing AI instruments have helped make this doable. AI lowers the barrier for builders who might not have deep expertise with Rust’s possession mannequin or Zcash’s consensus guidelines to contribute meaningfully. That’s an excellent factor; the Zcash ecosystem now advantages from a broader contributor base.
However each considered one of these options was deeply reviewed by our engineering workforce. Our maintainers understood the implications, verified correctness in opposition to the Zcash protocol specs, and ensured nothing compromised the privateness ensures our customers rely on. AI accelerates the writing; the understanding and accountability stay human.
What We’re Asking of the Group
If you wish to contribute to Zebra:
- Begin a dialog. Open a problem or attain out on Discord. Inform us what you wish to work on. We’ll allow you to perceive the scope, and information you towards the best method.
- Use AI instruments in the event that they allow you to. We welcome it. Simply disclose it (your agent will certainly do it for you) and be sure you perceive what you’re submitting.
- Respect the method. Our evaluate exists to guard Zcash customers’ privateness and monetary safety. Working with us, not round us, means your effort is extra prone to depend.
In the event you’re constructing instruments on high of Zebra, try Zaino for indexer/lightwalletd performance, Zallet for pockets options, or librustzcash for Zcash Rust libraries—many options that don’t belong within the consensus node have a pure dwelling within the broader Z3 stack.
Trying Ahead
We’ll be monitoring how these pointers work in observe over the approaching weeks: monitoring whether or not they cut back evaluate burden, whether or not contributors discover them useful, and whether or not we have to alter. We’re dedicated to iterating primarily based on what we be taught.
The broader open supply neighborhood is navigating this identical transition. We’re studying from others, and we hope our method—particularly the usage of AGENTS.md for machine-readable contribution insurance policies—is beneficial to different initiatives within the Zcash ecosystem and past.
AI is making software program growth quicker and extra accessible. For privacy-critical infrastructure like Zebra, that velocity must be paired with intentionality. We consider we are able to have each.
The contribution pointers, AGENTS.md, and Copilot evaluate directions referenced on this publish can be found within the Zebra repository. We welcome suggestions on our method—attain out by way of GitHub Points, Discord, or the Zcash Group Discussion board.