Skip to content

docs: add Claude workflow automation and streamline CLAUDE.md#83

Merged
joshsmithxrm merged 5 commits intomainfrom
docs/claude-workflow-updates
Jan 2, 2026
Merged

docs: add Claude workflow automation and streamline CLAUDE.md#83
joshsmithxrm merged 5 commits intomainfrom
docs/claude-workflow-updates

Conversation

@joshsmithxrm
Copy link
Copy Markdown
Owner

Summary

  • Add /pre-pr slash command for pre-commit validation
  • Add /review-bot-comments slash command for triaging bot findings
  • Add pre-commit hook to block commits with failing builds/tests
  • Streamline CLAUDE.md documentation
  • Add testing requirements table (identifies Auth, Migration need test projects)
  • Add bot review handling guidance

New Files

File Purpose
.claude/commands/pre-pr.md Validates build, tests, changelog before commit
.claude/commands/review-bot-comments.md Pulls and triages bot review comments
.claude/hooks/pre-commit-validate.py Pre-commit hook for build/test validation
.claude/settings.json Hook configuration

Test plan

  • Commands are valid markdown
  • Hook script is executable Python
  • Manual test of /pre-pr command
  • Manual test of /review-bot-comments command

🤖 Generated with Claude Code

- Add /pre-pr command for pre-commit validation (build, test, changelog check)
- Add /review-bot-comments command for triaging bot review findings
- Add pre-commit hook to validate builds/tests before commit
- Update development workflow to reference new commands
- Streamline CLAUDE.md (remove verbose namespace examples, simplify comments section)
- Add testing requirements table showing coverage gaps (Auth, Migration need tests)
- Add bot review handling guidance

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings January 2, 2026 06:33
@gemini-code-assist
Copy link
Copy Markdown

Summary of Changes

Hello @joshsmithxrm, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the development workflow by integrating new automation tools and updating documentation. It introduces two new slash commands, /pre-pr for comprehensive pre-commit validation and /review-bot-comments for efficient triaging of AI-generated review comments. Additionally, a pre-commit hook is added to enforce build and test success before commits. The CLAUDE.md documentation is also significantly revised to incorporate these new tools and provide clearer guidelines for testing and managing bot feedback, aiming to improve code quality and streamline the PR process.

Highlights

  • New Slash Command for Pre-PR Validation: Introduces a /pre-pr slash command to perform comprehensive validation before creating a pull request, checking build status, tests, new public APIs, common code issues, changelog updates, and test coverage.
  • New Slash Command for Bot Comment Triage: Adds a /review-bot-comments slash command to systematically fetch and triage review comments from AI bots like Copilot, Gemini, and CodeQL, providing guidance on how to handle valid findings versus false positives.
  • Automated Pre-commit Hook: Implements a Python-based pre-commit hook that automatically runs dotnet build and dotnet test on every git commit, blocking the commit if any build or test failures are detected.
  • Streamlined Documentation: Updates the CLAUDE.md documentation to reflect the new automation workflows, simplify code convention guidelines, and introduce structured testing requirements and clear guidance for handling bot review comments.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces valuable automation for the development workflow, including a /pre-pr command for validation and a /review-bot-comments command for triaging bot feedback. It also adds a pre-commit hook to ensure builds and tests pass before any commit, which is a great quality gate. The CLAUDE.md documentation has been significantly streamlined and updated to reflect these new processes, improving clarity for developers. My review found one area for improvement in the new pre-commit hook script to make it more robust against missing dependencies. Overall, these are excellent additions to the repository.

@joshsmithxrm
Copy link
Copy Markdown
Owner Author

@gemini-code-assist review

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces Claude workflow automation to streamline the development process by adding pre-commit validation and bot review triage capabilities. The changes focus on improving developer productivity through automated checks and systematic handling of automated code review feedback.

  • Adds two new slash commands (/pre-pr and /review-bot-comments) for pre-commit validation and bot review triage
  • Implements a Python-based pre-commit hook that validates builds and tests before allowing commits
  • Streamlines CLAUDE.md documentation by condensing examples and adding structured guidance tables for testing requirements and bot review handling

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
CLAUDE.md Updated workflow steps, added testing requirements table showing test coverage status, added bot review handling guidance, and documented new Claude commands/hooks
.claude/settings.json Configures PreToolUse hook to trigger pre-commit validation on Bash commands
.claude/hooks/pre-commit-validate.py Python script that runs dotnet build and test, blocking commits if either fails
.claude/commands/review-bot-comments.md Documents workflow for fetching and triaging PR review comments from automated bots
.claude/commands/pre-pr.md Documents pre-PR validation command that checks build, tests, documentation, and changelog

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces workflow automation using Claude commands and a pre-commit hook, and also significantly streamlines the CLAUDE.md documentation. The new commands for pre-PR validation and bot comment review are well-documented and the pre-commit hook is a great addition for enforcing quality before code is committed. The documentation changes in CLAUDE.md improve clarity and add valuable guidance on testing and handling bot reviews. My review focuses on the new pre-commit hook script, for which I've suggested a couple of improvements to make it more robust. Overall, this is an excellent pull request that improves the development workflow and project documentation.

joshsmithxrm and others added 3 commits January 2, 2026 00:39
- Add warning message on JSON parse failure (#9)
- Handle FileNotFoundError when dotnet not in PATH (#1, #12)
- Add 5-minute timeout to subprocess calls (#11)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Use shlex.split for robust git commit detection (#2)
- Print both stdout and stderr on build/test failure (#3, #4)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@joshsmithxrm joshsmithxrm merged commit 26840ad into main Jan 2, 2026
3 checks passed
@github-project-automation github-project-automation bot moved this from Todo to Done in PPDS Roadmap Jan 2, 2026
@joshsmithxrm joshsmithxrm deleted the docs/claude-workflow-updates branch January 3, 2026 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants