Skip to content

Conversation

tspascoal
Copy link
Collaborator

Add a step for the user to improve the instruction file using Copilot Generate Instructions capability

Add two IaC examples from copilot-awesome so users can see more elaborate instruction files
Added a reference to copilot-awesome repo

New best practice instruction files:

  • Added .github/instructions/bicep-code-best-practices.instructions.md with detailed conventions for Bicep Infrastructure as Code, covering naming, structure, parameters, variables, resource references, security, and documentation.
  • Added .github/instructions/terraform-azure.instructions.md with comprehensive Azure Terraform guidance, including DevOps principles, anti-patterns, code organization, AVM usage, secrets management, outputs, folder structure, Azure-specific practices, cost management, state management, and validation.

Documentation improvements for Copilot instructions:

  • Updated content/1-hour/3-copilot-instructions.md to add a section on using Copilot to generate or improve instructions, and to explain the use of specialized instructions files in .github/instructions for technology-specific best practices.
  • Added a reference link to the [github/awesome-copilot] repository for users seeking example instructions files.

…ructions with copilot

Add two IaC examples  from copilot-awesome so users can see more elaborate instruction files

Added a reference to copilot-awesome repo
@tspascoal tspascoal requested a review from GeekTrainer as a code owner October 8, 2025 16:44
@Copilot Copilot AI review requested due to automatic review settings October 8, 2025 16:44
Copy link
Contributor

@Copilot 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 enhances the Copilot instructions module by adding comprehensive guidance on using Copilot's Generate Instructions capability and expanding the documentation with specialized Infrastructure as Code examples.

  • Adds a new section on using Copilot to generate or improve instructions files
  • Introduces two new specialized instruction files for Bicep and Terraform Azure best practices
  • References the github/awesome-copilot repository for additional examples

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
content/1-hour/3-copilot-instructions.md Added section on generating instructions with Copilot and documentation for specialized instructions files
.github/instructions/terraform-azure.instructions.md New comprehensive Terraform Azure best practices instruction file with DevOps principles and security guidelines
.github/instructions/bicep-code-best-practices.instructions.md New Bicep Infrastructure as Code instruction file covering naming, structure, and security conventions

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

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.

1 participant