Destroy Infrastructure
Use the destroy_forma MCP tool to remove infrastructure resources.
Destroy Modes
Destruction can be specified two ways (mutually exclusive):
- •By file: Destroys all resources declared in a forma file
- •By query: Destroys resources matching a query
Workflow
- •Clarify what the user wants to destroy
- •Always simulate first: call
destroy_formawithsimulate: true - •Present what will be destroyed — clearly and completely
- •Ask for explicit confirmation — destruction is irreversible
- •If confirmed: call
destroy_formawithsimulate: false - •Monitor with
get_command_status - •Report results
Common Patterns
| User wants to... | Approach |
|---|---|
| Tear down a stack | query: "stack:staging" |
| Remove specific resources | query: "type:AWS::S3::Bucket label:temp-data" |
| Destroy what's in a file | file_path: "/path/to/forma.pkl" |
Important
- •NEVER use
pkl evalto evaluate forma files — ALWAYS useformae eval --output-consumer machine. Forma files use formae-specific extensions that only the formae CLI can resolve, and--output-consumer machineensures parseable output instead of human-formatted text. - •NEVER skip the simulation step
- •NEVER destroy without explicit user confirmation
- •Destruction is irreversible
- •For large destroy operations, consider destroying one stack at a time