|
| 1 | +--- |
| 2 | +title: "Contributor Communication" |
| 3 | +description: "Communication methods for Agent Client Protocol contributors" |
| 4 | +--- |
| 5 | + |
| 6 | +This document explains how to communicate and collaborate within the Agent Client Protocol (ACP) project. |
| 7 | + |
| 8 | +## Communication Channels |
| 9 | + |
| 10 | +In short: |
| 11 | + |
| 12 | +- **[Zulip](https://agentclientprotocol.zulipchat.com/)**: For real-time or ad-hoc discussions. |
| 13 | +- **[RFDs](https://agentclientprotocol.com/rfds/about)**: For proposed changes to the specification. |
| 14 | +- **[GitHub Discussions](https://github.com/orgs/agentclientprotocol/discussions)**: For structured, longer-form discussions. |
| 15 | +- **[GitHub Issues](https://github.com/agentclientprotocol/agent-client-protocol/issues)**: For actionable tasks, bug reports, and feature requests. |
| 16 | + |
| 17 | +All communication is governed by our [Code of Conduct](https://agentclientprotocol.com/community/code-of-conduct). We expect all participants to maintain respectful, professional, and inclusive interactions across all channels. |
| 18 | + |
| 19 | +### Zulip |
| 20 | + |
| 21 | +For real-time contributor discussion and collaboration. The server is designed around **ACP contributors** and is not intended to be a place for general ACP support. |
| 22 | + |
| 23 | +The Zulip server will have both public and private channels. |
| 24 | + |
| 25 | +[Join the Zulip here](https://agentclientprotocol.zulipchat.com/). |
| 26 | + |
| 27 | +#### Public Channels (Default) |
| 28 | + |
| 29 | +- **Purpose**: Open community engagement, collaborative development, and transparent project coordination. |
| 30 | +- Primary use cases: |
| 31 | + - **Public SDK and tooling development** |
| 32 | + - **Community onboarding** and contribution guidance. |
| 33 | + - **Community feedback** and collaborative brainstorming. |
| 34 | +- Avoid: |
| 35 | + - ACP user support: participants are expected to read official documentation and start new GitHub Discussions for questions or support. |
| 36 | + - Service or product marketing: interactions on this Zulip are expected to be vendor-neutral and not used for brand-building or sales. Mentions of brands or products are discouraged outside of being used as examples or responses to conversations that start off focused on the specification. |
| 37 | + |
| 38 | +#### Private channels (Exceptions) |
| 39 | + |
| 40 | +- **Purpose**: Confidential coordination and sensitive matters that cannot be discussed publicly. Access will be restricted to designated maintainers. |
| 41 | +- **Strict criteria for private use**: |
| 42 | + - **Security incidents** (CVEs, protocol vulnerabilities). |
| 43 | + - **People matters** (maintainer-related discussions, code of conduct policies). |
| 44 | + - Select channels will be configured to be **read-only**. This can be good for example for maintainer decision making. |
| 45 | + - Coordination requiring **immediate** or otherwise **focused response** with a limited audience. |
| 46 | +- **Transparency**: |
| 47 | + - **All technical and governance decisions** affecting the community **must be documented** in RFDs, GitHub Discussions and/or Issues. |
| 48 | + - **Some matters related to individual contributors** may remain private when appropriate (e.g., personal circumstances, disciplinary actions, or other sensitive individual matters). |
| 49 | + - Private channels are to be used as **temporary "incident rooms,"** not for routine development. |
| 50 | + |
| 51 | +Any significant discussion on Zulip leads to a potential decision or proposal must be moved to an RFD, GitHub Discussion, or GitHub Issue to create a persistent, searchable record. Proposals will then be promoted to full-fledged PRs with associated work items as needed. |
| 52 | + |
| 53 | +### RFDs |
| 54 | + |
| 55 | +Please refer to the [RFD process](https://agentclientprotocol.com/rfds/about) for how this is managed. This is the primary way to actually create changes to the protocol. |
| 56 | + |
| 57 | +Conversation about a given RFD can take place within the relevant PRs created to move the RFD forward. Or, a discussion within Zulip can be created in the `rfds` channel to discuss in real-time with other contributors. |
| 58 | + |
| 59 | +### GitHub Discussions |
| 60 | + |
| 61 | +For structured, long-form discussion and debate on project direction, features, improvements, and community topics. |
| 62 | + |
| 63 | +When to use: |
| 64 | + |
| 65 | +- Announcements and release communications |
| 66 | +- Community polls and consensus-building processes |
| 67 | +- Feature requests with context and rationale |
| 68 | + - If a particular repository does not have GitHub Discussions enabled, feel free to open a GitHub Issue instead. |
| 69 | + |
| 70 | +### GitHub Issues |
| 71 | + |
| 72 | +For bug reports, feature tracking, and actionable development tasks. |
| 73 | + |
| 74 | +When to use: |
| 75 | + |
| 76 | +- Bug reports with reproducible steps |
| 77 | +- Documentation improvements with specific scope |
| 78 | +- CI/CD problems and infrastructure issues |
| 79 | +- Release tasks and milestone tracking |
| 80 | + |
| 81 | +### Security Issues |
| 82 | + |
| 83 | +**Do not post security issues publicly.** Instead: |
| 84 | + |
| 85 | +1. Contact lead and/or core maintainers, or [email protected] directly. |
| 86 | +2. Follow responsible disclosure guidelines. |
0 commit comments