Resident Response Studio
Last reviewed
BeginnerWhat you'll learn
~35 min- Ask an AI tool, in plan mode, for a small program that turns desk notes into email drafts for residents
- Read its plan for what residents will be told: names exactly as written, no promise your notes do not make, nothing sent
- Use a wording check for Fair Housing phrases, promises you may not keep, and anything that sounds like payback for a complaint
- Check each draft against the desk note it came from, because the wording check cannot tell whether a sentence is true
The story, and what you will end up with
It is Thursday 12 November 2026, 7:45 a.m., at The Concord. Ms. Chen in 1302 calls the office, upset: her hot water was shut off yesterday morning for what was meant to be two hours, and it is still off. Your maintenance lead has left you a sticky note: “1302 hot water still out, valve part on backorder, maybe tmrw afternoon.” By a little after 9 a.m. you have three more notes on the desk: a noise complaint from 0803, a missing package in 0307, and a dishwasher repair in 1107 that the repair company moved.
Ms. Chen gets a call back first: someone a day without hot water should hear from a person. Each resident then gets an email that puts in writing what the office has said and will do, and is the record of it. Each one has to say what happened, what you are doing, and when, without promising a time your maintenance lead has not given you, and without a careless phrase that could read as a preference about who should live in the building.
By the end of this lesson you will have a small program on your own computer, the drafting program, that reads your desk notes and writes one email draft per note, ready to copy into your email or resident portal, with a wording check beside them. It never sends anything. You build it by asking your AI tool in plain English, and you check it by reading what it writes.
🔍Words used in this lessonclick to expand
- Fair Housing Act: the federal law against discrimination in housing. Its words on notices, statements and advertisements, with the classes it protects, are quoted under “How real properties differ” below, beside Virginia’s own state law.
- Familial status: one of those protected classes; whether a household has children in it.
- De-escalation: a way of writing to a resident who is upset or threatening action (a bad review, withholding rent, contacting corporate). It acknowledges the feeling without accepting blame, gives a concrete next step, and avoids defensive phrasing.
- Concierge: the warm, hospitality-first voice for ordinary updates.
Before you start
First, if your AI tool is still open, leave it: type /exit and press Enter (if you use Antigravity, press Ctrl+D with nothing typed instead), and wait until you see the $ or % prompt. The next line goes there, in the terminal, not in the AI tool. It makes a new folder for this lesson inside property-ops, next to the earlier lessons’ folders, and goes into it:
mkdir -p ~/property-ops/01-resident-responses && cd ~/property-ops/01-resident-responsesStart your AI tool with the start line you kept from the setup lesson, the one with approval prompts off. Then ask it to set the folder up:
Set this folder up so we can undo any change you make, download https://learn.intellimetrics.net/starters/property-mgmt/01/issue-notes.csv into a data folder, and save a checkpoint.Look for it saying three things: the folder is set up with Git (the program that saves snapshots, from setup), the notes are saved as data/issue-notes.csv, and a first snapshot, your checkpoint, is saved. Later you can ask whether the file has changed since then. If it does not mention one of them, ask: “Did you save a checkpoint with the file in it?” If the download does not work, download issue-notes.csv in your browser, check where it went (the browser’s list of downloads shows the folder), and tell your AI tool, for example: “issue-notes.csv is in my Downloads folder. Copy that one file into a data folder here, and save a checkpoint.” In Windows PowerShell or a desktop app, “my Downloads folder” works as is; only say “my Windows Downloads folder” if you use Ubuntu (WSL) on Windows, which keeps its own Downloads folder apart from Windows.
The building, and every resident, unit and work order in the file, are made up for this course. No real resident’s details are in it, and none should go into this folder.
The box below says what is in the practice file; later steps refer to it.
ℹWhat is in issue-notes.csvclick to expand
A spreadsheet file (it opens in Excel) with four desk notes, one per row. Each note has a code, N-1 to N-4:
| Note | Unit | Resident | Kind | Tone | When it will be fixed or answered |
|---|---|---|---|---|---|
| N-1 | 1302 | Ms. Chen | outage | de-escalation | Maybe tomorrow afternoon, not confirmed |
| N-2 | 0803 | Mr. O’Brien | noise | de-escalation | Quiet-hours reminder to the unit above today |
| N-3 | 0307 | Ms. García-López | package | concierge | We check the package room camera and reply by end of day Friday 13 November |
| N-4 | 1107 | (no name on the work order) | delay | concierge | Monday 16 November, 9 a.m. to noon, confirmed by the repair company |
Each row also has the time the note came in, what happened, the cause if known, what the resident can do in the meantime, and desk_note, the column holding the note as the desk wrote it. Two of those desk notes matter later:
- N-1: “1302 hot water still out, valve part on backorder, maybe tmrw afternoon. she called upset”. In the meantime, she can use the fitness center showers on the ground floor; the front desk has a key.
- N-2: “0803 noise from above again, says he’ll leave a 1-star review. quiet hrs 10p-8a. remind him we’re a quiet community”.
N-4 is work order WO-2291. The names keep an apostrophe (O’Brien), an accent and a hyphen (García-López), which small programs sometimes mangle.
Each lesson’s practice files are their own made-up week and do not continue from one lesson to the next, so an apartment can be occupied in one lesson’s files and empty in another’s.
Switch to plan mode
Your AI tool is already open. Switch to plan mode now: Shift+Tab until it says plan, or /plan (the keys for each tool). In plan mode it usually reads your file, asks its questions and shows you a plan before it builds anything; the order can vary.
The conversation
Each message below is an example. Say it your own way.
Say what you want
Say what you do, which file to use, and what you want from it:
I manage an apartment building. Help me build a small tool that turns my desk notes in data/issue-notes.csv into email drafts for residents, with a Fair Housing wording check. Ask me what you need first.Your AI tool usually reads the file and comes back with questions. It may also point out things it noticed, such as the unconfirmed time in N-1, the missing name in N-4, or “quiet community” in the N-2 desk note.
Answer its questions
Answer each in a sentence. These are questions the tools often ask, with one way to answer each. Yours may ask them in a different order or show a list of choices:
| If it asks | You might say |
|---|---|
| Fixed wording filled in from your notes, or an AI service that writes each email? | Fixed wording. Everything stays on my computer; nothing goes online. |
| A page in the browser, text files, or straight into your email? | Save each draft as a text file I can copy; nothing goes into my email. |
| How should the emails be signed? | With my name: Dana Reyes, Community Manager, The Concord, office (703) 555-0142, after-hours line (703) 555-0199. |
| Where is the building? Fair Housing rules depend on the state. | Arlington, Virginia. |
| Should the check stop a draft, and is it meant as legal review? | No to both; it’s a wording check, not legal review. |
| N-1’s time is unconfirmed, N-2 mentions a review, N-4 has no name. How should drafts handle those? | Keep the time unconfirmed, leave out the review threat, and greet 1107 without a name. |
| Will you send the emails yourself? | Drafts only; I send them myself. |
The name and phone numbers are made up for practice. An upset resident should hear from a named person, so for your own building, sign with your own name and office line.
If it asks several questions at once, answer the ones about what residents will be told in a sentence, and for the rest say that its suggestions are fine. If it asks something not listed here, answer it the same way, in a sentence.
Read the plan
Next it usually shows you a plan: what it will build and how it will check it. Read it for five things:
- Every note gets a draft, greeting the resident by the name in your notes exactly as written, or with no name where there is none. No name is made up.
- A draft says only what your notes say. An unconfirmed time stays unconfirmed, and no new date, cause or promise appears.
- The wording check looks for three things: Fair Housing wording, promises you might not keep, and anything that sounds like payback for a complaint. It reads your desk notes as well as the drafts.
- The check flags and suggests, with the reason for each flag. It never stops a draft and never rewrites one on its own.
- Nothing is sent and nothing goes online, and your notes file is read and left as it is.
A first plan often leaves one of these out, most often the promises and the payback in item 3. Say so in a sentence, in your own words, for example:
Have the check also flag promises we might not keep, like 'guaranteed by tomorrow', and anything that sounds like payback for a complaint.When the plan has all five, approve it: if your AI tool offers a choice to go ahead, pick it; otherwise say “Yes, go ahead and build it.” In Codex, press Shift+Tab first to leave plan mode. In Copilot, saying it brings up a choice to go ahead; pick that. Let it build. It may run what it built and tell you how to run it yourself; either way, the next step asks it to. When it has finished, ask it: “Did you install anything, and where?” Nothing, or something inside this lesson’s folder, is fine for these lessons. If it names anywhere else on your computer, ask it what that is for, and to remove it if you do not want it there.
Look at what it built
Ask it to run what it built:
Run it and show me the drafts and the wording check.Your drafts will be worded and laid out in their own way. Check them for these:
- There are four drafts, one for each note: N-1 (1302), N-2 (0803), N-3 (0307) and N-4 (1107).
- The names are exactly as in the notes: Ms. Chen, Mr. O’Brien, Ms. García-López, with the apostrophe, the accent and the hyphen. The 1107 draft greets the resident without a name (for example “Dear Resident of 1107” or “Hello”), and none is made up.
- The 1302 draft offers the fitness center showers on the ground floor and says the fix is expected tomorrow afternoon but not confirmed, with no firm time. It may write tomorrow as a date, Friday 13 November, since the note came in on Thursday 12 November.
- The wording check flags “quiet community” in your N-2 desk note, with a reason and a suggestion. The 0803 draft does not use the phrase; it points instead to the posted quiet hours, 10 p.m. to 8 a.m., a rule that applies to everyone.
- The 0307 draft keeps your own commitment, a reply by end of day Friday 13 November, and the 1107 draft gives Monday 16 November, 9 a.m. to noon, and work order WO-2291.
- No draft promises a rent credit or concession; whether one is owed is for you and the property’s owner to decide under the lease and the law that applies where the building is. The 0307 draft may say the camera will be checked, but does not promise to share the footage or accept responsibility for the package. If a draft does either, tell your AI tool, for example: “Take the rent credit out of the 1302 draft, and have the check flag credits, concessions and promises about footage.”
- When you ask “Has my notes file changed since the checkpoint?”, it compares the file with the checkpoint and says no.
The check may also flag things you are happy to send, such as your own reply-by date for 0307 or the unconfirmed time in N-1. A flag asks you to look again; it does not mean the draft is wrong.
Once you send a reply, keep a copy in whatever system your office keeps resident communications in, as with any other email to a resident.
The emails may read a little stiffly, because fixed wording fills in your notes as written. Fixed wording keeps your notes on your computer, at the cost of plainer emails; you can change the wording later. If something on the list is not true, tell your AI tool in a sentence what you see and what you expected, for example: “The 1107 draft says Dear Mr. Smith, but there’s no name in my notes. Greet them without a name.”
Notice what the check cannot see
Your drafts have been through the wording check. Before you send one, try this:
Make a copy of the 1302 draft in this folder. In the copy only, add 'Good news: the part has arrived and a plumber is on the way.' Then run the wording check on the copy.Look at what the check says about the copy. Before you read on: is the new sentence true?
It is not. Your maintenance lead’s note says the part is on backorder and the fix is maybe tomorrow afternoon. The copy tells Ms. Chen the part is here and a plumber is coming. If no plumber comes, she has been let down twice in one day, in writing.
The check will probably find nothing to flag, because nothing in the sentence is on its list: no “guaranteed”, no protected class, no mention of her complaint. If it does flag something, look at what it caught: a word on its list, not the fact that the part has not arrived. Either way, only your maintenance lead’s note shows that the sentence is false. A wording check compares words with a list. It cannot know what your maintenance lead told you. Your AI tool may offer to add “has arrived” and “on the way” to the list; that would catch this sentence, not the next one someone types at 7:50 a.m.
The check warns; it does not decide. You make the final call.
So the last step before any draft goes out is yours: read it beside the desk note it came from, and check every date, time and promise against what you actually know. “Tomorrow afternoon” is also only true on the day you write it; a draft sent a day later needs a date. When you have looked, remove the copy: “Delete that copy; I’m done with it.”
One real run
Here is part of what one AI tool said after the experiment above, with Claude Code on 11 November 2026. Yours will word it differently; check your drafts against the list above, not against this.
The wording check found nothing: 0 flags. That's a real gap, because thenew sentence is the riskiest line in the email:
- It contradicts your notes. Your notes say the part is on backorder and the fix is "maybe tomorrow afternoon, not confirmed."- It contradicts the email itself. Two lines later the same email says "Cause: Valve part on backorder" and "not a confirmed time."The building, the residents and the notes in this answer are made up for this course.
How real properties differ
The units, residents, names, phone numbers and notes here are made up. The laws are real:
- Federal law makes it unlawful “to make, print, or publish, or cause to be made, printed, or published any notice, statement, or advertisement, with respect to the sale or rental of a dwelling that indicates any preference, limitation, or discrimination based on race, color, religion, sex, handicap, familial status, or national origin” (42 U.S.C. 3604(c)).
- Virginia’s Fair Housing Law covers the same kinds of “notice, statement, or advertisement, with respect to the sale or rental of a dwelling”, and its list for them reads “race, color, religion, national origin, sex, elderliness, familial status, source of funds, sexual orientation, gender identity, military status, or disability” (Va. Code 36-96.3, A.3). Check the law that applies where your property sits.
- The lesson’s wording check reads neither law. It is a house list of phrases that describe the kind of resident wanted rather than the property or a rule. Whether a flagged phrase is a problem is a call for the person your company relies on for fair-housing questions, not for the program and not for this lesson.
- Your management company may already have approved wording or a list of phrases to avoid. Ask for it and add it to your check; the list your AI tool started with is only a beginning.
Keep going
Small changes do not need plan mode. Say each in a sentence, then run it again:
- “For each note, also draft a short follow-up for tomorrow and a closing one for three days later.” A resident who hears nothing after the first email feels forgotten.
- “Show me the 1302 draft in a warmer tone and in a firmer one, so I can compare them.”
- “Keep a log of every draft you make, with the date, the unit and any flags.”
- “Save a checkpoint.” Your AI tool saves a snapshot you can return to.
When you want to draft emails for real residents, use the finished drafting program. It runs on your real notes by itself, with your AI tool closed, so your AI tool never sees them. Do these steps in order; the first three happen now, while your AI tool is open and this folder still holds only the practice notes:
-
Go through the data check, the questions in setup about what the data is, who decides how it is used, and which AI tool would see it. Resident names and units are your management company’s to decide on. Go on only if it allows this use.
-
Decide on a folder of its own for your real notes, outside this course folder, for example
~/resident-notes. Nothing has to be in it yet. Ask your AI tool for the exact line, for example: “Write me the exact line to run this myself on issue-notes.csv in ~/resident-notes, saving the drafts in a drafts folder there.” Use your own folder’s name, written out in full from your home folder as above. If it offers to copy your real notes into this folder instead, say no. -
Copy the line it gives you into a note. It will look something like this one, though yours may differ:
Terminal window python3 ~/property-ops/01-resident-responses/scripts/make_drafts.py ~/resident-notes/issue-notes.csv ~/resident-notes/drafts/Read it left to right:
python3starts Python, which runs the program; next comes the program you built, in this lesson’s folder; then your notes file, and last the folder the drafts go into.~means your home folder; your line may write it out in full instead. If you are unsure about any part, ask your AI tool now, while it is still open. -
Leave your AI tool the way you did at the start of this lesson.
-
Put your real notes in that folder, named as the line names them. Paste the line from your note at the
$or%prompt and press Enter. The drafts are saved in that folder, not in the course folder. Open each one to read it. To come back to the lesson folder later, type the line at the top of this page that begins withmkdir.
Try another case
Before the quiz, write two or three sentences for yourself. The elevator is out on a Saturday. Your note says “elevator company coming Mon, maybe.” A colleague’s draft to the whole floor says “The elevator will be fixed Monday morning. As a building perfect for young professionals, we know how much you rely on it.” What would the wording check likely catch, what would it miss, and what would you change before sending?
A good answer sees three things. “Perfect for young professionals” describes the kind of resident wanted rather than the building or a rule, so a house list like yours should flag it; whether it is a problem is a call for whoever your company relies on for fair-housing questions. “Will be fixed Monday morning” promises more than “maybe Monday” and may pass the check untouched. And the fix for that sentence is to say the visit is expected Monday, not confirmed.
Key takeaways
- Ask briefly, and let your AI tool ask back. Say what you do, which file to use and what you want from it; its questions fill in the rest.
- Read the plan for what residents will be told: names as written, nothing your notes do not say, a check that flags and never sends.
- A draft is only as true as your notes: a time your notes leave open stays open in the draft, and “tomorrow” needs a date once a day has passed.
- The wording check catches listed phrases, not false statements. You read each draft against its desk note before it goes out.
- Practice data stays practice data: real resident notes go to the finished program, with your AI tool closed, after the data check.
A resident in 0803 emails: 'The noise from 0903 is unbearable every night. If you don't fix this I'm leaving a 1-star review.' Your drafting program's wording check flags the phrase 'quiet community' in your desk note for this reply. Why?
What’s next
In the next lesson you build the Morning Maintenance Triage Board: once the night’s emergencies have been dealt with, it puts the open work orders in a suggested order for your day crew, each with a reason, on one sheet to print for the morning standup.