AI Workflow Folder Builder
Turn one repeated job into a folder that an AI tool can work from each time.
A chat forgets your rules when it ends. A folder keeps them. Answer eight questions about one job, and the builder writes the folder plan and the text of each starter file. Copy each file, and your AI tool does the job the same way each time.
Your folder plan
CLAUDE.md
workflow.md
context/about.md
log.md
The start prompt
What an AI workflow folder is
An AI workflow folder is one folder on your computer for one repeated job. An AI tool that works with files reads the folder, follows the steps and saves the result there. The folder is the base of an agentic workflow: the steps, the facts and the checks are written down, so the work does not depend on what you typed in one chat.
weekly-client-report/ ├── CLAUDE.md the rules; the AI reads this file first ├── workflow.md the steps, the output and the checks ├── context/ │ └── about.md the facts the AI needs each time ├── inputs/ the source files for each use ├── outputs/ the results, one dated file for each use └── log.md one line for each use
The six parts of the folder
| Part | What goes in it | Why it is there |
|---|---|---|
| Rules file (CLAUDE.md or AGENTS.md) | The goal and seven rules for work in the folder. | The AI reads it first, so each session starts with the same rules. |
| workflow.md | The inputs, the steps, the output and the "done when" checks. | The AI follows the same steps each time, and you can correct one step. |
| context/about.md | The reader, the fixed facts, the tone and the things to avoid. | You do not type the same facts again. |
| inputs/ | The source files for each use. | The AI works from your files, not from memory. |
| outputs/ | One dated file for each result. | No result replaces an earlier one, and you can compare them. |
| log.md | One line for each use, with what was missing or wrong. | The log shows which step or fact to correct. |
How to use the folder: five steps
- Make the folder. Create the folder and the three subfolders from the plan.
- Add the files. Create each file and paste the text from the builder. Fill in each line in brackets.
- Add the source files. Put the files for this use in
inputs/. - Open the folder in your AI tool and paste the start prompt. Claude Code reads
CLAUDE.mdat the start of each session. With another tool, the start prompt tells the tool to read the rules file. - Read the result, then correct the folder. When a result is wrong, correct the step or the fact in the file, not only in the chat. Then the next result is better.
A full example: the weekly client report
This is the workflow.md file for a consultant who sends each client a report on Friday.
# Workflow: Weekly client report Use: each week ## Inputs - The hours export for the week (CSV) - My notes from the client calls ## Steps 1. Read the hours export and total the hours for each project. 2. Read the call notes and list each decision and each open question. 3. Write the report: summary, work done, decisions, open questions, plan for next week. 4. List each number in the report with the file it came from. ## Output One page in Markdown, with a three-sentence summary at the top. ## Done when - Each number matches the hours export. - Each open question has an owner. - The report has no fact that is not in the inputs. ## Check by a person I read each result before it goes to anyone. List at the end of the result each fact you were not sure of.
Three rules that keep the folder safe
- A person checks each result. The rules file tells the AI not to send, publish or delete anything. This is the human-in-the-loop rule.
- Keep private data out. Put no passwords, keys or client secrets in the folder. An AI tool reads every file it can open.
- One job for each folder. A second job gets a second folder. Small folders are easier to correct.
Common questions
What is an AI workflow folder?
An AI workflow folder is one folder on your computer for one repeated job. It contains a rules file, the steps, the fixed facts, the source files, the results and a log. An AI tool that works with files reads the folder and does the job the same way each time.
Which AI tools can use a workflow folder?
Any AI tool that can read and write files in a folder on your computer can use it. Claude Code reads a file called CLAUDE.md at the start of each session. With another tool, the start prompt tells the tool to read the rules file first.
Why use a folder and not one long prompt?
A prompt is gone when the chat ends. A folder keeps the rules, the facts and the past results, so you do not type them again. You also correct one file when a result is wrong, and the next result improves.
Does the builder send my answers anywhere?
No. The builder runs in your browser. Your answers do not leave the page, and the page saves nothing.
Next: write the first prompt for a step with the AI Prompt Builder, measure the result with the AI Time Savings Calculator, or read AI agent vs. chatbot vs. workflow to choose what each job needs.