The re-audit of the deploy-guard change surfaced defects well outside the diff, including one that would have broken production mail. docs/05-backend-spec.md had the two SES DKIM sets exactly inverted, labelling the three records that resolve as "orphans" and the three NXDOMAIN records as "Live. Never delete". Entry (j) corrected this in AGENTS.md §7 and the correction never reached docs/05. Since SES has no custom MAIL FROM, DKIM is the only thing satisfying DMARC, so acting on that table would have silently broken intake mail authentication. Also in this change: - .gitea/workflows/deploy.yml gains a guard as steps[0] that fails the run, naming the variable, if AWS_REGION, S3_BUCKET or CLOUDFRONT_DISTRIBUTION_ID is empty — how a Gitea too old for the vars context manifests. Verified fail-closed under bash -e, sh -e and bash -euo pipefail. - AGENTS.md Current Truth: SPF and DMARC recorded as present (Q20), the matching §10 High risk row retired, three duplicate Q rows removed. - docs/reference/AWS-Hosting-Guide.md tracked and given a do-not-execute banner; it was an executable procedure for the architecture D1/D3 replace. - Copy decks: "a working litigator" and "an active litigation practice" replaced with the register's own wording; LegalService JSON-LD replaced with ProfessionalService; tribunal-secretary offers removed per D14; nine stale question blockers swept. - astro.config.mjs: prefetchAll disabled — it injected JS into every page against the zero-JS convention with no decision recorded. - src/data/site.ts: unregistered response-time commitment nulled (Q27); OBA section names downgraded to [assumed] (Q28). - s3:AbortMultipartUpload reasoning corrected to measure ./dist, not the repo. Opens Q27, Q28, Q29. AGENTS.md entry (q) records the full resolution, including the findings declined and why. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012XquaEq4BgWMCwUqLEyNkF
202 lines
9.1 KiB
Markdown
202 lines
9.1 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. "Sole-arbitrator appointments follow the Q.Arb designation;
|
||
co-arbitration work is available now." (**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 facts most neutrals take
|
||
> on faith: 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.
|
||
|
||
## 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.*
|
||
|
||
## The credential row
|
||
|
||
Three slots, never counts:
|
||
|
||
| Slot | Value | Label |
|
||
|---|---|---|
|
||
| 1 | **Q.Med** | ADRIC / ADRIO designation |
|
||
| 2 | **JD + ML** | Law and engineering |
|
||
| 3 | **EN · FA** | Bilingual practice |
|
||
|
||
Fourth slot where the layout has one: **Q.Arb** — in progress.
|
||
|
||
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".
|
||
|
||
### 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.
|
||
|
||
### 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
|