A practical learning guideWindows · 10–15 minutes
Lesson one

Your first automation.

Say what you want. Let your agent write the instructions. Then run them yourself and see what happens.

Start the lesson ↓Download text copy
Describe → Generate → Run → Inspect → Refine → Keep

The small win

Create an Automation Demo folder in Documents, containing Invoices, Receipts and Reports. Then open it and check it yourself.

You stay in control

Use your own agent account and Windows computer. No customer files, uploads or screen access. The agent writes the code; PowerShell runs it only when you choose.

1
Describe & generate · 2 minutes

Speak your request.

Open a conversation with your own agent. Use its microphone or your computer’s dictation, or type the words below.

Make me a PowerShell script that creates a folder called Automation Demo in my Documents, puts three empty folders inside called Invoices, Receipts and Reports, and opens it so I can see the result. Preserve anything that already exists. Use built-in PowerShell commands only. Give me the code and simple instructions to run it myself by pasting it into PowerShell. Don’t execute it for me.

Your agent should give you code and an explanation. You do not need to understand every symbol. You do need to understand what it intends to change.

2
Review & run · 3 minutes

You press go.

  1. Read the explanation first. It should only create missing folders inside Documents, preserve anything already there, and open the result.
  2. If it is unclear, ask. “Explain this script in plain English before I run it.” Stop if it asks for administrator access, installations, deletion or security changes.
  3. Open PowerShell. Open the Windows Start menu, type “PowerShell” and open Windows PowerShell normally. Do not choose “Run as administrator”.
  4. Copy only the code. Do not copy the surrounding explanation or code-block markers. Paste it into PowerShell, review the pasted commands and press Enter if needed.

A pasted script can run as soon as it is pasted. Check the code and explanation before copying it. If Windows asks you to confirm a multiline paste, review it and continue only if it matches the safe task above.

3
Inspect · 2 minutes

Look at the result.

File Explorer should open to your demo folder. Check the actual folders, rather than relying on the agent’s claim that it worked.

Documents └── Automation Demo ├── Invoices ├── Receipts └── Reports
  • Can you see the three named folders?
  • Are newly created folders empty?
  • Was anything that already existed preserved?

If those folders existed already, they may contain files. Preserving those files is the correct result. Do not empty or delete them for the demo.

4
Refine · 2–3 minutes

Tell it what actually happened.

If the result does not match your request, describe the difference. Replace X and Y with what you expected and what you saw.

I expected X but Y happened. Explain and revise; preserve existing files.

You can paste relevant error text, but remove private details first: names, email addresses, usernames in folder paths, customer information and any passwords or keys. Review the revised code, run it yourself and inspect again.

If everything worked, simply describe the result to the agent. There is no need to invent an error or add another task.

5
Keep · 2–3 minutes

Save what worked.

Once you have checked the result, ask:

Help me save this working script as reusable .ps1 and explain running it next time; explain restrictions without changing security settings.

Keep the working prompt, script and simple running instructions together. A .ps1 file is a saved PowerShell script. Make sure the name really ends in .ps1, not .ps1.txt.

Some computers restrict saved scripts. If yours does, pause and ask for an explanation. Do not disable execution policy, bypass security controls or run as administrator for this lesson.

Lesson complete

One small automation. One repeatable habit.

You described the result, generated code, ran it yourself, inspected it, refined if needed and kept the working version. Stop here for the first demo.