Files
adr-sml/docs/03-content-spec.md
T
Pouya LajevardiandClaude Opus 5 c576b9a85f
Build and deploy / build-and-deploy (push) Failing after 6s
feat: build step 3 — /about/, minus its memberships; close Q40–Q43
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
2026-08-28 12:10:41 -04:00

16 KiB
Raw Blame History

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 RETYPEDASYMMETRY_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

400600 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 §IIIIV — 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,2001,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 mediatorparty relationship
  • Any comparative claim is factual and verifiable