zhengruifeng opened a new pull request, #56143: URL: https://github.com/apache/spark/pull/56143
> Draft: JIRA ID is a placeholder (`SPARK-XXXXX`); will be filled in before the PR is marked ready. ### What changes were proposed in this pull request? Update the "Pull Request Workflow" section of `AGENTS.md`: - Replace the "take the last word and uppercase it" heuristic with explicit guidance to use the canonical tag from the `COMPONENTS` table in `dev/merge_spark_pr.py`, calling out the non-obvious mappings: `PySpark` → `[PYTHON]`, `Documentation` → `[DOC]`, `Structured Streaming` → `[SS]`, `DStreams` → `[STREAMING]`, `Pandas API on Spark` → `[PS]`, `Declarative Pipelines` → `[SDP]`. - Fix `Structured Streaming → [STREAMING]`; the script reserves `[STREAMING]` for DStreams and uses `[SS]` for Structured Streaming. - Add the full list of primary component tags and state that the title must include at least one. - Switch the placeholder format from `[SPARK-xxxx]` to `[SPARK-XXXXX]`. ### Why are the changes needed? The previous "last word and uppercase" heuristic gives the wrong tag for several JIRA components — most notably `Structured Streaming`, which is `[SS]`, not `[STREAMING]`. The `primary` flag introduced in `dev/merge_spark_pr.py` is also not documented in `AGENTS.md`, so agents have no way to know that a primary tag is required in the title. Aligning the docs with the script prevents agents from producing titles that the merge step would otherwise have to fix up. ### Does this PR introduce _any_ user-facing change? No. Documentation-only. ### How was this patch tested? Cross-checked every tag and the primary list against the `COMPONENTS` table in `dev/merge_spark_pr.py`. Verified `AGENTS.md` introduces only the same class of non-ASCII characters (em-dashes and arrows) already present in the file. ### Was this patch authored or co-authored using generative AI tooling? Generated-by: Claude Code (Opus 4.7) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
