Pouya LajevardiandClaude Opus 5
610edc24fd
Pouya's ruling, 2026-08-29. Treated as D3-class and swept accordingly. §4 Q.Arb becomes a HELD designation. Obtained July 2026 — recorded in the register, deliberately not published. Public copy carries "Q.Arb (ADRIC / ADRIO)" beside Q.Med and nothing more. Every stage form is struck: "commenced", "in progress", "pathway", "not yet". C.Med-Arb as a stated goal is struck. This DEVIATES FROM THE STRATEGY BRIEF, which made it "the explicit long-term professional narrative"; the brief is not in this repository, so the deviation is recorded in four places so nobody reinstates it from a document no reader can open. The designation stays in §11 as a definition — what is struck is its status as a goal of his. The paired-disclosure condition dissolves. It existed only because Q.Arb was in progress; there is no stage left to disclose, and a condition with no subject cannot be half-kept. Pages /about/'s credentialing arc is DELETED, not rewritten — two held designations are not a journey. /arbitration/ loses its stage section and its "Available now, and open about the stage" h1. /med-arb/'s endpoint section is rewritten. Deleting CREDENTIALS.goal/goalName rather than emptying them turned every consumer into a build error, which is how the last two surfaced. hasCredential now maps CREDENTIALS.designations instead of indexing [0]; _DesignationRowParity pins the visible credential row to the same constant. check:claims q-arb-as-a-stage (inverted from the predecessor, which barred Q.Arb reading as HELD) and c-med-arb-struck. Each page is now scanned twice — as published, and with inline tags collapsed — because [^<] cannot cross <strong>, which this site sets in prose. Two open questions for Pouya, neither blocking: Q55 — the acquisition date. §4 says obtained July 2026; the Change Log of 2026-08-26 records "commenced August 2026", both stamped [verified — Pouya]. They cannot both be true. Nothing published turns on it. Q56 — is the mediation offering scoped commercial? §4 leaves it unscoped; four surfaces say "commercial mediation"; /practice/insurance/ offers mediation in insured-versus-insurer SABS matters. Two review rounds, all findings applied or declined with a stated reason. Round 2 found ten lines in docs/03 still instructing the struck form — the 2026-08-29 sweep missed them because `git grep 'Q.Arb'` is line-anchored and the block never names it. Sweep the vocabulary, not only the subject. Gates, exit statuses read directly, never through a pipe: npm run check exit=0 (0 errors, 0 warnings, 0 hints) npm run lint exit=0 npm run build exit=0 (12 pages) npm run check:claims exit=0 (11 patterns, 26 approved strings) npm audit exit=0 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Md3GndFqWPzK78xAoebsg5
14 KiB
04 — Discoverability
The problem this project exists to fix. AGENTS.md §2 has the measurements.
Those measurements are under review —
AGENTS.mdQ34. They were taken on 2026-08-25; a re-fetch on 2026-08-26 returned a bundler harness whose real<head>sits JSON-escaped inside a<script>and whose application lives in nine UUID-named files that were not fetched. Some of §2 reproduced exactly (the 2.2 MB single file, the placeholder<title>); some could not be reproduced from the served HTML at all. Cite §2, and cite Q34 with it. Do not put any of these figures in public copy until Q34 closes.
The baseline being replaced
Now [verified 2026-08-25] |
Target | |
|---|---|---|
| Content in server HTML | SML Company · DISPUTE RESOLUTION · Unpacking... |
Every word |
| Indexable pages | 1 | 17 + articles (19 fixed URLs, less the two /legal/* pages, which are noindex and excluded from the sitemap) |
<title> |
SML Company · Dispute Resolution — pre-rebrand placeholder |
Unique per page |
| Meta description | none | Unique per page |
<meta viewport> |
absent | Present |
| Canonical URL | none | Every page |
| OG / Twitter tags | none | Every page |
| Structured data | none | Person, ProfessionalService, Article, FAQ, Breadcrumb |
robots.txt |
403 | Served |
| Sitemap | none | Generated at build |
| Favicon | none | Full set |
Astro's static output solves most of this by existing. The rest is the spec below.
Why static output matters more than usual here
Google can sometimes render client-side JavaScript. Bing largely does not. LinkedIn's preview crawler does not. Slack's unfurler does not. And the crawlers behind AI assistants — increasingly how counsel and in-house teams find a neutral — generally do not.
A site that requires three CDN round trips and an in-browser Babel compile before producing a sentence is invisible to all of them. That is the whole argument for D1.
Metadata
Every page passes through one SEO component. A page without it is not finished.
title 50–60 chars, unique. Pattern: "<Page> · Pouya Lajevardi".
`/` composes its own from the constants — `SITE.name` +
`SITE.tagline` — rather than a literal, so the masthead and
the title cannot drift. This spec carried the literal with an
ampersand after the composition shipped with interpuncts;
cite the constants, do not restate them (AGENTS.md §7 rule).
ARTICLES ARE THE EXCEPTION: no " · Pouya Lajevardi" suffix.
The suffix is 18 chars, so a headline that already reads
50–60 renders at 68–78 — over this ceiling. Measured against
the five launch headlines in 03-content-spec.md, the suffix
rule fails 5 of 5; without it, 4 of 5 pass. An article's
headline IS its <title>; `seoTitle` in the frontmatter
overrides it when a headline that reads well is out of range.
src/content.config.ts enforces this and names the offending
string and its length in the build error.
description 140–160 chars, unique, written for a human, not stuffed
canonical absolute, https, trailing slash
og:title/description/image/url/type/site_name/locale (en_CA)
twitter:card summary_large_image
robots index,follow — except /legal/* which is noindex,follow
OG images: 1200 × 630. Never a screenshot.
RULED 2026-08-27 (AGENTS.md Q40, R15) — TWO kinds of card, not one, and the
generator is deferred to build step 7. This spec said "one template" for all
nineteen pages. Pouya split it:
"A portrait is the right OG image for
/and/about/— a face is the strongest social preview for a personal brand. It is the wrong one for nineteen pages, where a typed card carrying the page title would do the work.But do not build the generator now and do not leave 'portrait everywhere' as an untracked interim. Ship it at step 7 alongside Insights, which needs per-article cards anyway — one build, one dependency, one review."
So:
| Pages | Card |
|---|---|
/ and /about/ |
The portrait crop, src/assets/og-portrait.jpg. Not an interim — the decided answer |
| Every other page | Generated at build with satori or astro-og-canvas, using the site's own type and palette: display headline on cream, infinity mark, designation line |
| Each article | Per-article card from the same generator — the reason the two jobs are one build |
Until step 7 every page shares the portrait, and that is a RECORDED interim
that blocks cutover, not build step 3. It is tracked as R15 in
AGENTS.md §12 with its removal trigger, because a link preview nobody on the
team ever sees is exactly the kind of interim that becomes permanent by
never being raised. The dependency choice is made against R11 on the day, not
recalled from this paragraph.
Structured data
JSON-LD only. Validate against Google's Rich Results Test before cutover.
| Type | Where | Notes |
|---|---|---|
Person |
/about/, referenced site-wide |
Emitted: name, url, jobTitle, description, alumniOf (Bond University), knowsLanguage (en, fa), hasCredential (Q.Med, Q.Arb — both, since 2026-08-29), sameAs (LinkedIn), email, image. Emitted on /about/ only: memberOf — the four §4 memberships as Organization nodes (Q53, ruled 2026-08-28). / shows no memberships, so its Person node omits it: structured data represents the page it sits on. Withheld: worksFor — Q49(b) declined the row 2026-08-28 and Pouya confirmed the reading 2026-08-29, so it is settled rather than pending; provider → Person → worksFor would assert a same-entity claim §4 does not row. (This enumeration listed worksFor as emitted while the same cell said it was withheld, and omitted url and email, which are — wrong in both directions. The enumeration is the part an implementer copies. Found by adversarial-reviewer.) CHANGED 2026-08-28 — Q47. This row read "jobTitle = 'Director of Firm Operations'; omit worksFor", which put the boutique title on a node whose url is this ADR practice's /about/ — so a consumer could attach it to this entity. Pouya's ruling reframes the field: jobTitle describes this practice, not the boutique role, which D16 keeps unnamed. The visible role line is unchanged and still reads "Director of Firm Operations at a Toronto litigation and ADR boutique". THE VALUE IS PRACTICE_JOB_TITLE IN src/data/site.ts AND THIS ROW DOES NOT RESTATE IT — §7's rule, applied to a string with a live revert trigger on it: this row carried the literal text for one pass, and adversarial-reviewer noted it would go stale the moment the constant moved. Cite, do not copy. worksFor IS WITHHELD — set for one pass under Q47, then reverted: ProfessionalService.provider is this Person, so provider → Person → worksFor asserts the same-entity claim schema.ts explicitly declines, and §4 says "alongside the practice" where the ruling says "operates through". memberOf is emitted — see the sentence above; Q53 closed 2026-08-28. (This cell asserted memberOf was both emitted and withheld for one pass, which is the defect it already records itself being caught for on worksFor, in the opposite direction. The enumeration is the part an implementer copies.) See src/data/schema.ts |
ProfessionalService |
Home | areaServed Toronto/Ontario, serviceType Mediation / Commercial arbitration / Mediation-arbitration (med-arb) — scoped 2026-08-28 on claims-auditor's finding; this row instructed the unscoped class form "Mediation/Arbitration" that Q39 struck and that schema.ts deliberately does not follow. Family arbitration carries prescribed training and has its own NOT OFFERED row, so unscoped "Arbitration" is the struck universal in a field nobody reads. Do not widen these strings without a §4 row to widen them from — provider → Person, priceRange once /fees/ is real. Never LegalService — schema.org defines it as a business providing legal advice and representation, which asserts in machine-readable form exactly what D13 bars and §4 Forbidden calls out |
Service |
/mediation/, /arbitration/, /med-arb/ and each practice page |
serviceType, provider → Person, areaServed. The Person node travels in the same @graph so provider: {'@id'} resolves in one document rather than relying on a crawler joining two — homeGraph's reasoning, applied. serviceType is scoped where §4 scopes it: Commercial arbitration, never a bare "Arbitration". No BreadcrumbList on the three — one hop from the root, no visible breadcrumb, and this spec requires the markup to match the visible one |
Article |
Each article | headline, description, datePublished, dateModified, author → Person, image |
BreadcrumbList |
All nested pages | Matches visible breadcrumbs |
FAQPage |
/for-parties/, /med-arb/ |
Only where the visible page genuinely is Q&A. Never fabricate questions to farm a rich result |
hasCredential must reflect reality. ⚠️ Q.Med AND Q.Arb are both held as
of 2026-08-29 (AGENTS.md §4) and the field carries both — it was Q.Med-only
while Q.Arb was a commenced pathway. The rule is unchanged and cuts both ways:
marking an unheld credential as held is a misrepresentation that happens to be
machine-readable, and omitting a held one understates the record in a field
whose whole meaning is "holds". personNode maps CREDENTIALS.designations
rather than indexing it, so a designation added to that constant reaches the
graph automatically. That links the CONSTANT to the graph, not §4 to the
graph — a designation added to §4 and not to src/data/site.ts still drifts
silently, and no mechanism catches it. src/data/schema.ts states the condition
in full; this sentence overstated it for one pass.
Crawlability
public/robots.txt is the artefact — read it, do not read a copy of it
here. This spec used to reproduce the file inline and the reproduction had
already drifted from it by 2026-08-26, which is the failure mode the AGENTS.md
§7 rule exists to stop.
It disallows nothing, and that is deliberate. This spec previously
prescribed Disallow: /legal/ alongside noindex on those pages, and the two
cancel each other: a crawler forbidden to fetch a URL never reads the
noindex on it. /legal/privacy/ and /legal/terms/ are linked from the
footer of every page, so they are discovered regardless — and the likely result
of the pair was Google listing the bare URLs as "no information available", the
opposite of the intent, with the directive that would have suppressed them
sitting unread behind the wall. noindex is what de-indexes; Disallow is
what prevents fetching. Use the one that matches the problem, and never both
on the same path.
Do not block AI crawlers. Being read by an assistant that a general counsel is using to shortlist neutrals is the point.
Sitemap: @astrojs/sitemap, excluding /legal/* and any draft: true
article. Submit to Google Search Console and Bing Webmaster Tools at cutover.
Internal linking. Every practice page links to /mediation/ and
/arbitration/; those link back to the practice areas; every article links to
at least one practice page. This is what turns Insights into ranking power for
the pages that convert. Breadcrumbs on every nested page.
404 page. Real, styled, with search-intent links out. CloudFront must return it with a genuine 404 status — not a 200, which the S3 website-endpoint pattern gets wrong by default.
Performance
Core Web Vitals are a ranking input, and the current build fails all of them.
| Metric | Budget |
|---|---|
| LCP | < 2.0 s, Slow 4G |
| CLS | < 0.05 |
| INP | < 150 ms |
| JS per route | < 100 KB |
| Lighthouse (mobile) | ≥ 95 all four categories — not measurable until step 7, see below |
⚠️ Lighthouse verification is UNAVAILABLE until build step 7.
@lhci/cliwas removed on 2026-08-26 — it was the sole source of all 10npm auditfindings (7 high),0.15.1islatestso there was no clean upgrade, and it could not run at all with no pages and nolighthouserc. The budget below is not suspended; the tool that measures it is absent. Re-add at step 7 underAGENTS.mdR11, checking for a patched release rather than assuming0.15.1is still the ceiling. Until then, a run that skips this is skipping something known — not something forgotten.AGENTS.md§7 has the state.
How: static HTML, self-hosted preloaded subset fonts, AVIF/WebP with explicit
dimensions, critical CSS inlined, no third-party scripts on any page except the
booking embed on /contact/ — and that one is lazy-loaded behind a click.
Local and professional presence
Not code, but it belongs in the launch checklist: Google Business Profile for the practice; ADRIC and ADRIO directory listings pointing at the site; a LinkedIn profile whose headline and Featured section match the brand (brief §VIII); consistent naming across all of them. Not "name, address and phone" — §4 publishes no phone number and no street address, only "Toronto, Ontario; by appointment". Directory forms that demand a full NAP get what §4 verifies and nothing more.
Post-launch verification
curl -s https://adr.smlcompany.ca/ | grep -c "<h1"returns ≥ 1- Every page renders its full text with JavaScript disabled
- Rich Results Test passes on Person, ProfessionalService, Article
- OG preview renders correctly in LinkedIn Post Inspector and Slack
- Sitemap submitted to Google Search Console and Bing
- No page returns 200 for a URL that should 404
- Lighthouse ≥ 95 mobile on
/,/about/, one practice page, one article — blocked until@lhci/cliis re-added at step 7. Do not tick this box from a manual Chrome DevTools run and call it the same check