1# Mode B — Save to a local folder
2 
3## Step 1 — Suggest a path
4 
5Detect the user's current working context (in priority order; pick the **first** that succeeds):
6 
7| Signal | Suggested path |
8|---|---|
9| Host session has an `--add-dir` workspace containing a `.git` directory | `<workspace>/infra/{vm-name}/` |
10| User mentioned a repo path earlier in the conversation | `<that-path>/infra/{vm-name}/` |
11| `pwd` is inside a git repo | `<repo-root>/infra/{vm-name}/` |
12| None of the above | `~/Desktop/{vm-name}-infra/` |
13 
14Present the suggestion and let the user override:
15 
16> *"I'll save to `~/Desktop/dev-vm-infra/` (no repo detected). Use that, or pick another path?"*
17 
18If the path already exists with files, **always show the diff and ask before overwriting**. Never silently clobber.
19 
20## Step 2 — Choose the filename(s)
21 
22| Format | Files written |
23|---|---|
24| bash | `create-vm.sh` (chmod +x) |
25| Bicep | `main.bicep`, `README.md` |
26| Terraform | `main.tf`, `variables.tf`, `outputs.tf`, `terraform.tfvars.example`, `README.md` |
27 
28The `README.md` contains:
29- The full **Plan Card** markdown (so the next reader knows what this deploys)
30- **Deploy** section with exact commands (`az deployment group create ...` / `terraform init && apply ...` / `bash create-vm.sh`)
31- **Verify** section: `az vm show` / `az vm list-ip-addresses`
32- **Cleanup** section: `az group delete --name <rg> --yes --no-wait`
33 
34## Step 3 — Write and confirm
35 
36After writing, echo back absolute paths and the single command the user runs next:
37 
38> ✅ Wrote 2 files:
39> - `~/source/my-infra/infra/dev-vm/main.bicep`
40> - `~/source/my-infra/infra/dev-vm/README.md`
41>
42> Next step:
43> ```bash
44> cd ~/source/my-infra/infra/dev-vm
45> az deployment group create --resource-group dev-vm-rg --template-file main.bicep \
46>   --parameters vmName=dev-vm adminUsername=azureuser \
47>                adminPublicKey="$(cat ~/.ssh/id_rsa.pub)"
48> ```
49 
50## Tool implementation
51 
52Use the `Write` tool (or the host's equivalent) for each file. For shell scripts: write, then `chmod +x` via Bash.
53