Build and deploy / build-and-deploy (push) Failing after 6s
Applies Pouya's rulings on Q42, Q41(a)(b)(c), Q43 and Q40, then builds `/about/` — six of docs/01's seven items. `/about/` ships WITHOUT a memberships group. R10 is a prohibition on shipping a page that lists memberships before they are re-confirmed; the re-confirmation is a fact only Pouya holds and was not obtained. The first version published all four and disclosed the gap in five places instead; both review agents rejected that. Q44 carries the question. Rulings: - Q42 — ENE, dispute-system design and pre-dispute technical advisory rowed; settlement counsel struck as a partisan role. The strike exposed a hole in the offering test, which now states the prior question it was missing. - Q41(a) — Q37 reaches prose, and prose is held to a higher bar. The sentence is now one constant, ASYMMETRY_LINE, because two hand-typed copies had already diverged inside one session. - Q41(b) — not restored; the implication turned out to be in three places, two of which survived the sweep that closed it. - Q41(c) — verified against the LAT's own Rules and extracted into docs/reference/lat-case-conference.md. Rule 2.4 makes "Pre-Hearing Conference" the Tribunal's own term for a case conference; the Rules contain zero occurrences of `mediat` in 66,593 characters. - Q43 — the timings are service commitments; PROCESS_FRAMING renders adjacent to them, not in a lede above. - Q40 — bundled to step 7 as R15, blocking cutover. Four review passes, 43 findings, nine of them defects in their own predecessors' fixes. The worst was mine: the false universal Q39 struck reached a public page. Also fixed a portrait ladder that upscaled 1.93x at 1024/DPR2 on BOTH pages — the shipped home page included — because its 960 ceiling was derived from the layout range where the image is narrowest. Verified: check/lint/build/audit clean; 0 upscaling across 11 device profiles; 0 overflow and 0 over-wide elements at 13 widths; 0 contrast failures across 127 and 88 painted pairs; 0 print failures against white paper; reveal 0 hidden under reduced-motion and print; zero JavaScript. Lighthouse NOT RUN — tool unavailable until step 7 (R11). HTML validator NOT RUN. Opens Q44 (memberships), Q45 (PDF bio), Q46 (offering-test gating; the glossary standard), Q47 (jobTitle without worksFor). Adds R15. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0148NztQskLKKApP5SzAA78e
316 lines
16 KiB
Markdown
316 lines
16 KiB
Markdown
# 03 — Content and voice
|
||
|
||
Authority: `AGENTS.md` §4 (claim register) and §5 (audience model).
|
||
Source material: `PL_ADR_Personal_Branding_Strategy_Brief.docx` (2026-05-26) and
|
||
`ADR_Site_Content_Brief_for_Claude_Design.md` (2026-05-26).
|
||
|
||
---
|
||
|
||
## The one rule
|
||
|
||
**Every factual claim traces to `AGENTS.md` §4 Verified.** Read the Forbidden
|
||
table before writing any number, statistic, or superlative. If you need a fact
|
||
you do not have, write `TODO(pouya): <exact question>` and log it in §9. Do not
|
||
infer, do not soften, do not carry anything over from the old site.
|
||
|
||
---
|
||
|
||
## Voice
|
||
|
||
**Restrained, precise, and unhedged.** The reader is usually a lawyer. They
|
||
detect padding instantly and discount everything after it.
|
||
|
||
**Do:**
|
||
|
||
- Short declaratives. "I read the contract and the code." Not "clients benefit
|
||
from a uniquely multidisciplinary perspective."
|
||
- First person singular. This is a practitioner brand — "I", not "we", not "the
|
||
practice". The old site's "we" implied a firm that does not exist.
|
||
- Concrete nouns. *Lien claim. Change order. System Impact Assessment. Model
|
||
card. Minutes of settlement.* Specificity is the credential.
|
||
- Name the limits — but name the *right* ones. This bullet carried the model
|
||
sentence *"Sole-arbitrator appointments follow the Q.Arb designation;
|
||
co-arbitration work is available now"* until 2026-08-26. **Both halves were
|
||
wrong and they were wrong in opposite directions**, which is why it survived
|
||
two audits: the first half understated (sole-arbitrator appointments are
|
||
offered **now** and are not gated by Q.Arb — §4 Offerings), and the second was
|
||
unsourced when written. §4 now carries rows for all three forms.
|
||
|
||
The shape of the bullet still stands, so here is a sentence that fits it and
|
||
clears the register: *"I accept sole, party-appointed and co-arbitration
|
||
appointments. The Q.Arb designation commenced in August 2026; C.Med-Arb is the
|
||
endpoint."* The limit being named is the **stage of the arc**, stated plainly —
|
||
Pouya's instruction is that being open about it is the differentiator, so do
|
||
not hedge it into vagueness and do not drop it. (**No tribunal-secretary
|
||
work** — D14
|
||
removed the rate and bars offering it; see `docs/07-fees.md`.) Precision about
|
||
what you cannot yet do makes the rest believable.
|
||
- Plain words over Latin. "Without prejudice" survives because it is a term of
|
||
art; *inter alia* does not.
|
||
|
||
**Do not:**
|
||
|
||
- **Any claim or implication of legal licensure.** D13: the site asserts the JD
|
||
and nothing more. Never "lawyer", "called to the bar", "licensed", "my law
|
||
practice", "my litigation practice", "my clients", "acts for", "represents".
|
||
Implication counts as much as assertion.
|
||
|
||
**The approved phrasing is "active litigation exposure" or "involvement in
|
||
litigation and ADR matters" — never "practice" in that context.** Pouya's
|
||
wording, 2026-08-26. So: *Director of Firm Operations at a Toronto litigation
|
||
and ADR boutique, with active exposure to construction, personal injury, POA,
|
||
and SABS matters.* Accurate, specific, and it claims nothing it should not.
|
||
|
||
This framing is **interim** — see `AGENTS.md` §12 R1. Raise it with Pouya
|
||
rather than letting it settle in by default.
|
||
- Superlatives. No "leading", "premier", "top-rated", "best". They are
|
||
unverifiable, they read as insecure, and marketing rules for regulated
|
||
professions treat them as suspect.
|
||
- Outcome language that could be read as a guarantee.
|
||
- "Passionate", "dedicated", "committed", "proven track record", "results-driven",
|
||
"leverage", "synergy", "solutions".
|
||
- Hedges that erase the claim. The strategy brief warns specifically against
|
||
softening the technical claim to "technologically literate" — **the claim is
|
||
engineering practice, so the copy says engineering practice.**
|
||
- Em-dash-heavy rhythm and tricolon padding. One idea per sentence.
|
||
- Second-person sales copy on counsel-facing pages. `/for-parties/` is the one
|
||
page written to "you".
|
||
|
||
---
|
||
|
||
## The core positioning statement
|
||
|
||
Reused, adapted, across the hero, the About page, and the PDF bio:
|
||
|
||
> The dispute resolution practice of Pouya Lajevardi — a credentialed neutral
|
||
> who is also close to live litigation and a practising machine-learning and
|
||
> infrastructure engineer. Built for commercial, construction, energy,
|
||
> technology, and cross-cultural disputes that turn on the contract, the code,
|
||
> the engineering documents, and the regulatory overlay around them.
|
||
|
||
Every version of this must survive the §4 check. It does: each element is
|
||
verified.
|
||
|
||
**AMENDED 2026-08-27 — `AGENTS.md` Q41(b). The statement read *"disputes that
|
||
turn on facts most neutrals take on faith: the contract…"* and the comparative
|
||
is struck.** It was not restored, and Pouya gave two reasons, the second of
|
||
which is the one to remember:
|
||
|
||
> "That is an unverifiable empirical claim about other practitioners, and
|
||
> comparative claims must be factual and verifiable. **It is also weaker copy:
|
||
> assert his capability, not the field's incapability.** Rewrite to claim only
|
||
> about himself — 'built for disputes that turn on the contract, the code, and
|
||
> the engineering documents'. Same force, nothing to defend."
|
||
|
||
So the compliance objection and the editorial objection point the same way.
|
||
The checklist item below — *"any comparative claim is factual and verifiable"* —
|
||
had been overridden in practice by the fact that this paragraph was **approved
|
||
copy**, which is how an unverifiable claim ends up inside the document that
|
||
forbids it. The approved copy is what changed.
|
||
|
||
**This is now the ONLY sanctioned form of the statement.** Any earlier draft
|
||
carrying the comparative is superseded, wherever it is quoted.
|
||
|
||
## Approved headline options
|
||
|
||
From the content brief; all three sit honestly with the practice.
|
||
|
||
1. *A mediator who reads the contract, the code, and the room.* — **recommended.**
|
||
The cleanest one-sentence statement of the moat, and rare because it is rare.
|
||
2. *Engineered for the cases that don't fit a courtroom.*
|
||
3. ~~*Disputes resolved by someone who has been on every side of one.*~~
|
||
**Does not clear §4 as written** (flagged 2026-08-26). "Every side" asserts
|
||
having acted as party, as counsel, and as neutral; §4 verifies the neutral
|
||
role and *active litigation exposure*, not the other two. Left in place so
|
||
the option is not silently re-invented — but it cannot be chosen without a §4
|
||
row to choose it from.
|
||
|
||
## The credential row
|
||
|
||
Three slots, never counts:
|
||
|
||
| Slot | Value | Label |
|
||
|---|---|---|
|
||
| 1 | **Q.Med** | ADRIC / ADRIO designation |
|
||
| 2 | **JD + ML** | Legal training and engineering practice |
|
||
| 3 | **EN · FA** | Bilingual practice |
|
||
|
||
**Slot 2's label changed on 2026-08-27 (Pouya, `AGENTS.md` Q37).** It read
|
||
*"Law and engineering"*. His reasoning: *"The parallel was doing the implying — a
|
||
degree and a practice under one noun. The asymmetry is the honest part."* A JD is
|
||
a degree; engineering is a practice, and a verified one. Setting them in parallel
|
||
invited the reader to supply the symmetry, and for "Law" the missing half is a
|
||
licence — which D13 bars by implication as hard as by assertion. The replacement
|
||
is longer and deliberately lopsided. Do not tidy it back into a parallel.
|
||
|
||
**AND THE RULE IS NOT SCOPED TO THIS LABEL — `AGENTS.md` Q41(a), Pouya
|
||
2026-08-27.** Q37 was asked about a credential label; the reasoning applies to
|
||
every surface, prose included:
|
||
|
||
> "Yes, Q37's reasoning reaches prose. The implication test applies everywhere,
|
||
> not just to labels. **Prose has more room, so it is easier to satisfy: state
|
||
> the asymmetry explicitly rather than relying on a parallel construction to
|
||
> carry it.**"
|
||
|
||
Read the second half carefully, because it sets a **higher** bar for prose, not
|
||
a looser one. Deleting the parallel is only half the job — a reader can still
|
||
supply the missing symmetry from silence. Prose has room to say which half is
|
||
which, so it must. Naming the legal half as **training** is what makes the licence
|
||
implication impossible rather than merely absent.
|
||
|
||
**THE SENTENCE IS A CONSTANT, NOT COPY TO BE RETYPED** — `ASYMMETRY_LINE` in
|
||
`src/data/site.ts`:
|
||
|
||
> "The two halves are not the same kind of thing, and the asymmetry is the honest
|
||
> part. A law degree on one side. A working engineering practice on the other.
|
||
> One is training I hold. The other is work I still do."
|
||
|
||
It lives beside `ROLE` for the reason that file gives: *"these are the two where
|
||
the wording IS the compliance."* This paragraph previously quoted it inline and
|
||
cited it as living at "`/`, §The approach" — and by then it had been typed into
|
||
`/about/` too, so there were **three copies and two of them had already
|
||
diverged**: a comma here and on `/`, full stops on `/about/`, all inside the
|
||
session that wrote them. Consume the constant on any page that needs the
|
||
sentence. Do not retype it, do not paraphrase it, and do not quote a variant of
|
||
it in a spec.
|
||
|
||
Fourth slot where the layout has one: **Q.Arb — commenced August 2026.** Use
|
||
that wording, not "in progress": §4 pins it, and the weaker form drifts toward
|
||
"nearly complete", which §4 Forbidden bars outright.
|
||
|
||
**On the home page the fourth slot IS used, and it is not optional there.**
|
||
`docs/01` §`/` says "Three slots"; §4's paired-disclosure condition is the higher
|
||
authority and requires that wherever the site offers arbitration it "states
|
||
plainly" the stage of the arc. `/` says *arbitrator* in its opening sentence, so
|
||
the stage belongs on the same page rather than only in the footer. Rendered as
|
||
value `Q.Arb` over label `Commenced August 2026` — the same wording, with the
|
||
em-dash carried by the layout instead of by the string.
|
||
|
||
The substitution principle (`AGENTS.md` §4): wherever the design wants a "how
|
||
many", substitute a longer-arc credential. These are all true at launch and stay
|
||
true; none grows by closing files.
|
||
|
||
---
|
||
|
||
## Per-page copy notes
|
||
|
||
### Home
|
||
Hero headline from the approved list. Positioning paragraph above. CTAs:
|
||
*Request a consultation →* and *How I work*. The approach section makes the
|
||
"two directions at once" argument — law and engineering converging on the same
|
||
dispute — and keeps the infinity metaphor: *disputes are loops; the work is
|
||
redrawing the loop into a line.* First person: "my mark", not "our mark".
|
||
|
||
> ⚠️ **"law and engineering" IS THE STRUCK CONSTRUCTION. Do not lift this
|
||
> sentence into copy.** The *argument* it names is Pouya's and stands; the noun
|
||
> pair carrying it is what Q37 struck and Q41(a) extended to prose. It reached
|
||
> the page once already, as *"Law and engineering are not blended here"* — the
|
||
> struck parallel relocated from the credential label into body copy, one day
|
||
> after it was struck, and strengthened by attributing both halves to him
|
||
> personally. A spec phrase describing an argument is not approved copy.
|
||
|
||
### About
|
||
400–600 words of narrative, then structured credentials. Tell the three tracks
|
||
as one arc, not three lists: a JD and active litigation exposure; a parallel
|
||
career in machine learning and infrastructure engineering; a company run
|
||
alongside both. The arc is the point — the credentialing pathway from Q.Med
|
||
through Q.Arb to C.Med-Arb is stated openly as in progress. The brief treats
|
||
that arc as part of the story rather than something to obscure.
|
||
|
||
Omit any section that would be empty. No "Speaking" heading until there is a
|
||
talk to list.
|
||
|
||
### Mediation / Arbitration / Med-Arb
|
||
Procedural, specific, unembellished. Name the rules. Describe the formats. State
|
||
what a party should expect to do and when. On `/arbitration/`, state the Q.Arb
|
||
position in plain terms — what is available now versus what follows designation.
|
||
|
||
`/med-arb/` addresses the procedural-fairness objection directly: the same
|
||
neutral who heard a party's confidential caucus later decides the matter. Do not
|
||
elide it. Explain the consent mechanics and when the process is inappropriate.
|
||
Meeting the strongest objection is what makes the page worth reading.
|
||
|
||
### Practice areas
|
||
Each page: dispute types, why this practice fits, what the process looks like,
|
||
and the market context that makes the area live. Context comes from the strategy
|
||
brief §III–IV — Ontario's megaproject pipeline, Bill 40 and grid connection, the
|
||
2026 privacy statute, LAT volumes.
|
||
|
||
**Frame as positioning, not as history.** "Built to facilitate procurement and
|
||
subcontract disputes on Ontario's megaproject pipeline" — not "extensive
|
||
experience resolving". The first is true and forward-looking. The second is
|
||
neither.
|
||
|
||
### Process
|
||
Five steps with real timing. Say what happens if the matter does not settle —
|
||
counsel want to know the downside shape before they commit a client's day.
|
||
|
||
**AMENDED 2026-08-27 — `AGENTS.md` Q43, and it overrides this section's previous
|
||
reading.** "Real timing" was being read as *barring* the word "typical", which
|
||
is why the step-2 build shipped the five timings as bare numbers and escalated
|
||
the question instead of framing them. Pouya ruled the other way:
|
||
|
||
> "The five process timings are **service commitments, same class as Q27's
|
||
> response time** — not facts about Pouya, so they need framing, not a Verified
|
||
> row. Present them as the TYPICAL shape of an engagement, explicitly not a
|
||
> guarantee: mediation timing depends on party and counsel availability, which
|
||
> he does not control. **Published as typical, they are honest and useful;
|
||
> published as commitments, the first matter that slips makes the page false.**"
|
||
|
||
So: the **numbers do not change** — softening them was never the fix and
|
||
inventing them was never on. What "real timing" bars is a *vague* timing
|
||
("promptly", "in a matter of weeks"), not an honest statement of what the
|
||
numbers are. The framing is `PROCESS_FRAMING` in `src/data/site.ts` and it is
|
||
**not optional**: every page that renders the steps renders it, adjacent to the
|
||
numbers rather than in a section lede above them. A reader who scans the strip
|
||
and skips the lede has read a commitment.
|
||
|
||
### Fees
|
||
**Unblocked — Q4/Q14 answered, D14.** Build from the confirmed card in
|
||
`docs/07-fees.md`. Plain table, no "starting from"
|
||
evasions, no "contact for pricing" after promising a rate card.
|
||
|
||
### For parties
|
||
The one page in second person. Grade-9 reading level. Short sentences. Says
|
||
explicitly: the mediator is not your lawyer and cannot give you legal advice; the
|
||
mediator does not decide who is right. Answers what it costs and what happens if
|
||
you do not settle.
|
||
|
||
### Insights
|
||
1,200–1,800 words, monthly cadence (brief §VIII). Territories from §VII:
|
||
process explainers · regulatory commentary · industry dispute commentary ·
|
||
anonymised reflections · technical explainers for lawyers · credentialing content.
|
||
|
||
Every piece links to at least one practice-area page. Anonymised reflections must
|
||
be genuinely unidentifiable — not merely name-stripped. If a matter could be
|
||
recognised by the parties to it, it does not run.
|
||
|
||
### Launch article slate (D9)
|
||
Drafted by Claude, **every word reviewed by Pouya before publication**:
|
||
|
||
1. *What the Ontario data-centre build-out means for dispute resolution* —
|
||
technology + construction; the strongest single differentiator piece.
|
||
2. *When Med-Arb is the right answer, and when it is not* — process explainer;
|
||
feeds `/med-arb/`; high search intent, thin competition.
|
||
3. *Bill 40 and grid connection: a dispute-resolution read* — regulatory
|
||
commentary; establishes the energy niche.
|
||
4. *What a System Impact Assessment actually evaluates* — technical explainer for
|
||
lawyers; the clearest demonstration of the claim the whole brand rests on.
|
||
5. *Choosing a neutral: what counsel should actually ask* — evergreen, useful,
|
||
and it makes the case for this practice without arguing for it.
|
||
|
||
---
|
||
|
||
## Compliance checklist — before any page ships
|
||
|
||
- [ ] Every factual claim appears in `AGENTS.md` §4 Verified
|
||
- [ ] No matter counts, settlement rates, dollar figures, or time-to-award stats
|
||
- [ ] No testimonials, endorsements, or third-party quotes
|
||
- [ ] No superlatives and no guarantee language
|
||
- [ ] No claim or implication of legal licensure anywhere (D13)
|
||
- [ ] Q.Arb described as commenced August 2026, never as held or nearly complete
|
||
- [ ] Nothing implies a firm, a team, or offices that do not exist
|
||
- [ ] Contact page states that an inquiry creates no retainer and no
|
||
mediator–party relationship
|
||
- [ ] Any comparative claim is factual and verifiable
|