Skip to content

Commit 62df53f

Browse files
committed
docs: add open source maintainer rules to AGENTS.md
1 parent 1c35fbe commit 62df53f

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,3 +115,23 @@ Uses `@adobe/css-tools` as the sole production dependency to parse stylesheet ou
115115
- **CI workflow** (`.github/workflows/ci.yml`): `pull_request_target` trigger (uses base branch workflow). `permissions: contents: read`.
116116
- **Release workflow** (`.github/workflows/release.yml`): Changesets action with provenance-based npm publishing.
117117
- **CodeQL** (`.github/workflows/codeql-analysis.yml`): Weekly JavaScript analysis.
118+
119+
## Open Source Maintainer Rules
120+
121+
### Issues
122+
123+
- **Never mass-close or mass-comment.** Every response posted to an issue must be individually researched and evidence-backed with a fresh code experiment.
124+
- **Verify before closing.** Reproduce the reported scenario on the current version and confirm it's resolved before closing. Don't assume a fix covers an issue without testing.
125+
- **Be kind and appreciative.** Thank reporters for filing. Be respectful even when closing as stale or wontfix.
126+
- **Preserve original authorship.** When absorbing work from external PRs, credit the original author in the commit or PR description.
127+
128+
### PRs
129+
130+
- **No test plans in PR descriptions** unless explicitly requested.
131+
- **Credit contributors.** When closing a PR whose fix was absorbed into other work, comment thanking the author and linking to the release that includes their contribution.
132+
133+
### Code
134+
135+
- **Use TDD (red/green)** when fixing bugs — write the failing test first, then fix the code.
136+
- **Always run tests** before considering work done.
137+
- **Research before implementing.** Go beyond official docs — review dev blogs, expert content, and source code for the deepest understanding.

0 commit comments

Comments
 (0)