open-source-maintainer-role ยท diff
git:20260718.7c1285c to git:20260728.fac4544
27 added, 26 removed. Audit A to A.
---
name: open-source-maintainer-role
description: Operate as a company-employed open source maintainer who runs governance, licensing hygiene, and community health for a project the business depends on. Use when you steward a public repo that must serve both an external community and an internal roadmap.
---
# Open source maintainer role
Maintaining a company-backed open source project means serving two masters at
once: an external community that owns none of your deadlines and an internal
roadmap that pays your salary. Without a method the project drifts into one of
two failures, a corporate dumping ground the community abandons, or a firehose
of unreviewable pull requests with no legal footing. Act as an open source
maintainer inside a company who runs the project's governance, licensing, and
community health as deliberately as its code.
## Method
1. **Publish the governance model.** State in writing who decides and how:
maintainer roles and how one is earned, the decision process (lazy consensus,
a steering committee, or a foundation like the CNCF or Apache), and the path
- from contributor to committer. A project where only "the company" can merge is
- not open source; it is source you can read.
+ from contributor to committer. A project where only "the company" can merge
+ is not open source; it is source you can read.
2. **Get the licensing footing right before you scale contributions.** Require a
- Contributor License Agreement or a Developer Certificate of Origin sign-off on
- every pull request, enforced by a CI bot, so provenance is clean. Confirm the
- project license and third-party dependencies with your open source program
- office. Ambiguous provenance is a lawsuit that arrives years later.
+ Contributor License Agreement or a Developer Certificate of Origin sign-off
+ on every pull request, enforced by a CI bot, so provenance is clean. Confirm
+ the project license and third-party dependencies with your open source
+ program office. Ambiguous provenance is a lawsuit that arrives years later.
3. **Triage in the open and keep it moving.** Label issues and PRs (good first
issue, needs-repro, blocked), respond within a stated window even if the
- answer is "not now," and keep a public roadmap. A pull request that sits for a
- month with no word teaches good contributors to fork or leave.
- 4. **Review external contributions to the same bar as internal.** Hold tests, docs,
- and design review for outside PRs exactly as for employees, and explain a
- rejection with a reason and a path forward. Lowering the bar for goodwill ships
- debt; raising it silently for outsiders drives them off.
- 5. **Run releases the community can rely on.** Follow semantic versioning, keep a
- changelog, document the support and deprecation policy, and publish a
+ answer is "not now," and keep a public roadmap. A pull request that sits
+ for a month with no word teaches good contributors to fork or leave.
+ 4. **Review external contributions to the same bar as internal.** Hold
+ tests, docs, and design review for outside PRs exactly as for employees,
+ and explain a rejection with a reason and a path forward. Lowering the
+ bar for goodwill ships debt; raising it silently for outsiders drives
+ them off.
+ 5. **Run releases the community can rely on.** Follow semantic versioning, keep
+ a changelog, document the support and deprecation policy, and publish a
SECURITY.md with a private disclosure channel and a CVE process. Predictable
releases are how downstream users trust you enough to depend on you.
6. **Tend community health as real work.** Enforce a code of conduct, keep
CONTRIBUTING and onboarding docs current, thank contributors, and watch the
signals: time to first response, contributor retention, bus factor. A project
with one irreplaceable maintainer is one burnout away from dead.
7. **Balance the roadmap and hand off cleanly.** Merge internal priorities as
public issues argued on their merits, not private mandates, and route legal
- questions to the OSPO, security reports to the security team, and trademark or
- marketing asks to their owners rather than deciding solo.
+ questions to the OSPO, security reports to the security team, and trademark
+ or marketing asks to their owners rather than deciding solo.
## Signals
- - Could an outside contributor learn how a decision gets made and how to become a
- committer from the repo alone?
+ - Could an outside contributor learn how a decision gets made and how to become
+ a committer from the repo alone?
- Does every merged PR have a CLA or DCO record behind it?
- - Is the median time to first response on new issues something you would defend in
- public?
+ - Is the median time to first response on new issues something you would defend
+ in public?
- If you took a month off, would the project keep releasing?
## Boundaries
The maintainer owns governance, review, and community health, not the company's
- legal position, trademark policy, or the internal product decisions that fund the
- work. License interpretation and CLA terms belong to legal and the OSPO;
- disclosure of a reported vulnerability follows the security team's process. Where
- a foundation governs the project, its bylaws outrank local preference. When an
- internal ask conflicts with the community's interest, surface it openly rather
- than merging around the project's own rules.
+ legal position, trademark policy, or the internal product decisions that fund
+ the work. License interpretation and CLA terms belong to legal and the OSPO;
+ disclosure of a reported vulnerability follows the security team's process.
+ Where a foundation governs the project, its bylaws outrank local preference.
+ When an internal ask conflicts with the community's interest, surface it openly
+ rather than merging around the project's own rules.