Skip to content

docs: add instructions for code review, commit message, and changelog generation#2491

Merged
rinatkhaziev merged 12 commits intotrunkfrom
add/copilot-instructions
Aug 14, 2025
Merged

docs: add instructions for code review, commit message, and changelog generation#2491
rinatkhaziev merged 12 commits intotrunkfrom
add/copilot-instructions

Conversation

@sjinks
Copy link
Copy Markdown
Member

@sjinks sjinks commented Aug 7, 2025

Description

This commit introduces new documentation files that provide clear guidelines for generating code reviews, commit messages, and technical/user-facing changelogs. These instructions aim to ensure consistency and clarity in the development process.

Key Changes:

  • Added code-review.instructions.md for AI-assisted code reviews.
  • Added commit-message.instructions.md to standardize commit messages.
  • Added tech-changelog.instructions.md for generating technical changelogs.
  • Added user-changelog.instructions.md for user-facing changelog entries.

These documents will help maintain high-quality contributions and improve the overall developer experience.

@sjinks sjinks requested a review from Copilot August 7, 2025 14:34
@sjinks sjinks self-assigned this Aug 7, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Aug 7, 2025

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

Copy link
Copy Markdown
Contributor

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 adds comprehensive documentation for standardizing development processes through AI-assisted tooling. It introduces four instruction files that establish guidelines for code reviews, commit messages, and changelog generation to ensure consistency across the project.

  • Adds structured templates for AI-generated code reviews with focus on security, performance, and maintainability
  • Establishes Conventional Commits format with detailed body requirements and scope guidelines
  • Creates separate instruction sets for technical and user-facing changelog generation

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
.github/instructions/code-review.instructions.md Defines comprehensive code review format and criteria for AI assistants
.github/instructions/commit-message.instructions.md Establishes Conventional Commits standard with required body structure
.github/instructions/tech-changelog.instructions.md Provides guidelines for generating technical changelogs for developers
.github/instructions/user-changelog.instructions.md Sets format for user-friendly changelogs without technical jargon

@rinatkhaziev
Copy link
Copy Markdown
Contributor

This is awesome, I think it would be even more awesome to make it generate the doc draft to kickstart Yoli's work.

@sjinks sjinks force-pushed the add/copilot-instructions branch from 4fb9b6d to d5e4b09 Compare August 10, 2025 21:30
@sjinks
Copy link
Copy Markdown
Member Author

sjinks commented Aug 10, 2025

This is how the /dependency-audit command works:

dependency-audit-edited.mp4

See #2497 for the actual report

@sjinks sjinks mentioned this pull request Aug 10, 2025
13 tasks
@sjinks
Copy link
Copy Markdown
Member Author

sjinks commented Aug 10, 2025

Automatic commit message generation:

commit-message.mp4

@sjinks sjinks force-pushed the add/copilot-instructions branch from 68e411f to cae0d9e Compare August 11, 2025 03:33
sjinks and others added 8 commits August 13, 2025 04:38
… generation

This commit introduces new documentation files that provide clear
guidelines for generating code reviews, commit messages, and
technical/user-facing changelogs. These instructions aim to ensure
consistency and clarity in the development process.

Key Changes:
- Added `code-review.instructions.md` for AI-assisted code reviews.
- Added `commit-message.instructions.md` to standardize commit messages.
- Added `tech-changelog.instructions.md` for generating technical changelogs.
- Added `user-changelog.instructions.md` for user-facing changelog entries.

These documents will help maintain high-quality contributions and
improve the overall developer experience.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Introduces a new prompt for auditing dependencies in Node.js/TypeScript projects.
This includes detailed instructions for dependency discovery, version analysis,
security vulnerability scanning, license compliance, and more.

The prompt aims to enhance security and maintainability by providing structured
guidance for developers to assess and optimize their project dependencies.
This commit introduces a comprehensive security audit prompt
specifically designed for Node.js and TypeScript CLI applications.
The prompt outlines detailed instructions for performing a
systematic security assessment, including guidelines for
dependency security, input validation, and secrets management.

Key changes include:
- Added sections for various security concerns
- Included required tools and commands for the audit process
- Provided a structured format for reporting findings

This enhancement aims to improve security practices within
Node.js/TypeScript projects by providing clear guidance
for developers.
@sjinks sjinks force-pushed the add/copilot-instructions branch from 8c653cd to c3a1bf8 Compare August 13, 2025 01:38
@sjinks sjinks marked this pull request as ready for review August 14, 2025 05:31
sjinks added 2 commits August 14, 2025 11:08
Added emphasis on prioritizing semantic search throughout the
dependency audit process to improve identification of actual
dependency usage patterns and potential issues. Updated
instructions to include specific semantic search applications
across various audit steps for better clarity and effectiveness.
Enhanced the installation process for Semgrep and CodeQL by adding
fallback options and architecture detection. This ensures a smoother
setup experience for users on different systems.

Key changes include:
- Added snap installation option for Semgrep on Ubuntu.
- Implemented architecture detection for CodeQL download.
- Improved checks for existing installations.

No functional changes to the security audit process.
@sonarqubecloud
Copy link
Copy Markdown

@rinatkhaziev rinatkhaziev merged commit 6e36477 into trunk Aug 14, 2025
19 checks passed
@rinatkhaziev rinatkhaziev deleted the add/copilot-instructions branch August 14, 2025 23:20
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.

3 participants