Skip to content
This repository was archived by the owner on Apr 6, 2026. It is now read-only.

27 copilot reimagine prompts - plan, implement, apply!#28

Merged
arnaudlh merged 13 commits intomicrosoft:mainfrom
raffertyuy:27-copilot-reimagine-prompts
Aug 12, 2025
Merged

27 copilot reimagine prompts - plan, implement, apply!#28
arnaudlh merged 13 commits intomicrosoft:mainfrom
raffertyuy:27-copilot-reimagine-prompts

Conversation

@raffertyuy
Copy link
Copy Markdown
Contributor

@raffertyuy raffertyuy commented Jul 28, 2025

Reimagined the way to vibe-code new terraform modules. The steps are now as follows

  1. Run Azure and Terraform MCP servers
  2. Use the new aztf-agent chat mode
  3. /1-plan <module_name> which generates a new *.plan.md file - for review and modification
  4. /2-implement <module_name> which implements the generated plan
  5. /3-apply <module_name> which runs terraform apply against your Azure subscription (and fixes issues as needed).

Other .md files were also changed so that instructions are clear to copilot.
To test, dev_center_environment_type has been reimplemented.

In addition, dev_center_network_connections was migrated from AzureRM to AzAPI to fix CI (terraform test) issues.

Copilot Generated PR Outline

New Features and Enhancements

  • Added a new chat mode aztf-agent.chatmode.md to describe an AI-powered agent for implementing Azure Terraform modules, along with a comprehensive list of tools available to the agent.
  • Introduced structured prompts for planning (1-plan.prompt.md), step-by-step implementation (2-implement.prompt.md), and testing (3-apply.prompt.md) of Terraform modules, emphasizing modularity, validation, and adherence to project standards. [1] [2] [3]

Updates to Development Guidelines

  • Replaced the outdated copilot-instructions.md with a new comprehensive set of general development guidelines for the DevFactory project, covering core rules, file structure, communication standards, CLI usage, quality standards, and modular patterns.
  • Updated Terraform-specific instructions (tf.instructions.md) to enforce the exclusive use of the AzAPI provider (v2.4.0), added default region guidance (eastus), and clarified restrictions on using the azurerm provider. [1] [2] [3] [4]

File Restructuring

  • Renamed .github/instructions/devbox-tf.instructions.md to .github/instructions/tf.instructions.md to align with the new modular file naming conventions.

Deprecation and Cleanup

  • Removed the outdated devbox-tf.prompt.md file, consolidating its content into the new structured prompts and instructions.

These changes aim to streamline the development process, enforce best practices, and provide clear, actionable guidance for working with Azure Terraform modules.

- Created a new prompt for improving testing.md documentation to enhance clarity and eliminate redundancy.
- Added a changelog to document notable changes and improvements in testing documentation.
- Updated testing.md to streamline content, improve formatting, and ensure essential information is preserved.
- Consolidated testing instructions to maintain a single source of truth and improve user experience.
- Updated `.github/copilot-instructions.md` to provide clearer guidelines on project structure and documentation requirements.
- Created new `.github/instructions/tf.instructions.md` file to outline Terraform implementation guidelines.
- Added new prompts in `.github/prompts/` for planning, implementing, and testing Terraform modules.
- Deleted outdated `.github/prompts/devbox-tf.prompt.md` to streamline prompt files.
- Introduced `docs/file-structure.md` to detail the organization of project files and folders.
- Modified `docs/module_guide.md` to include additional features and improve clarity on environment type configurations.
@raffertyuy
Copy link
Copy Markdown
Contributor Author

Integration tests are failing because dev_center_network_connection is still dependent on the AzureRM provider. Fixing this.

- Updated the `dev_center_network_connection` module to use the `azapi` provider instead of `azurerm`.
- Modified `module.tf` to replace `azurerm_dev_center_network_connection` with `azapi_resource`.
- Adjusted output values in `output.tf` to reflect changes in resource type.
- Updated `README.md` and `variables.tf` to align with the new provider and resource structure.
- Enhanced configuration examples in `configuration.tfvars` for both enhanced and simple cases.
- Ensured compatibility with existing module interfaces while improving internal implementation.
@raffertyuy raffertyuy requested a review from arnaudlh July 28, 2025 11:04
@raffertyuy raffertyuy force-pushed the 27-copilot-reimagine-prompts branch from a69210a to d6e7680 Compare July 29, 2025 09:44
Copy link
Copy Markdown
Collaborator

@arnaudlh arnaudlh left a comment

Choose a reason for hiding this comment

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

Please

Comment thread examples/dev_center_network_connection/enhanced_case/configuration.tfvars Outdated
@arnaudlh arnaudlh merged commit 6dad2a5 into microsoft:main Aug 12, 2025
18 checks passed
@raffertyuy raffertyuy deleted the 27-copilot-reimagine-prompts branch August 12, 2025 03:18
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Copilot - Reimagine Prompts

2 participants