Skip to content

docs: add commit message formatting guidelines to AGENTS.md#58629

Merged
Keno merged 2 commits intomasterfrom
kf/claude-commit-guidelines
Jun 4, 2025
Merged

docs: add commit message formatting guidelines to AGENTS.md#58629
Keno merged 2 commits intomasterfrom
kf/claude-commit-guidelines

Conversation

@Keno
Copy link
Copy Markdown
Member

@Keno Keno commented Jun 3, 2025

Add two additional guidelines for commit message formatting:

  • When referencing external GitHub PRs or issues, use proper GitHub
    interlinking format (e.g., owner/repo#123)
  • When fixing CI failures, include the link to the specific CI failure
    in the commit message

These guidelines help improve commit message clarity and traceability.

Add two additional guidelines for commit message formatting:
- When referencing external GitHub PRs or issues, use proper GitHub
  interlinking format (e.g., owner/repo#123)
- When fixing CI failures, include the link to the specific CI failure
  in the commit message

These guidelines help improve commit message clarity and traceability.
@giordano
Copy link
Copy Markdown
Member

giordano commented Jun 3, 2025

I think these instructions are totally reasonable for human beings, too.

@Keno
Copy link
Copy Markdown
Member Author

Keno commented Jun 3, 2025

Yeah, but the AI actually reads docs ;)

Add guidance for modifying external dependencies, including:
- Testing with USE_BINARYBUILDER=0 to ensure source builds work
- Verifying patches apply cleanly and dependencies build successfully
- Preferring full upstream commits in git am format for proper metadata
- Ensuring patches still apply when updating dependency versions

These steps help prevent build failures in environments that build
from source rather than using prebuilt binaries.
@Keno
Copy link
Copy Markdown
Member Author

Keno commented Jun 4, 2025

Updated this PR to tell the AI to test its deps changes to avoid a recurrence of #58628 (comment).

@Keno Keno merged commit fe7dc7d into master Jun 4, 2025
7 checks passed
@Keno Keno deleted the kf/claude-commit-guidelines branch June 4, 2025 23:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants