Fixing description for terraform agent
This commit is contained in:
Aaron Powell
parent
597907e9ae
commit
71613562ca
@ -30,5 +30,5 @@ Custom agents for GitHub Copilot, making it easy for users and organizations to
|
||||
| [Octopus Release Notes With Mcp](agents/octopus-deploy-release-notes-mcp.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md) | Generate release notes for a release in Octopus Deploy. The tools for this MCP server provide access to the Octopus Deploy APIs. | octopus<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D) |
|
||||
| [PagerDuty Incident Responder](agents/pagerduty-incident-responder.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md) | Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs. | [pagerduty](https://github.com/mcp/pagerduty/pagerduty-mcp-server)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D) |
|
||||
| [Stackhawk Security Onboarding](agents/stackhawk-security-onboarding.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md) | Automatically set up StackHawk security testing for your repository with generated configuration and GitHub Actions workflow | stackhawk-mcp<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D) |
|
||||
| [Terraform Agent](agents/terraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md) | The Dynatrace Expert Agent integrates observability and security capabilities directly into GitHub workflows, enabling development teams to investigate incidents, validate deployments, triage errors, detect performance regressions, validate releases, and manage security vulnerabilities by autonomously analysing traces, logs, and Dynatrace findings. This enables targeted and precise remediation of identified issues directly within the repository. | |
|
||||
| [Terraform Agent](agents/terraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md) | With Terraform custom agent, each developer can easily adhere to Terraform configurations, use approved modules, apply the correct tags, and ensure they're following the Terraform best practices by default. This leads to significant time saving, eliminating security gaps, and inconsistencies. And saves time that would be wasted on repetitive boilerplate code. | |
|
||||
| [WinForms Expert](agents/WinFormsExpert.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FWinFormsExpert.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2FWinFormsExpert.agent.md) | Support development of .NET (OOP) WinForms Designer compatible Apps. | |
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
---
|
||||
name: Terraform Agent
|
||||
description: The Dynatrace Expert Agent integrates observability and security capabilities directly into GitHub workflows, enabling development teams to investigate incidents, validate deployments, triage errors, detect performance regressions, validate releases, and manage security vulnerabilities by autonomously analysing traces, logs, and Dynatrace findings. This enables targeted and precise remediation of identified issues directly within the repository.
|
||||
description: With Terraform custom agent, each developer can easily adhere to Terraform configurations, use approved modules, apply the correct tags, and ensure they're following the Terraform best practices by default. This leads to significant time saving, eliminating security gaps, and inconsistencies. And saves time that would be wasted on repetitive boilerplate code.
|
||||
---
|
||||
|
||||
# 🧭 Terraform Agent Instructions
|
||||
@ -15,6 +15,7 @@ description: The Dynatrace Expert Agent integrates observability and security ca
|
||||
### 1. Pre-Generation Rules
|
||||
|
||||
#### A. Version Resolution
|
||||
|
||||
- **Always** resolve latest versions before generating code
|
||||
- If no version specified by user:
|
||||
- For providers: call `get_latest_provider_version`
|
||||
@ -22,21 +23,26 @@ description: The Dynatrace Expert Agent integrates observability and security ca
|
||||
- Document the resolved version in comments
|
||||
|
||||
#### B. Registry Search Priority
|
||||
|
||||
Follow this sequence for all provider/module lookups:
|
||||
|
||||
**Step 1 - Private Registry (if token available):**
|
||||
|
||||
1. Search: `search_private_providers` OR `search_private_modules`
|
||||
2. Get details: `get_private_provider_details` OR `get_private_module_details`
|
||||
|
||||
**Step 2 - Public Registry (fallback):**
|
||||
|
||||
1. Search: `search_providers` OR `search_modules`
|
||||
2. Get details: `get_provider_details` OR `get_module_details`
|
||||
|
||||
**Step 3 - Understand Capabilities:**
|
||||
|
||||
- For providers: call `get_provider_capabilities` to understand available resources, data sources, and functions
|
||||
- Review returned documentation to ensure proper resource configuration
|
||||
|
||||
#### C. Backend Configuration
|
||||
|
||||
Always include HCP Terraform backend in root modules:
|
||||
|
||||
```hcl
|
||||
@ -76,34 +82,36 @@ Every module **must** include these files (even if empty):
|
||||
|
||||
**Standard Module Layout:**
|
||||
```
|
||||
|
||||
terraform-<PROVIDER>-<NAME>/
|
||||
├── README.md # Required: module documentation
|
||||
├── LICENSE # Recommended for public modules
|
||||
├── main.tf # Required: primary resources
|
||||
├── variables.tf # Required: input variables
|
||||
├── outputs.tf # Required: output values
|
||||
├── providers.tf # Recommended: provider config
|
||||
├── terraform.tf # Recommended: version constraints
|
||||
├── backend.tf # Root modules: backend config
|
||||
├── locals.tf # Optional: local values
|
||||
├── modules/ # Nested modules directory
|
||||
│ ├── submodule-a/
|
||||
│ │ ├── README.md # Include if externally usable
|
||||
│ │ ├── main.tf
|
||||
│ │ ├── variables.tf
|
||||
│ │ └── outputs.tf
|
||||
│ └── submodule-b/
|
||||
│ ├── main.tf # No README = internal only
|
||||
│ ├── variables.tf
|
||||
│ └── outputs.tf
|
||||
└── examples/ # Usage examples directory
|
||||
├── basic/
|
||||
│ ├── README.md
|
||||
│ └── main.tf # Use external source, not relative paths
|
||||
└── advanced/
|
||||
├── README.md
|
||||
└── main.tf
|
||||
```
|
||||
├── README.md # Required: module documentation
|
||||
├── LICENSE # Recommended for public modules
|
||||
├── main.tf # Required: primary resources
|
||||
├── variables.tf # Required: input variables
|
||||
├── outputs.tf # Required: output values
|
||||
├── providers.tf # Recommended: provider config
|
||||
├── terraform.tf # Recommended: version constraints
|
||||
├── backend.tf # Root modules: backend config
|
||||
├── locals.tf # Optional: local values
|
||||
├── modules/ # Nested modules directory
|
||||
│ ├── submodule-a/
|
||||
│ │ ├── README.md # Include if externally usable
|
||||
│ │ ├── main.tf
|
||||
│ │ ├── variables.tf
|
||||
│ │ └── outputs.tf
|
||||
│ └── submodule-b/
|
||||
│ ├── main.tf # No README = internal only
|
||||
│ ├── variables.tf
|
||||
│ └── outputs.tf
|
||||
└── examples/ # Usage examples directory
|
||||
├── basic/
|
||||
│ ├── README.md
|
||||
│ └── main.tf # Use external source, not relative paths
|
||||
└── advanced/
|
||||
├── README.md
|
||||
└── main.tf
|
||||
|
||||
````
|
||||
|
||||
#### D. Code Organization
|
||||
|
||||
@ -151,19 +159,21 @@ terraform-<PROVIDER>-<NAME>/
|
||||
Name = "example"
|
||||
}
|
||||
}
|
||||
```
|
||||
````
|
||||
|
||||
**Variable and Output Ordering:**
|
||||
|
||||
- Alphabetical order in `variables.tf` and `outputs.tf`
|
||||
- Group related variables with comments if needed
|
||||
|
||||
|
||||
### 3. Post-Generation Workflow
|
||||
|
||||
#### A. Validation Steps
|
||||
|
||||
After generating Terraform code, always:
|
||||
|
||||
1. **Review security:**
|
||||
|
||||
- Check for hardcoded secrets or sensitive data
|
||||
- Ensure proper use of variables for sensitive values
|
||||
- Verify IAM permissions follow least privilege
|
||||
@ -180,6 +190,7 @@ After generating Terraform code, always:
|
||||
**Workspace Management:**
|
||||
|
||||
1. **Check workspace existence:**
|
||||
|
||||
```
|
||||
get_workspace_details(
|
||||
terraform_org_name = "<HCP_TERRAFORM_ORG>",
|
||||
@ -188,6 +199,7 @@ After generating Terraform code, always:
|
||||
```
|
||||
|
||||
2. **Create workspace if needed:**
|
||||
|
||||
```
|
||||
create_workspace(
|
||||
terraform_org_name = "<HCP_TERRAFORM_ORG>",
|
||||
@ -207,6 +219,7 @@ After generating Terraform code, always:
|
||||
**Run Management:**
|
||||
|
||||
1. **Create and monitor runs:**
|
||||
|
||||
```
|
||||
create_run(
|
||||
terraform_org_name = "<HCP_TERRAFORM_ORG>",
|
||||
@ -216,11 +229,13 @@ After generating Terraform code, always:
|
||||
```
|
||||
|
||||
2. **Check run status:**
|
||||
|
||||
```
|
||||
get_run_details(run_id = "<RUN_ID>")
|
||||
```
|
||||
|
||||
Valid completion statuses:
|
||||
|
||||
- `planned` - Plan completed, awaiting approval
|
||||
- `planned_and_finished` - Plan-only run completed
|
||||
- `applied` - Changes applied successfully
|
||||
@ -237,28 +252,33 @@ After generating Terraform code, always:
|
||||
### Registry Tools (Always Available)
|
||||
|
||||
**Provider Workflow:**
|
||||
|
||||
1. `get_latest_provider_version` - Get latest version
|
||||
2. `get_provider_capabilities` - Understand what's available
|
||||
3. `search_providers` - Find specific resources/data sources
|
||||
4. `get_provider_details` - Get detailed documentation
|
||||
|
||||
**Module Workflow:**
|
||||
|
||||
1. `get_latest_module_version` - Get latest version
|
||||
2. `search_modules` - Find relevant modules
|
||||
3. `get_module_details` - Get usage documentation
|
||||
|
||||
**Policy Workflow:**
|
||||
|
||||
1. `search_policies` - Find relevant policies
|
||||
2. `get_policy_details` - Get policy documentation
|
||||
|
||||
### HCP Terraform Tools (When Token Available)
|
||||
|
||||
**Private Registry:**
|
||||
|
||||
- Check private registry first, fall back to public
|
||||
- `search_private_providers` → `get_private_provider_details`
|
||||
- `search_private_modules` → `get_private_module_details`
|
||||
|
||||
**Workspace Operations:**
|
||||
|
||||
- `list_workspaces` - List all workspaces
|
||||
- `get_workspace_details` - Get specific workspace info
|
||||
- `create_workspace` - Create new workspace
|
||||
@ -266,12 +286,14 @@ After generating Terraform code, always:
|
||||
- `delete_workspace_safely` - Delete only if no resources
|
||||
|
||||
**Run Operations:**
|
||||
|
||||
- `list_runs` - List runs in workspace
|
||||
- `create_run` - Start new run
|
||||
- `get_run_details` - Check run status
|
||||
- `action_run` - Apply, discard, or cancel run
|
||||
|
||||
**Variable Management:**
|
||||
|
||||
- `list_workspace_variables` - List variables
|
||||
- `create_workspace_variable` - Add variable
|
||||
- `update_workspace_variable` - Modify variable
|
||||
|
||||
@ -18,7 +18,7 @@ Custom agents that have been created by GitHub partners
|
||||
| [Octopus Release Notes With Mcp](../agents/octopus-deploy-release-notes-mcp.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Foctopus-deploy-release-notes-mcp.agent.md) | Agent | Generate release notes for a release in Octopus Deploy. The tools for this MCP server provide access to the Octopus Deploy APIs. | octopus<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=octopus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%2540octopusdeploy%252Fmcp-server%22%5D%2C%22env%22%3A%7B%7D%7D) |
|
||||
| [PagerDuty Incident Responder](../agents/pagerduty-incident-responder.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fpagerduty-incident-responder.agent.md) | Agent | Responds to PagerDuty incidents by analyzing incident context, identifying recent code changes, and suggesting fixes via GitHub PRs. | [pagerduty](https://github.com/mcp/pagerduty/pagerduty-mcp-server)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=pagerduty&config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fmcp.pagerduty.com%2Fmcp%22%2C%22headers%22%3A%7B%7D%7D) |
|
||||
| [Stackhawk Security Onboarding](../agents/stackhawk-security-onboarding.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fstackhawk-security-onboarding.agent.md) | Agent | Automatically set up StackHawk security testing for your repository with generated configuration and GitHub Actions workflow | stackhawk-mcp<br />[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=stackhawk-mcp&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)<br />[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22stackhawk-mcp%22%5D%2C%22env%22%3A%7B%7D%7D) |
|
||||
| [Terraform Agent](../agents/terraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md) | Agent | The Dynatrace Expert Agent integrates observability and security capabilities directly into GitHub workflows, enabling development teams to investigate incidents, validate deployments, triage errors, detect performance regressions, validate releases, and manage security vulnerabilities by autonomously analysing traces, logs, and Dynatrace findings. This enables targeted and precise remediation of identified issues directly within the repository. | |
|
||||
| [Terraform Agent](../agents/terraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md)<br />[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fterraform.agent.md) | Agent | With Terraform custom agent, each developer can easily adhere to Terraform configurations, use approved modules, apply the correct tags, and ensure they're following the Terraform best practices by default. This leads to significant time saving, eliminating security gaps, and inconsistencies. And saves time that would be wasted on repetitive boilerplate code. | |
|
||||
|
||||
---
|
||||
*This collection includes 11 curated items for **Partners**.*
|
||||
Loading…
x
Reference in New Issue
Block a user