Offplan Report

---
name: offplan-report
description: Build a client-ready Dubai/UAE off-plan property evaluation report (HTML page + PDF) from a sales offer, brochure, or a project on Reelly / GenieMap / Property Finder / Bayut. Use when someone shares an off-plan project, unit, brochure or sales offer and wants to know if it is a good investment, its rental yield, resale profit at handover, supply risk, or wants an evaluation report like the "Weston by Wadan" example.
---

# Off-plan evaluation report

Version **1.6.0** (see `VERSION` and `CHANGELOG.md`).

Turns one off-plan unit into a polished, phone-friendly report: verdict, deal checks, what-if
scenarios, supply & demand, payment plan, location comfort, full step-by-step maths, photo gallery,
and a client PDF. Everything is driven by **one data file**; the template does the maths.

Read these before starting (all in `references/`):
- `workflow.md`  – the exact step-by-step process (follow it in order)
- `sources.md`   – every website, what to read on it, URL patterns, gotchas, fallbacks
- `rules.md`     – formulas, growth bands, premiums, valuation cases, labels, wording rules
- `design.md`    – section order and the design/wording decisions the report must keep
- `listings-and-evidence.md` – how to collect the project's sales, similar listings and resale info
- `modules.md`   – optional modules (distressed deal, mortgage, market evidence, developer) and the section order
- `data-schema.md` – every field of the data file, with the Weston example

The build kit is in `kit/` (copy it to a working folder first – see step 0).

## Golden rules
1. **Answers, not a calculator.** The output is a finished report, not a form.
2. **Never invent data.** Every number comes from a source you actually opened, or from the user.
   If a source is missing (no account), use the fallback in `sources.md` and say so in the report.
   Minimum sample: 5 transactions; widen 3 months → 6 months → 1 year; else say "no data".
3. **Facts, not advice.** Headline says e.g. "Profitable at handover, not before"; never "good buy",
   "hold", "you should". Keep the disclaimer.
4. **Say each number once.** Don't repeat the same figure in two places.
5. **Ask before downloading** anything the user didn't ask for, before publishing/sharing outside
   their account, and before typing into anything that isn't a search/filter box. Never enter passwords.
6. **Credit line stays.** Never remove the footer line "The Ultimate Real Estate Calculator · Off-plan Report v… © 2026 Abdulla Alzarooni …" or the
   copyright notices; they are required by the LICENSE.
7. **Verify before handing over:** run the checks in `workflow.md` (step 9). Report failures honestly.
8. **Before every report** (not only the first one), ask whether they want the optional **Developer section** (step 2b:
   it takes a long time) and whether the unit is a **resale** or new from the developer (step 2c).

## Quick start
```bash
cp -R ~/.claude/skills/offplan-report/kit  "<working folder>/offplan-reports"   # once
# first time only: fill config/agent.js and drop logo/photo into brand/ (optional)
cp data/example-weston-109.js data/<project>-<unit>.js                         # per property
# ...fill the data file following workflow.md...
python3 build.py data/<project>-<unit>.js          # -> <project>-<unit>.html
node tools/domtest.js <project>-<unit>.html </dev/null   # must print the summary, no errors
# then: every image must load (workflow.md step 9) – never deliver a report with a missing photo
node tools/dump.js <project>-<unit>.html                  # must print: bad 0 []
```
Then make the PDF and publish/share (workflow steps 10–11).

## First run for a new person
**Guide them step by step, in plain words; don't assume they are technical.**
0. **Check the setup** before anything else and help fix what's missing (one item at a time):
   `python3 --version`, `node --version`, Python packages `pymupdf` and `pillow` (`pip3 install pymupdf pillow`: read image-only brochures, resize photos), Google Chrome installed, and the **Claude in Chrome**
   extension connected (needed to read the data sites). If something is missing, explain what it is
   in one line and walk them through installing it (official sites only; ask before downloading).
   Then copy `kit/` to a working folder they choose (default `~/Documents/Off-plan Reports`).
1. Ask once, then save into `config/agent.js` of their working folder (and remember it):
name, company, BRN, WhatsApp number, social links (any of Instagram, Facebook, TikTok, YouTube,
Threads, X, LinkedIn, Snapchat), optional formulas credit line; optional files in `brand/` of the working folder:
`logo-dark.png` + `logo-light.png` (transparent; light/dark versions) and `agent.jpg` (square
headshot – crop to the face, it shows in a circle). Anything left empty is simply hidden.
2. Ask which data accounts they have (DXB Interact, Reelly, GenieMap) –
this decides which sources and fallbacks to use (no paid accounts → Reelly + DXB Interact + Bayut).
**Never use Property Monitor**, even if they have an account: it prohibits AI / automated use (`sources.md`).
2b. **Ask about the optional Developer section** before collecting any data, in these words or close:
"The *Developer* section is optional and takes a long time to build. Would you like it? If yes, it shows every
project by this developer – ready, under construction and planned – each with photos, completion date and DLD
target, % built, unit mix, rented % or absorption rate, and price / rent premium vs its area for each unit type
(off-plan premium for projects not finished yet), with area and unit-type filters and a search box."
If no, build the report without it. If yes, tell them it adds a lot of time, then follow
`references/developer-section.md` (data format: `data-schema.md` → Developer section).
2c. **Ask whether the unit is a resale (from an owner) or bought new from the developer.** Only resales get the
   distressed deal test (`listings-and-evidence.md` step 0). For a mortgage, see `modules.md`.
3. Then ask for the first property (sales offer PDF, brochure, or a project link) and follow `workflow.md`.
   Tell them what you are doing as you go (e.g. "Reading Bayut rents…") and what each step needs from them.

**Developer × bank offers:** for every off-plan property, look the developer up in `references/bank-offers.md`; if it has a deal (e.g. Ellington × ADCB, Emaar × ADCB, Dubai Holding × ADCB/ENBD/CBD, Expo City × DIB, Sobha × ENBD/ADIB/RAKBANK), add the bank-offer option to the mortgage section (workflow step 1b).