Markdown files sound technical. They're not. They're just plain text AI can read easily, and they're the foundation of every AI agent. Here's the simple version, plus a template to build your first one.
AI sounds complicated, but I'm going to break down one of the most important pieces so you can actually start to learn it, and don't get left behind. Let me show you what an md file really is, and how to build your first one.
An md file (or markdown file) sounds technical, but it's literally just a plain text file with simple formatting so AI can read it easily. That's all "marked down" means. When you work with AI, it reads files like this to know how to work with you.
Here are the only marks you'll actually use, this is the whole "language":
# Title makes a big heading. More hashes (##, ###) make smaller sub-headings.
- item makes a bullet point. Stack them for a list.
**bold** makes text bold for emphasis.
1. step makes a numbered list, for steps in order.
That's basically it. Plain words plus those four marks, and you can write a markdown file.
Here's the part that unlocks everything. An AI agent isn't something super complex either. It's genuinely just a smart assistant that knows how to read the right file at the right time.
So when you have an agent, you'll have a bunch of md files that spell out your preferences, all the information about your business or your job, and any skills or repeatable workflows you have. The agent reads through them like a table of contents, so it knows exactly which one to open when. That's it. That's the whole magic trick.
In plain English
A markdown file is just a note you write for your AI instead of for a person. An agent is just an assistant with a folder of those notes and the sense to grab the right one. Once that clicks, building your own is no longer scary.
The single most useful file to start with is a "How I Work" file. It is a one-page note that tells any AI who you are, how you want it to talk to you, and what you need help with, so you stop re-explaining yourself in every single chat. This is the exact foundation every AI agent is built on.
There are three ways to make yours: fill in the template below, let AI interview you to build it (the prompt for that is right under the template), or open Claude, turn on voice-to-text, and just ramble, then say "turn this into a clean markdown file." Whichever you pick, the finished file is yours to keep and reuse forever.
Your "How I Work" file (fill in the brackets)
# How I Work Last updated: [Month Year] Privacy note to myself: keep this to context, not secrets. Do NOT put passwords, card or bank numbers, IDs, customer personal info, or my home address in here. ## Who I Am - What to call me: [your name or nickname] - What I do: [your job or business in one line, e.g. "I own a 6-person dog grooming shop in Austin and run all the marketing myself"] - My experience with AI: [brand new / some / pretty confident] ## My Goals - This year: [the big one, e.g. "grow from 40 to 70 appointments a week"] - Right now / this quarter: [your current focus, e.g. "launch a monthly membership"] - Success looks like: [how you will know it worked, e.g. "15 members signed up by Sept 1"] ## How I Want You To Talk To Me - Tone: [casual and direct / warm and friendly / strictly professional] - Reading level: [keep it plain and simple / fine to get technical] - Length: [short and to the point / give me the detail] - Emojis: [none / a few are fine] - Format: [use bullets and tables when they help; keep explanations to one tight paragraph] ## Give Me A Recommendation, Not A Menu - When there is a choice to make, tell me what YOU would do and why, then the runner-up. Do not just hand me a long list of options and make me decide alone. ## Challenge Me, Do Not Just Agree - Push back if my idea is weak or my facts are off. Point out risks I am missing. I would rather be corrected now than embarrassed later. ## When You Are Not Sure, Ask - If you do not know, or my request is unclear, say so and ask me one question. Never guess, and never make up facts, numbers, or quotes. ## About My Work - Who I serve: [your customer or audience, e.g. "busy pet owners, mostly women 30 to 55"] - What I sell or do: [your products or services, with prices if it helps, e.g. "full groom, $85"] - Key facts and numbers: [anything that makes answers useful, e.g. "slow days are Mon and Tue; my main competitor charges $110"] ## Tools I Use - [the apps and systems you actually use, e.g. "Square for booking, Canva for graphics, Instagram and Gmail for marketing"] ## What I Ask For Most 1. [your most common task, e.g. "Instagram captions"] 2. [e.g. "replies to unhappy customers"] 3. [e.g. "turning my rough notes into clean, professional emails"] ## My Words (so you do not misread me) - [your shorthand and industry terms, e.g. "'a full' = a full-groom appointment, 'the book' = my Square calendar, 'regulars' = clients who come every 4 to 6 weeks"] ## Never Do This - [your hard rules and pet peeves, e.g. "never invent statistics, never use the words 'delve' or 'game-changer', never write more than I asked for, do not lecture me on basics I already know"] ## What Great Looks Like (paste real examples) - Here is something I wrote that I liked. Match this style and energy: [paste 1 to 3 real samples of your own writing, like a caption or email you were proud of. Real examples teach your voice far better than any description.] ## Good To Know (optional) - My time zone: [e.g. US Central] - When I work best: [e.g. early mornings and after 8pm; low energy midday] - Anything else that helps you work with me: [...] --- For the AI: Read this file first in every conversation and use it to work the way I work. If anything here looks out of date, point it out and ask me.
Prefer not to fill in blanks? This is the fastest way to a great file. Paste this into Claude or ChatGPT and it will interview you, then write the whole thing for you in about 10 minutes.
Or let AI build it for you
I want to build a "How I Work" file: a personal context file that tells you who I am, how I work, and how I want you to help me, so I never have to repeat myself again. Interview me to build it. Ask me one question at a time, wait for my answer, then ask the next one. Cover all of this: who I am and what I do, my goals, how I want you to talk to me, how I like decisions made, my work and my customers, the tools I use, the tasks I need most often, my pet peeves and hard rules, and one example of output I love. Ask about 12 to 15 questions total. Keep them simple and plain. When we are done, write the whole thing as one clean markdown file I can copy, and tell me the best place to save it.
One Rule Before You Paste
Keep this file to context, not secrets. It is safe to include your role, goals, voice, and business facts. Do not put passwords, card or bank numbers, IDs, customer personal info, or your home address in it. If you would not paste it onto a public website, leave it out.
A file sitting in a note does nothing. Here is how to actually plug it into your AI so it works the way you do. Start with the easy way, then set up whichever tool you use so you never have to paste it again.
Works In Any AI
The Easy Way: Paste It On Top
Start a new chat and paste your whole file first, with this line at the top: "This is my How I Work file. Use it for everything in this chat. Read it, confirm you have it, then wait for my question." Then ask away. This works in Claude, ChatGPT, Gemini, any of them, with zero setup. Do this one first.
In Claude
Set It Once, Use It Everywhere
For every chat: go to Settings, then "Instructions for Claude," and paste your file there. Now it applies to everything you do.
Even better, make a Project: go to Projects, click New Project, name it "About Me," click "Set project instructions" and paste your file, then upload the actual .md file into the project knowledge panel on the right. Every chat inside that Project now knows you, and the file stays put.
In ChatGPT
Drop It Into Custom Instructions
Go to Settings, then Personalization, then Custom Instructions. You will see two boxes. Put the who-you-are and goals part in the first box, and the how-to-talk-to-me and never-do rules in the second. Each box has a size limit, so paste a shortened version here and keep the full file for pasting or for a Project.
Keep It Alive
Your file gets better the more you use it. Every time you catch yourself re-explaining something to the AI, add that line to the file and update the date at the top. Once a month, skim it and refresh your goals. To check it is working, ask the AI: "Based on my file, how should you talk to me and what should you never do?" If it repeats your rules back, you are wired in.
The Real Win
Once the markdown concept clicks, you understand how to build your own agents, and a whole new world of AI opens up. Your "How I Work" file is step one. Build it once, plug it in, and watch how much less you repeat yourself, and how much more the AI sounds like it actually knows you.
The Only AI Masterclass You Need
If this guide helped, but you’re looking to go deeper, I got you!! My 30-Day Challenge takes you from saving AI tips you never use to actually building with AI, step-by-step.
I show you exactly how I automated two e-commerce brands, my social media, and most of my personal life, then hand you the agents, workflows & systems to do the same. I’m teaching you every single thing I know with one lesson and one build a day.
Join the AI Masterclass →© 2026 Mariah Brunner. All rights reserved.