chore: project scaffold, specs, and working record
Build and deploy / build-and-deploy (push) Failing after 5s
Build and deploy / build-and-deploy (push) Failing after 5s
This commit is contained in:
Pouya Lajevardi
@@ -0,0 +1,18 @@
|
||||
# Copy to .env.local for development. Never commit .env files.
|
||||
|
||||
# Canonical site URL — drives canonical tags, OG tags, and the sitemap.
|
||||
PUBLIC_SITE_URL=https://adr.smlcompany.ca
|
||||
|
||||
# Intake form endpoint — API Gateway HTTP API 'adr-intake-api', ca-central-1.
|
||||
# [verified 2026-08-26]
|
||||
PUBLIC_INTAKE_ENDPOINT=https://4tl0m5igkj.execute-api.ca-central-1.amazonaws.com
|
||||
|
||||
# Analytics — privacy-first and cookieless (AGENTS.md D15).
|
||||
# Plausible or Fathom. No GA4, no consent banner. Leave blank in development.
|
||||
PUBLIC_ANALYTICS_PROVIDER=plausible
|
||||
PUBLIC_ANALYTICS_DOMAIN=adr.smlcompany.ca
|
||||
|
||||
# Booking embed — PARKED by Pouya, 2026-08-26 (AGENTS.md R6).
|
||||
# /contact/ ships with the intake form and a reserved slot; leave this empty
|
||||
# and the booking section does not render. Adding a URL later is a drop-in.
|
||||
PUBLIC_BOOKING_URL=
|
||||
@@ -0,0 +1,104 @@
|
||||
# Gitea Actions — the live pipeline for this repository.
|
||||
#
|
||||
# Gitea Actions speaks GitHub Actions syntax, so this is a near-direct port of
|
||||
# .github/workflows/deploy.yml (kept as the OIDC reference in case the repo ever
|
||||
# moves to GitHub or GitLab).
|
||||
#
|
||||
# ONE REAL DIFFERENCE: Gitea is not an AWS OIDC provider, so there is no role to
|
||||
# assume. Deploys authenticate with a SCOPED IAM USER whose key lives only in
|
||||
# this repository's Gitea secrets. See docs/06-deployment.md for the exact IAM
|
||||
# policy — it grants four actions on one bucket and one distribution, nothing
|
||||
# more. Rotate the key quarterly; OIDC would have made that unnecessary.
|
||||
#
|
||||
# Requires a Gitea Actions runner registered to this repo or its organisation.
|
||||
|
||||
name: Build and deploy
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
workflow_dispatch:
|
||||
|
||||
concurrency:
|
||||
group: deploy-production
|
||||
cancel-in-progress: false
|
||||
|
||||
jobs:
|
||||
build-and-deploy:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
env:
|
||||
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
|
||||
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
|
||||
AWS_DEFAULT_REGION: ${{ vars.AWS_REGION }}
|
||||
S3_BUCKET: ${{ vars.S3_BUCKET }}
|
||||
CLOUDFRONT_DISTRIBUTION_ID: ${{ vars.CLOUDFRONT_DISTRIBUTION_ID }}
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version-file: .nvmrc
|
||||
cache: npm
|
||||
|
||||
- name: Install
|
||||
run: npm ci
|
||||
|
||||
- name: Type and template check
|
||||
run: npm run check
|
||||
|
||||
- name: Build
|
||||
run: npm run build
|
||||
env:
|
||||
PUBLIC_SITE_URL: https://adr.smlcompany.ca
|
||||
PUBLIC_INTAKE_ENDPOINT: ${{ vars.INTAKE_ENDPOINT }}
|
||||
PUBLIC_BOOKING_URL: ${{ vars.BOOKING_URL }}
|
||||
|
||||
# Some Gitea runner images ship without the AWS CLI. Install if missing.
|
||||
- name: Ensure AWS CLI
|
||||
run: |
|
||||
if ! command -v aws >/dev/null 2>&1; then
|
||||
curl -fsSL "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o /tmp/awscliv2.zip
|
||||
unzip -q /tmp/awscliv2.zip -d /tmp
|
||||
sudo /tmp/aws/install --update
|
||||
fi
|
||||
aws --version
|
||||
|
||||
- name: Verify credentials
|
||||
run: aws sts get-caller-identity
|
||||
|
||||
# Two passes: hashed immutable assets first, HTML last. A visitor must
|
||||
# never fetch a new page whose assets have not landed yet.
|
||||
- name: Sync hashed assets
|
||||
run: |
|
||||
aws s3 sync ./dist "s3://${S3_BUCKET}" \
|
||||
--exclude "*" \
|
||||
--include "_astro/*" --include "fonts/*" \
|
||||
--cache-control "public, max-age=31536000, immutable" \
|
||||
--no-progress
|
||||
|
||||
- name: Sync images
|
||||
run: |
|
||||
aws s3 sync ./dist "s3://${S3_BUCKET}" \
|
||||
--exclude "*" \
|
||||
--include "*.avif" --include "*.webp" --include "*.jpg" \
|
||||
--include "*.png" --include "*.svg" \
|
||||
--cache-control "public, max-age=604800" \
|
||||
--no-progress
|
||||
|
||||
- name: Sync HTML and the rest
|
||||
run: |
|
||||
aws s3 sync ./dist "s3://${S3_BUCKET}" \
|
||||
--exclude "_astro/*" --exclude "fonts/*" \
|
||||
--cache-control "public, max-age=0, must-revalidate" \
|
||||
--delete --no-progress
|
||||
|
||||
- name: Invalidate CloudFront
|
||||
run: |
|
||||
aws cloudfront create-invalidation \
|
||||
--distribution-id "${CLOUDFRONT_DISTRIBUTION_ID}" \
|
||||
--paths "/*"
|
||||
|
||||
- name: Summary
|
||||
run: echo "Deployed to https://adr.smlcompany.ca — commit ${GITHUB_SHA:0:7}"
|
||||
@@ -0,0 +1,93 @@
|
||||
# ---------------------------------------------------------------------------
|
||||
# REFERENCE ONLY. This repository lives on self-hosted Gitea (AGENTS.md D3).
|
||||
# The live pipeline is .gitea/workflows/deploy.yml.
|
||||
#
|
||||
# This file is kept because it is the better design: GitHub OIDC issues a
|
||||
# short-lived token per run instead of a static key. If the project ever moves
|
||||
# to GitHub or GitLab, use this and delete the static IAM user.
|
||||
# ---------------------------------------------------------------------------
|
||||
name: Build and deploy
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
workflow_dispatch:
|
||||
|
||||
# OIDC role assumption — no long-lived AWS credentials in this repository.
|
||||
# See docs/06-deployment.md for the one-time IAM setup.
|
||||
permissions:
|
||||
contents: read
|
||||
id-token: write
|
||||
|
||||
concurrency:
|
||||
group: deploy-production
|
||||
cancel-in-progress: false
|
||||
|
||||
jobs:
|
||||
build-and-deploy:
|
||||
runs-on: ubuntu-latest
|
||||
environment: production
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- uses: actions/setup-node@v4
|
||||
with:
|
||||
node-version-file: .nvmrc
|
||||
cache: npm
|
||||
|
||||
- name: Install
|
||||
run: npm ci
|
||||
|
||||
- name: Type and template check
|
||||
run: npm run check
|
||||
|
||||
- name: Build
|
||||
run: npm run build
|
||||
env:
|
||||
PUBLIC_SITE_URL: https://adr.smlcompany.ca
|
||||
PUBLIC_INTAKE_ENDPOINT: ${{ vars.INTAKE_ENDPOINT }}
|
||||
PUBLIC_BOOKING_URL: ${{ vars.BOOKING_URL }}
|
||||
|
||||
# TODO(pouya): AGENTS.md Q9, Q10 — set these repository variables:
|
||||
# AWS_DEPLOY_ROLE_ARN, AWS_REGION, S3_BUCKET, CLOUDFRONT_DISTRIBUTION_ID
|
||||
- name: Configure AWS credentials
|
||||
uses: aws-actions/configure-aws-credentials@v4
|
||||
with:
|
||||
role-to-assume: ${{ vars.AWS_DEPLOY_ROLE_ARN }}
|
||||
aws-region: ${{ vars.AWS_REGION }}
|
||||
|
||||
# Two passes: hashed immutable assets first, HTML last. A visitor must
|
||||
# never fetch a new page whose assets have not landed yet.
|
||||
- name: Sync hashed assets
|
||||
run: |
|
||||
aws s3 sync ./dist "s3://${{ vars.S3_BUCKET }}" \
|
||||
--exclude "*" \
|
||||
--include "_astro/*" --include "fonts/*" \
|
||||
--cache-control "public, max-age=31536000, immutable" \
|
||||
--no-progress
|
||||
|
||||
- name: Sync images
|
||||
run: |
|
||||
aws s3 sync ./dist "s3://${{ vars.S3_BUCKET }}" \
|
||||
--exclude "*" \
|
||||
--include "*.avif" --include "*.webp" --include "*.jpg" \
|
||||
--include "*.png" --include "*.svg" \
|
||||
--cache-control "public, max-age=604800" \
|
||||
--no-progress
|
||||
|
||||
- name: Sync HTML and the rest
|
||||
run: |
|
||||
aws s3 sync ./dist "s3://${{ vars.S3_BUCKET }}" \
|
||||
--exclude "_astro/*" --exclude "fonts/*" \
|
||||
--cache-control "public, max-age=0, must-revalidate" \
|
||||
--delete --no-progress
|
||||
|
||||
- name: Invalidate CloudFront
|
||||
run: |
|
||||
aws cloudfront create-invalidation \
|
||||
--distribution-id "${{ vars.CLOUDFRONT_DISTRIBUTION_ID }}" \
|
||||
--paths "/*"
|
||||
|
||||
- name: Summary
|
||||
run: echo "Deployed to https://adr.smlcompany.ca — commit ${GITHUB_SHA::7}" >> "$GITHUB_STEP_SUMMARY"
|
||||
+48
@@ -0,0 +1,48 @@
|
||||
# dependencies
|
||||
node_modules/
|
||||
.pnp
|
||||
.pnp.js
|
||||
|
||||
# build output
|
||||
dist/
|
||||
.output/
|
||||
.vercel/
|
||||
.netlify/
|
||||
|
||||
# astro
|
||||
.astro/
|
||||
|
||||
# environment — never commit
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
|
||||
# credentials — never commit
|
||||
*.pem
|
||||
*.key
|
||||
aws-credentials*
|
||||
.aws/
|
||||
|
||||
# logs
|
||||
*.log
|
||||
npm-debug.log*
|
||||
yarn-debug.log*
|
||||
yarn-error.log*
|
||||
pnpm-debug.log*
|
||||
|
||||
# editor / os
|
||||
.vscode/*
|
||||
!.vscode/extensions.json
|
||||
.idea/
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# test / tooling caches
|
||||
coverage/
|
||||
.eslintcache
|
||||
.cache/
|
||||
playwright-report/
|
||||
test-results/
|
||||
|
||||
# generated inventory — safe to share, but not tracked
|
||||
aws-inventory.txt
|
||||
@@ -0,0 +1,566 @@
|
||||
# Agent Working File
|
||||
|
||||
This file is a **living document** and a **full history tree** for this project —
|
||||
not a snapshot. Any agent or person working here (Claude in chat, Claude Code,
|
||||
Claude Cowork, or a human) maintains it by the rules below. Everything else in
|
||||
this file varies by project; these rules do not.
|
||||
|
||||
## How to maintain this file
|
||||
|
||||
1. **Document everything.** On every change, record what was discussed, decided,
|
||||
changed, or planned — decisions and plans included, not just executed work.
|
||||
|
||||
2. **Never overwrite or delete history.** When something changes, update the
|
||||
relevant Current Truth section in place **and** append a dated Change Log
|
||||
entry capturing old → new and why.
|
||||
|
||||
3. **Two parts, kept separate:** *Current Truth* is updated in place and always
|
||||
reflects the present state; the *Change Log* is append-only, newest entry
|
||||
first, and is never edited retroactively.
|
||||
|
||||
4. **Stamp facts** as `[verified YYYY-MM-DD]` or `[assumed]`. When you re-check a
|
||||
fact, re-stamp it with today's date; a stale date means it needs re-verifying.
|
||||
|
||||
5. **Never prune the Change Log.** If the file gets unwieldy, ask before
|
||||
archiving old entries to `AGENTS-history.md`. History is not destroyed.
|
||||
|
||||
---
|
||||
|
||||
# Current Truth
|
||||
|
||||
## 1. What this project is
|
||||
|
||||
A ground-up rebuild of **adr.smlcompany.ca**, the personal-brand website of the
|
||||
alternative dispute resolution practice of **Pouya Lajevardi**. `[verified 2026-08-25]`
|
||||
|
||||
The brand's centre of gravity is the **practitioner**, not the firm and not
|
||||
SML Company Ltd. Legal background, firm affiliation, and the operating company
|
||||
are credibility signals referenced in support; they are not the subject.
|
||||
`[verified 2026-08-25 — source: PL_ADR_Personal_Branding_Strategy_Brief.docx]`
|
||||
|
||||
**Positioning in one sentence:** a credentialed neutral who is also a working
|
||||
litigator and a practising machine-learning / infrastructure engineer — a
|
||||
combination that is close to absent from Canadian ADR rosters, and which is the
|
||||
practice's economic moat. `[verified 2026-08-25 — source: strategy brief §I, §V]`
|
||||
|
||||
**Time horizon:** the strategy brief plans a 24-month compounding arc. The site
|
||||
is built to be added to continuously, not shipped once. `[verified 2026-08-25]`
|
||||
|
||||
## 2. State of the thing being replaced
|
||||
|
||||
The site live at `adr.smlcompany.ca` as of this entry: `[verified 2026-08-25]`
|
||||
|
||||
- It is a **single 2.2 MB HTML file** containing an entire React application,
|
||||
compiled **in the browser at runtime** by Babel Standalone loaded from unpkg.
|
||||
- React and ReactDOM are loaded as **development** builds from a public CDN.
|
||||
- **Crawlers see almost nothing.** A server-side fetch of the URL returns only
|
||||
`SML Company`, `DISPUTE RESOLUTION`, and the loading string `Unpacking...`.
|
||||
Every word of real content is assembled client-side after three CDN round
|
||||
trips. `[verified 2026-08-25 — direct fetch]`
|
||||
- The deployed `<head>` has **no `<meta name="viewport">`**, no meta
|
||||
description, no Open Graph or Twitter card tags, no canonical URL, and no
|
||||
favicon. `[verified 2026-08-25]`
|
||||
- `robots.txt` returns **403**. There is no sitemap. `[verified 2026-08-25]`
|
||||
- The two logo PNGs are ~1 MB combined and are **base64-inlined** into the HTML,
|
||||
so they cannot be cached separately from the page. `[verified 2026-08-25]`
|
||||
- `<title>` is still `SML Company · Dispute Resolution` — the pre-rebrand
|
||||
placeholder title. `[verified 2026-08-25]`
|
||||
- There is **no version control, no build step, and no test suite**. The
|
||||
publishing mechanism is a Python script (`rebuild-standalone.py`) that inlines
|
||||
the JSX components into the single file. `[verified 2026-08-25]`
|
||||
- The May 2026 content brief was **partially applied** — the JSX components
|
||||
under `components-standalone/` contain the corrected Pouya-branded copy, but
|
||||
the document `<head>` and some structural defaults still carry placeholder
|
||||
content. `[verified 2026-08-25]`
|
||||
|
||||
**Consequence, stated plainly:** for a site whose entire purpose is to be found
|
||||
by counsel, general counsel, and appointing bodies searching for a neutral, the
|
||||
current architecture is close to a worst case. This rebuild is justified on
|
||||
architecture alone, independent of any content or design opinion.
|
||||
`[verified 2026-08-25]`
|
||||
|
||||
## 3. Locked decisions
|
||||
|
||||
Decided with Pouya on 2026-08-25. Each of these is settled; do not re-open one
|
||||
without an explicit instruction and a Change Log entry. `[verified 2026-08-25]`
|
||||
|
||||
| # | Decision | Chosen | Rejected alternatives |
|
||||
|---|---|---|---|
|
||||
| D1 | Framework | **Astro**, static output | Next.js; patching the single-file build; hand-written HTML |
|
||||
| D2 | Content scope | **Full re-architecture** — new IA, new pages, all copy rewritten | Copy rewrite on existing structure; audit only; technical layer only |
|
||||
| D3 | Hosting & CI/CD | **Git repo + Gitea Actions → existing S3 + CloudFront.** *Amended 2026-08-26:* self-hosted **Gitea**, repo `adr-sml`. Gitea Actions uses GitHub Actions syntax, so the workflow ports nearly as is — but Gitea is not an AWS OIDC provider, so deploys authenticate with a **scoped IAM user**, rotated quarterly | GitHub Actions + OIDC; Terraform/CDK IaC; Amplify; manual deploys |
|
||||
| D4 | Languages | **English only** | Full EN/FA bilingual; EN + one Farsi page; EN with FA scaffolding |
|
||||
| D5 | Page structure | **Full multi-page**, ~20 URLs | Lean six-page; rich home + a few deep pages |
|
||||
| D6 | Primary audience | **All four tiers**, served by different surfaces (see §5) | Single-audience focus |
|
||||
| D7 | Visual design | **Keep palette and infinity mark; modernize the execution** | Faithful port; strip motion only; fresh design direction |
|
||||
| D8 | Fees | **Full rate card published on a `/fees/` page** | Ranges only; on request; gated PDF |
|
||||
| D9 | Insights | **Build it and launch with 3–5 drafted pieces**, every word reviewed by Pouya before publication | Launch empty; no Insights section |
|
||||
| D10 | Intake | **Rebuilt intake form + calendar booking** for the confidential intake call | Structured questionnaire; form only; email/phone only |
|
||||
| D11 | Rollout | **Build everything, one clean cutover.** The current site stays live untouched until replaced | Patch live site first; staging subdomain; take site down |
|
||||
| D12 | Agent working file | **This file**, maintained under the constitution above | Ad hoc notes |
|
||||
| D13 | Licensure claims | **The site asserts the JD only.** No claim of licensure, call to the bar, or entitlement to practise law. The approved phrasing for the boutique role is **"active litigation exposure"** or **"involvement in litigation and ADR matters"** — never "practice". Pouya's direction, 2026-08-26. **Explicitly interim — see Standing Reminders §12** | Stating LSO licence status; the word "practice" |
|
||||
| D14 | Fee structure | **Single published rate card, all mediation matters at one rate.** Confirmed by Pouya 2026-08-26; figures in `docs/07-fees.md`. No tribunal-secretary line | Two-tier card (recommended by Claude, declined); ranges; fees on request |
|
||||
| D15 | Analytics | **Privacy-first and cookieless** (Plausible or Fathom). No cookie banner, nothing to consent to, one line in the privacy policy | GA4; no analytics at all |
|
||||
| D16 | Naming the boutique | **Never named.** Referred to throughout as *a Toronto litigation and ADR boutique*. Pouya's decision, 2026-08-26 | Naming the firm |
|
||||
|
||||
## 4. Credential and claim register
|
||||
|
||||
**This is the most important section in this file.** Pouya is a licensed legal
|
||||
professional. Every public claim on this site is subject to Law Society of
|
||||
Ontario marketing rules, and the previous version of the site carried fabricated
|
||||
credentials, invented matter values, and a fictitious testimonial. That must
|
||||
never recur.
|
||||
|
||||
### Governing rule
|
||||
|
||||
> **No claim reaches a public page unless it appears in the Verified column
|
||||
> below.** If a page needs a fact that is not here, stop and ask Pouya. Do not
|
||||
> infer it, do not soften it into something defensible, and do not carry it over
|
||||
> from the old site.
|
||||
|
||||
### Verified — may be published
|
||||
|
||||
Sourced from Pouya's own strategy brief of 2026-05-26. Self-reported by the
|
||||
subject, which makes them reliable as to substance, but **currency is not
|
||||
confirmed** — several are on a moving credentialing track and may have advanced
|
||||
since May.
|
||||
|
||||
| Claim | Status |
|
||||
|---|---|
|
||||
| Pouya Lajevardi, JD, Bond University | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| ~~Lawyer; Law Society of Ontario member~~ | **DO NOT PUBLISH.** Pouya directed on 2026-08-26 that licensure is left out of the site entirely; the JD is asserted, nothing further. See D13 and the Forbidden table below `[verified 2026-08-26]` |
|
||||
| Director of Firm Operations, Toronto litigation and ADR boutique | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Active litigation practice: personal injury, construction, regulatory (POA), insurance (SABS) | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Q.Med designation through ADRIC / ADRIO | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Has completed multiple sole mediations | `[verified 2026-08-25 — strategy brief §I]` — count deliberately not published, see below |
|
||||
| Q.Arb credentialing pathway — **commenced August 2026** | `[verified 2026-08-26 — Pouya]`. Describe as newly commenced, never as held or nearing completion |
|
||||
| C.Med-Arb stated as long-term designation goal | `[verified 2026-08-25 — strategy brief §I, §IV]` |
|
||||
| Kompass Arbitration Certificate Program — completed | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Stitt Feld Handy negotiation and ADR workshop sequence — completed | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Practising machine-learning and DevOps / infrastructure engineer | `[verified 2026-08-25 — strategy brief §I, §V]` |
|
||||
| Bilingual English and Farsi | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Iranian-Canadian; cross-cultural fluency with diaspora business communities | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Operator of SML Company Ltd. alongside the practice | `[verified 2026-08-25 — strategy brief §I]` |
|
||||
| Memberships: **ADRIC**, **ADRIO**, **OBA sections** | `[verified 2026-08-26 — Pouya]`. Which OBA sections is still `[assumed]` — the brief names Construction & Infrastructure, ADR, and Civil Litigation |
|
||||
| ~~OCNI~~ | **Not current. Do not publish** `[verified 2026-08-26 — Pouya]` |
|
||||
| ~~LSO~~ | **Do not publish.** Listing the Law Society among memberships implies licensure, which D13 bars. Excluded deliberately, not by oversight `[verified 2026-08-26]` |
|
||||
| Toronto, Ontario; by appointment | `[verified 2026-08-26]` |
|
||||
| Contact: `info@smlcompany.ca`; no public phone number; consultations by scheduled call | `[verified 2026-08-26 — Pouya]` |
|
||||
| LinkedIn: `https://www.linkedin.com/in/pouyalajevardi/` | `[verified 2026-08-26 — Pouya]` |
|
||||
| The Toronto litigation and ADR boutique **may be named on the site** | `[verified 2026-08-26 — Pouya]`; the name itself is pending, see Q7 |
|
||||
|
||||
### Forbidden — must not appear anywhere
|
||||
|
||||
| Never publish | Why |
|
||||
|---|---|
|
||||
| Any count of matters closed, hours mediated, or years in ADR practice | Practice is new. Small true numbers do not persuade a sophisticated GC and invite scrutiny. Save for one-to-one appointment proposals where context travels with the figure. `[verified 2026-08-25 — content brief, "Rule of thumb on numbers"]` |
|
||||
| Settlement rates, resolution percentages, median time to award | No underlying data exists |
|
||||
| Aggregate value resolved; any dollar figure attached to past matters | No underlying data exists |
|
||||
| Named or describable past matters | Confidentiality, and none are publishable |
|
||||
| Testimonials, endorsements, quotes from counterparties | None exist. The prior site's testimonial was fabricated |
|
||||
| "Since 2009", "sixteen years", London / New York offices, Co. № 07452218 | Artefacts of the placeholder template. All false |
|
||||
| The name "S. M. Lawrence" | Fictitious founder from the template |
|
||||
| Guarantees of outcome, or superlatives ("best", "leading", "top-rated") | LSO marketing rules |
|
||||
| The word **"lawyer"** used of Pouya; "called to the bar"; "licensed"; "my law practice"; "my litigation practice"; any post-nominal implying a licence | D13. The site asserts the JD and nothing further |
|
||||
| Any phrasing that *implies* entitlement to practise law without saying so — "acts for clients", "represents parties", "my clients", "legal advice" | Same rule. Implication is the risk, not just the word. Describe the role factually instead: *Director of Firm Operations at a Toronto litigation and ADR boutique*, and the matter types worked on |
|
||||
| Q.Arb described as held, imminent, or "nearly complete" | It commenced August 2026 |
|
||||
|
||||
### The substitution principle
|
||||
|
||||
Wherever the design wants a "how much / how many" statistic, substitute a
|
||||
**longer-arc credential** — something already substantial and true at launch that
|
||||
does not grow by closing files. The approved stat set is `Q.Med` /
|
||||
`JD + ML` / `EN · FA`, with `Q.Arb` as a fourth slot where one exists.
|
||||
`[verified 2026-08-25 — content brief]`
|
||||
|
||||
## 5. Audience model
|
||||
|
||||
All four tiers matter, but they are served by different surfaces rather than by
|
||||
diluting every page into a compromise. `[verified 2026-08-25 — decision D6]`
|
||||
|
||||
| Tier | Reads | Wants | Primary surface |
|
||||
|---|---|---|---|
|
||||
| In-house / general counsel | Home, practice pages | Credentials, subject-matter fluency, procedure, predictable cost | Home + `/practice/*` |
|
||||
| Referring lawyers and litigation boutiques | Practice pages, fees, process | Availability, rules familiarity, rate card, confidence you won't embarrass them | `/fees/`, `/process/`, `/mediation/` |
|
||||
| Appointing bodies and ADR institutions | About, credentials | A verifiable credential record and evidence of depth | `/about/` |
|
||||
| Self-represented parties and SMEs | Plain-language layer | What mediation actually is, what it costs, what happens | `/for-parties/` |
|
||||
|
||||
Realistically, **referring counsel are the largest source of early
|
||||
appointments**. Where two audiences conflict on a page, resolve toward counsel.
|
||||
`[assumed]`
|
||||
|
||||
## 6. Architecture
|
||||
|
||||
Full sitemap, URL map, and per-page content outline: **`docs/01-architecture.md`**.
|
||||
|
||||
Summary: ~20 static pages. Home; About; three process pages (Mediation,
|
||||
Arbitration, Med-Arb); six practice-area pages; Process; Fees; For Parties;
|
||||
Insights index and articles; Contact; Privacy; Terms.
|
||||
|
||||
**Deliberate omission:** there is no Indigenous engagement / IBA practice page at
|
||||
launch, though the strategy brief rates that niche as strategically the most
|
||||
valuable. Publishing a practice page for it before the multi-year relationship
|
||||
work described in brief §III.4 has been done would read as overreach to exactly
|
||||
the audience it targets. Revisit at month 12–18. `[verified 2026-08-25 — decision recorded here, not yet discussed with Pouya]`
|
||||
|
||||
## 7. Environment and stack
|
||||
|
||||
| Thing | Value |
|
||||
|---|---|
|
||||
| Framework | Astro, `output: 'static'` `[verified 2026-08-25 — D1]` |
|
||||
| Node | 22 LTS, pinned in `.nvmrc` `[assumed]` |
|
||||
| Styling | Plain CSS with custom properties. No Tailwind, no CSS-in-JS `[verified 2026-08-25]` |
|
||||
| Client JS | Astro islands only, where genuinely needed. Target: most pages ship zero JS `[verified 2026-08-25]` |
|
||||
| Content | Astro content collections, MDX for Insights `[verified 2026-08-25]` |
|
||||
| Fonts | Instrument Serif + Geist + Geist Mono, **self-hosted**, `font-display: swap` `[verified 2026-08-25]` |
|
||||
| AWS account | `327082975128` `[verified 2026-08-26 — inventory]` |
|
||||
| Region | **`ca-central-1`** throughout — hosting, Lambda, DynamoDB `[verified 2026-08-26]` |
|
||||
| S3 bucket | **`adr-smlcompany-site`** — versioning **Enabled**, so rollback works `[verified 2026-08-26]` |
|
||||
| CloudFront | **`E1OK7G98KNKUTA`**, alias `adr.smlcompany.ca`, origin `adr-smlcompany-site.s3.ca-central-1.amazonaws.com`, Deployed `[verified 2026-08-26]` |
|
||||
| ACM certificate | `arn:aws:acm:us-east-1:327082975128:certificate/2b6d5bdf-6790-430c-9b82-c00ab66e6d87` — ISSUED `[verified 2026-08-26]` |
|
||||
| Intake API | `adr-intake-api`, HTTP API `4tl0m5igkj`, endpoint `https://4tl0m5igkj.execute-api.ca-central-1.amazonaws.com` `[verified 2026-08-26]` |
|
||||
| Intake Lambda | `adr-intake-handler`, `nodejs24.x` `[verified 2026-08-26]` |
|
||||
| Intake table | `adr-intake-submissions` (DynamoDB, ca-central-1) `[verified 2026-08-26]` |
|
||||
| SES identities | Domain `smlcompany.ca`; addresses `info@`, `intake@`, `adr@`. **Sending status unconfirmed — Q18/Q19** `[verified 2026-08-26]` |
|
||||
| TLS | ACM certificate `[verified 2026-08-25 — AWS-Hosting-Guide.md]` |
|
||||
| DNS | **Namecheap**, not Route 53 `[verified 2026-08-25 — AWS-Hosting-Guide.md]` |
|
||||
| Intake backend | API Gateway (HTTP API) → Lambda → DynamoDB, notifications via SES `[verified 2026-08-25 — AWS-Hosting-Guide.md]` |
|
||||
| Repository | **`adr-sml`**, self-hosted **Gitea**. Local clone at `/Users/pouya/Dev/Websites/adr-sml` `[verified 2026-08-26]` |
|
||||
| CI/CD | **Gitea Actions**, `.gitea/workflows/deploy.yml`. `.github/workflows/deploy.yml` kept as the OIDC reference in case the repo ever moves. Credentials: scoped IAM user in Gitea secrets — **no OIDC available** `[verified 2026-08-26 — D3 as amended]` |
|
||||
| Analytics | **Plausible or Fathom** — cookieless, no personal data, no consent banner, EU-hosted `[verified 2026-08-26 — D15]` |
|
||||
|
||||
## 8. Design system
|
||||
|
||||
Full token set, type scale, motion rules, and contrast results:
|
||||
**`docs/02-design-system.md`**.
|
||||
|
||||
Palette and infinity mark carry over unchanged. Execution is modernized:
|
||||
fluid type scale, self-hosted fonts, an 8 px spacing scale, motion gated behind
|
||||
`prefers-reduced-motion`, and one hard accessibility constraint discovered by
|
||||
measurement:
|
||||
|
||||
> **Gold `#c9a876` on cream `#faf7f2` measures 2.10:1 contrast.** That fails WCAG
|
||||
> AA for body text (4.5:1) and for large text (3:1). Gold is a decorative and
|
||||
> on-dark colour only. On maroon it measures 5.84:1 and on ink 8.00:1, both of
|
||||
> which pass. `[verified 2026-08-25 — computed]`
|
||||
|
||||
## 9. Open questions — blocking
|
||||
|
||||
Nothing below can be invented. Each needs an answer from Pouya.
|
||||
|
||||
| # | Question | Blocks |
|
||||
|---|---|---|
|
||||
| ~~Q1~~ | **ANSWERED 2026-08-26.** Licensure is left out entirely; the site asserts the JD only. See D13 | — |
|
||||
| ~~Q2~~ | **ANSWERED 2026-08-26.** Q.Arb commenced August 2026 | — |
|
||||
| ~~Q3~~ | **ANSWERED 2026-08-26.** Email `info@smlcompany.ca`. No public phone — "By scheduled call". Location: Toronto · Ontario · By appointment | — |
|
||||
| ~~Q4 / Q14~~ | **ANSWERED 2026-08-26.** Rate card confirmed by Pouya — see D14 and `docs/07-fees.md` | — |
|
||||
| ~~Q13~~ | **ANSWERED 2026-08-26.** Self-hosted Gitea with Gitea Actions | — |
|
||||
| ~~Q15 / Q16 / Q17~~ | **ANSWERED 2026-08-26.** Non-mediation hourly $500. Prep bundled: 2 h in the half day, 3 h in the full day, **stated on the page**. Overtime $500/h | — |
|
||||
| Q5 | Booking tool — **parked 2026-08-26 at Pouya's request.** Build `/contact/` with the form only and a clean slot for the embed. Now tracked as standing reminder R6 | `/contact/` — non-blocking |
|
||||
| ~~Q6~~ | **ANSWERED 2026-08-26.** Supplied and committed: `src/assets/pouya-lajevardi.jpg` (1600×1600 master) and `src/assets/og-portrait.jpg` (1200×630 link-preview crop) | — |
|
||||
| ~~Q7~~ | **ANSWERED 2026-08-26.** Pouya reverted to generic. The boutique is **never named**; refer to it as *a Toronto litigation and ADR boutique* throughout | — |
|
||||
| ~~Q8~~ | **ANSWERED 2026-08-26.** ADRIC, ADRIO, OBA sections. Not OCNI. Not LSO (see §4) | — |
|
||||
| ~~Q9~~ | **ANSWERED 2026-08-26.** Gitea, repo `adr-sml`, clone at `/Users/pouya/Dev/Websites/adr-sml` | — |
|
||||
| ~~Q10~~ | **ANSWERED 2026-08-26.** Full inventory captured; values in §7 | — |
|
||||
| Q18 | **Are the SES identities actually verified for sending?** `list-email-identities` returned `VerifiedForSendingStatus: None` for all six. If they are unverified, no intake email sends | Intake confirmation and notification email |
|
||||
| Q19 | **Is the SES account still in the sandbox?** In sandbox, mail only reaches pre-verified addresses — the confirmation email to an inquirer would silently fail | `/contact/` going live |
|
||||
| ~~Q11~~ | **ANSWERED 2026-08-26.** Privacy-first, cookieless — Plausible or Fathom. No GA4, no consent banner | — |
|
||||
| ~~Q12~~ | **ANSWERED 2026-08-26.** `https://www.linkedin.com/in/pouyalajevardi/` | — |
|
||||
|
||||
## 10. Risks
|
||||
|
||||
| Risk | Severity | Mitigation |
|
||||
|---|---|---|
|
||||
| A fabricated or unverifiable claim reaches a public page | **High** — professional-conduct exposure for a licensed practitioner | §4 register; every claim traced to a source before it ships |
|
||||
| Copy silently carried over from the placeholder template | High | Nothing is ported verbatim. All copy written fresh against `docs/03-content-spec.md` |
|
||||
| Insights section launches and then goes stale | Medium | D9 commits to 3–5 pieces at launch and a monthly cadence. A dead blog is worse than no blog |
|
||||
| Personal data in the intake pipeline without a retention policy | Medium — PIPEDA | `docs/05-backend-spec.md` sets retention, and `/legal/privacy/` states it |
|
||||
| Cutover breaks the live site (D11 is a single-shot deploy) | Medium | Full pre-cutover checklist in `docs/06-deployment.md`; CloudFront can be rolled back to the prior origin path |
|
||||
| Twenty pages of thin copy rank worse than six good ones | Medium | Each page must justify itself with substantive content. Ship fewer pages rather than padded ones |
|
||||
| **Deploy-credential blast radius.** AWS account `327082975128` is not a single-project account. It also holds `meshkinilaw.ca` and its preview site, `demesne.media`, `orynenergy.ca`, `lajirugs.ca`, and **`mlp-clientdb-prod-backups`** — which by its name is a law firm's production client-database backups | **High** | A static deploy key for a personal website must never be able to reach a client database. The scoped IAM policy in `docs/06-deployment.md` grants four actions on one bucket and one distribution and nothing else — that narrowness is now load-bearing, not hygiene. Never widen it. Never reuse the `user/pouya` credentials in CI `[verified 2026-08-26 — inventory]` |
|
||||
| SES not verified or still sandboxed | Medium | Q18/Q19. A silently undelivered confirmation email looks to the inquirer like being ignored |
|
||||
|
||||
## 11. Glossary
|
||||
|
||||
| Term | Meaning |
|
||||
|---|---|
|
||||
| ADR | Alternative dispute resolution |
|
||||
| ADRIC | ADR Institute of Canada — national credentialing body |
|
||||
| ADRIO | ADR Institute of Ontario — provincial affiliate |
|
||||
| Q.Med | Qualified Mediator — ADRIC/ADRIO designation |
|
||||
| Q.Arb | Qualified Arbitrator — ADRIC/ADRIO designation |
|
||||
| C.Med-Arb | Chartered Mediator-Arbitrator — senior hybrid designation; the long-term goal |
|
||||
| Med-Arb | Hybrid process: mediation that converts to binding arbitration if unresolved |
|
||||
| SABS | Statutory Accident Benefits Schedule — Ontario auto insurance benefits |
|
||||
| LAT | Licence Appeal Tribunal — hears Ontario SABS disputes |
|
||||
| POA | Provincial Offences Act |
|
||||
| ENE | Early neutral evaluation |
|
||||
| LSO | Law Society of Ontario |
|
||||
| OBA | Ontario Bar Association |
|
||||
| IESO | Independent Electricity System Operator |
|
||||
| OEB | Ontario Energy Board |
|
||||
| SMR | Small modular reactor |
|
||||
| PIPEDA | Personal Information Protection and Electronic Documents Act |
|
||||
|
||||
## 12. Standing reminders
|
||||
|
||||
**Surface these to Pouya at the start of any substantial session.** They are
|
||||
open questions he has deliberately parked, not settled matters. The point of
|
||||
this section is that a parked decision does not quietly become permanent by
|
||||
never being raised again.
|
||||
|
||||
| # | Reminder | Raised | Why it must keep coming back |
|
||||
|---|---|---|---|
|
||||
| R1 | **Licensure.** The site currently asserts the JD only and describes the boutique role as *active litigation exposure*, never *practice*. Pouya flagged this as an interim position and asked to be reminded to change it | 2026-08-26 | If he is licensed and in good standing, it is the first credential appointing bodies and opposing counsel look for, and its absence from a detailed credentials page is conspicuous. If licensure is in progress, the copy should be rewritten the moment it completes. Either way this is a **temporary** framing that will otherwise ossify |
|
||||
| R2 | **Matter counts stay off the site until they are independently credible.** Revisit once there is a number a sophisticated GC would find persuasive on its own | 2026-08-26 | §4 forbids them now. That rule has an expiry date nobody has set |
|
||||
| R3 | **Indigenous engagement practice page.** Deliberately omitted at launch (§6). Revisit at month 12–18 | 2026-08-26 | The strategy brief rates it the most valuable single niche. Omission is a timing call, not a permanent one |
|
||||
| R4 | **Insights cadence.** D9 commits to monthly. A blog that stops is worse than one that never started | 2026-08-26 | The section's whole value is compounding |
|
||||
| R5 | **Fee review at 12 months.** Published rates are sticky; the right moment to move them is deliberate, not reactive | 2026-08-26 | D14 is priced for where the practice is going, not where it is |
|
||||
| R6 | **Booking tool.** Parked by Pouya on 2026-08-26; `/contact/` ships with the intake form and a reserved slot for an embed | 2026-08-26 | He asked to be reminded. D10 committed to booking because it removes the back-and-forth that loses appointments — the form alone is a partial answer |
|
||||
|
||||
---
|
||||
|
||||
# Change Log
|
||||
|
||||
## 2026-08-26 (e) — AWS inventory captured; Q10 closed; blast-radius risk logged
|
||||
|
||||
**Who:** Pouya ran `scripts/aws-discover.sh`. Claude recording.
|
||||
|
||||
**Q10 closed.** All identifiers in §7. Bucket `adr-smlcompany-site`,
|
||||
distribution `E1OK7G98KNKUTA`, region `ca-central-1`, intake API
|
||||
`4tl0m5igkj`. Certificate ISSUED. **S3 versioning is already Enabled**, so the
|
||||
rollback path in `docs/06-deployment.md` works as written — no change needed.
|
||||
|
||||
**Data residency confirmed.** Hosting, Lambda, and DynamoDB are all in
|
||||
`ca-central-1`. `docs/05-backend-spec.md` treated Canadian residency as a
|
||||
selling point conditional on the table's region; it is now a verified fact and
|
||||
`/legal/privacy/` can state it plainly.
|
||||
|
||||
**New risk logged — deploy-credential blast radius.** The inventory shows this is
|
||||
a shared account across at least five unrelated properties, including
|
||||
`mlp-clientdb-prod-backups-327082975128`. A Gitea runner holding a static AWS key
|
||||
for this site sits in the same account as a law firm's client-database backups.
|
||||
Nothing about the plan changes — the scoped IAM policy was already correct — but
|
||||
its narrowness is now load-bearing rather than good practice, and that is
|
||||
recorded so nobody widens it later for convenience.
|
||||
|
||||
**Q18 and Q19 opened — SES.** `list-email-identities` returned
|
||||
`VerifiedForSendingStatus: None` for all six identities, and sandbox status was
|
||||
not checked. Either condition means the intake confirmation email silently fails.
|
||||
This is the failure mode where the site appears to work and inquirers think they
|
||||
have been ignored, so it is on the cutover checklist, not the nice-to-have list.
|
||||
|
||||
**Closed:** Q10. **Opened:** Q18, Q19.
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-26 (d) — Memberships, analytics, prep time, firm naming; one blocker left
|
||||
|
||||
**Who:** Pouya. Claude recording.
|
||||
|
||||
**Q16 closed — preparation time is bundled and stated.** 2 h in the half day,
|
||||
3 h in the full day, printed on `/fees/`. The carried-forward assumption is now a
|
||||
decision. At $4,000 a day counsel will assume preparation happened; saying so
|
||||
converts the assumption into a selling point and forecloses an argument about
|
||||
what the fee covered.
|
||||
|
||||
**Q15 and Q17 closed.** Non-mediation hourly (ENE, settlement counsel,
|
||||
dispute-system design, technical advisory) and mediation overtime both **$500/h**,
|
||||
matching the arbitration rate.
|
||||
|
||||
**Q8 closed — memberships.** Old → new: five `[assumed]` bodies from the strategy
|
||||
brief → **ADRIC, ADRIO, and OBA sections, verified.** OCNI is **not current** and
|
||||
must not be published; the brief listed it as aspirational positioning for the
|
||||
nuclear niche, which is a different thing from a membership.
|
||||
|
||||
- **LSO was deliberately not offered as an option and is not published.** Listing
|
||||
the Law Society in a credentials block implies licensure, which D13 bars. Worth
|
||||
recording explicitly so a later reader does not "helpfully" add it back.
|
||||
- Which OBA sections remains `[assumed]` — the brief names Construction &
|
||||
Infrastructure, ADR, and Civil Litigation. Low stakes; confirm in passing.
|
||||
|
||||
**D15 — analytics (new decision).** Old → new: unchosen → **privacy-first and
|
||||
cookieless**, Plausible or Fathom. No GA4, no consent banner, no personal data
|
||||
leaving the site, one honest line in the privacy policy. Consistent with a
|
||||
practice whose privacy posture is part of its offer, on a site where visitors are
|
||||
often describing live disputes.
|
||||
|
||||
**D16 — the boutique is never named (new decision).** Old → new: "may be named,
|
||||
name pending" → **generic throughout**: *a Toronto litigation and ADR boutique*.
|
||||
Pouya reversed his earlier answer. Trade-off, recorded for the record: naming a
|
||||
recognisable firm is a meaningful credibility signal to appointing bodies, and
|
||||
the generic phrasing gives that up in exchange for zero coordination cost and no
|
||||
dependency on anyone else's sign-off. Do not infer the name from his email domain
|
||||
or from anything else.
|
||||
|
||||
**Closed:** Q7, Q8, Q11, Q15, Q16, Q17. **Opened:** none.
|
||||
|
||||
**Q10 is now the only blocker.** Everything else needed to build is answered.
|
||||
R6 (booking) stays parked by choice and does not block `/contact/`.
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-26 (c) — Contact, headshot, LinkedIn; booking parked
|
||||
|
||||
**Who:** Pouya. Claude recording.
|
||||
|
||||
**Closed.** Q3 — contact is `info@smlcompany.ca`, no public phone, consultations
|
||||
by scheduled call. Q6 — headshot supplied; committed as
|
||||
`src/assets/pouya-lajevardi.jpg` (1600×1600 master, for Astro to derive AVIF and
|
||||
WebP from at build) and `src/assets/og-portrait.jpg` (1200×630, cropped high so
|
||||
the face is not centred under the fold of a link preview). Q12 — LinkedIn URL,
|
||||
which now feeds `sameAs` in the `Person` JSON-LD.
|
||||
|
||||
**Q5 parked, not closed.** Old → new: "choose a booking tool" → **deferred at
|
||||
Pouya's request**; `/contact/` ships with the intake form and a reserved slot for
|
||||
an embed, so adding one later is a drop-in rather than a rebuild. He asked to be
|
||||
reminded, so it is now **R6** in §12 rather than a question that quietly expires.
|
||||
Worth restating when it comes back up: D10 chose booking because it removes the
|
||||
scheduling back-and-forth that loses appointments, and the form alone only
|
||||
half-solves that.
|
||||
|
||||
**Q7 partially answered.** The boutique may be named. The name itself was not
|
||||
given. His email domain (`meshkinilaw.ca`) points to **Meshkini Law**, but an
|
||||
inferred firm name is exactly the kind of thing §4 exists to stop — asked for
|
||||
confirmation rather than published.
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-26 (b) — Fees confirmed; Gitea; licensure wording; standing reminders
|
||||
|
||||
**Who:** Pouya, answering the second round. Claude recording.
|
||||
|
||||
**D14 closed — rate card confirmed, and it is not what was recommended.**
|
||||
- Old → new: two-tier card (Tier A insurance/SABS at $1,800/day, Tier B
|
||||
commercial at $3,200/day) → **one rate for all mediation matters: $2,000 half
|
||||
day, $4,000 full day, $500 per party beyond two.** Arbitration $500/h, hearing
|
||||
day $4,000, documents-only flat $6,500 simple / $9,500 complex. Tribunal-
|
||||
secretary line removed. Cancellation terms adopted as recommended.
|
||||
- Why: Pouya's decision.
|
||||
- **Recorded dissent, for the 12-month review (R5).** A single premium rate puts
|
||||
the insurance / SABS / LAT segment out of reach — the published market there
|
||||
runs roughly $800–$1,200 a day, and $4,000 is three to five times it. That is
|
||||
the segment the strategy brief (§IV.7) identifies as the highest realistic
|
||||
near-term volume, flowing directly from the firm's existing accident-benefits
|
||||
work. The trade is deliberate if it is deliberate: a premium specialist
|
||||
position that forgoes volume. It is a mistake if the volume was being counted
|
||||
on. Flagged once, implemented as directed.
|
||||
- Three parameters were not specified and are carried forward as assumptions,
|
||||
logged as Q15–Q17: non-mediation hourly ($500), bundled prep hours (2 h half
|
||||
day / 3 h full day), mediation overtime ($500/h).
|
||||
|
||||
**D13 refined — approved wording for the boutique role.**
|
||||
- Old → new: "describe the role factually" → the specific approved phrases are
|
||||
**"active litigation exposure"** and **"involvement in litigation and ADR
|
||||
matters"**. The word **"practice"** is barred in that context.
|
||||
- Pouya asked to be **continuously reminded** that this is interim. That request
|
||||
is now structural rather than a note — see the new §12.
|
||||
|
||||
**New §12, Standing Reminders.** Five items (R1–R5) that any agent must surface
|
||||
at the start of a substantial session. Added because a parked decision otherwise
|
||||
becomes permanent by never being raised again — and R1 is Pouya's explicit
|
||||
instruction to keep raising it.
|
||||
|
||||
**D3 amended again — Gitea.**
|
||||
- Old → new: "private git server, software unknown" → **self-hosted Gitea with
|
||||
Gitea Actions**, clone at `/Users/pouya/Dev/Websites/adr-sml`.
|
||||
- Consequence: Gitea Actions uses GitHub Actions syntax, so the workflow ports
|
||||
almost unchanged into `.gitea/workflows/deploy.yml`. But **Gitea is not an AWS
|
||||
OIDC provider**, so the OIDC role assumption is replaced by a scoped IAM user
|
||||
whose key lives only in Gitea's secret store. The IAM policy stays exactly as
|
||||
narrow. Quarterly rotation is now an operational obligation that OIDC would
|
||||
have made unnecessary — noted in `docs/06-deployment.md`.
|
||||
|
||||
**Closed:** Q4, Q9, Q13, Q14. **Opened:** Q15, Q16, Q17.
|
||||
**Still open:** Q3, Q5, Q6, Q7, Q8, Q10, Q11, Q12, Q15, Q16, Q17.
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-26 (a) — Licensure decision; Q.Arb dated; git host changed; fees researched
|
||||
|
||||
**Who:** Pouya, answering the blocking questions from §9. Claude recording.
|
||||
|
||||
**Date correction.** The entry below is stamped 2026-08-25. The correct date of
|
||||
that work was **2026-08-26** — the session clock was a day behind. Per rule 3 the
|
||||
entry is left as written rather than edited; this note is the correction. Facts
|
||||
touched today are re-stamped `[verified 2026-08-26]`.
|
||||
|
||||
**D13 — licensure left out of the site (new decision).**
|
||||
- Old → new: "confirm LSO licence status before launch" → **the site asserts the
|
||||
JD and makes no licensure claim at all.**
|
||||
- Why: Pouya's direction.
|
||||
- **Consequence, and it is not small.** The strategy brief describes an *"active
|
||||
litigation practice in personal injury, construction, regulatory (POA), and
|
||||
insurance (SABS) matters."* Copy written that way would imply entitlement to
|
||||
practise law without stating it — which is the risk the decision is meant to
|
||||
avoid, restated in different words. So the Forbidden table now bars implication
|
||||
as well as assertion, and the About page describes the role factually:
|
||||
*Director of Firm Operations at a Toronto litigation and ADR boutique*, plus
|
||||
the matter types worked on. **Flagged back to Pouya**: if he is in fact
|
||||
licensed and in good standing, that is a material credential for exactly the
|
||||
audience this site targets, and omitting it costs more than it protects.
|
||||
|
||||
**Q.Arb dated.** Old → new: `[assumed]`, stage unknown → **commenced August
|
||||
2026** `[verified 2026-08-26]`. Describe as newly commenced. Not as held, not as
|
||||
nearing completion.
|
||||
|
||||
**D3 amended — the repository is not on GitHub.**
|
||||
- Old → new: "git repo + GitHub Actions" → **repo `adr-sml` on a private git
|
||||
server**; the GitHub Actions workflow in `.github/workflows/` is retained as a
|
||||
working reference implementation, to be translated once the server software is
|
||||
known (**Q13**).
|
||||
- Why: Pouya is running his own git server.
|
||||
- Knock-on: GitHub's OIDC provider is unavailable. GitLab CE can federate to AWS
|
||||
by OIDC; Gitea/Forgejo and bare git cannot, so those need a scoped IAM user
|
||||
with rotated keys, or deploys run from Pouya's machine. The choice is real and
|
||||
waits on Q13.
|
||||
|
||||
**D14 — fee structure recommended (new decision, pending sign-off).** Market
|
||||
research completed against the Ontario mandatory-mediation tariff, ADR Chambers
|
||||
published ranges, and four published Ontario practitioner rate cards. A two-tier
|
||||
structure is recommended so the price-sensitive SABS/LAT volume work does not
|
||||
anchor the commercial rate. Figures are in the response to Pouya and are **not
|
||||
written into any page until he signs off (Q14).**
|
||||
|
||||
**Still open:** Q3, Q5, Q6, Q7, Q8, Q10, Q11, Q12, Q13, Q14.
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-25 — Project initiated; architecture decided; repo bundle authored
|
||||
|
||||
**Who:** Pouya Lajevardi with Claude (Cowork session), acting as architects. Claude Code to implement.
|
||||
|
||||
**What was discussed.** Pouya asked for a modernization of `adr.smlcompany.ca`
|
||||
going beyond appearance — content and codebase included — with Claude Code doing
|
||||
the implementation and deploying to AWS.
|
||||
|
||||
**What was found.** An audit of the live site and the local sources established
|
||||
the facts in Current Truth §2. The headline finding: the site is a browser-
|
||||
compiled single-file React bundle that serves crawlers three words of content.
|
||||
For a personal-brand site whose function is discoverability, this is the
|
||||
dominant problem, ahead of any question of looks or copy.
|
||||
|
||||
**What was decided.** Twelve decisions, D1–D12, recorded in §3. In summary: an
|
||||
Astro static rebuild, full content re-architecture, ~20 pages, English only,
|
||||
git + GitHub Actions onto the existing S3/CloudFront, palette and infinity mark
|
||||
retained with a modernized execution, a published rate card, an Insights section
|
||||
launching with drafted content, a rebuilt intake form plus booking, and a single
|
||||
clean cutover.
|
||||
|
||||
- Old → new (framework): browser-compiled React single file → Astro static site
|
||||
- Old → new (publishing): manual `rebuild-standalone.py` + console upload → git + GitHub Actions with OIDC
|
||||
- Old → new (structure): one scrolling page → ~20 pre-rendered pages
|
||||
- Old → new (content): partially-corrected placeholder template → written fresh against a claim register
|
||||
- Old → new (record-keeping): none → this file, under the AGENTS constitution
|
||||
|
||||
**Why.** Discoverability is the practice's growth constraint and the current
|
||||
architecture forecloses it. Every other decision follows from fixing that, with
|
||||
the content decisions following from the strategy brief of 2026-05-26.
|
||||
|
||||
**Also decided, not yet discussed with Pouya:** no Indigenous engagement practice
|
||||
page at launch (§6), on the reasoning recorded there. Flag this to him.
|
||||
|
||||
**Planned, not yet done.** Astro implementation; all page copy; 3–5 Insights
|
||||
drafts; intake backend rework; CI/CD wiring; pre-cutover audit. Twelve blocking
|
||||
questions are open in §9 — several pages cannot be written until they are
|
||||
answered.
|
||||
@@ -0,0 +1,122 @@
|
||||
# CLAUDE.md — operating instructions for Claude Code
|
||||
|
||||
## Read this first
|
||||
|
||||
1. **`AGENTS.md` is the source of truth for this project.** Read it in full
|
||||
before your first edit in any session. It carries the locked decisions, the
|
||||
credential register, the open questions, and the full history.
|
||||
2. **You are required to maintain `AGENTS.md`** under the constitution written at
|
||||
the top of it. Update *Current Truth* in place; append to the *Change Log*,
|
||||
newest first; never edit a past entry; never delete history. Record decisions
|
||||
and plans, not only executed work. Stamp facts `[verified YYYY-MM-DD]` or
|
||||
`[assumed]`.
|
||||
3. Update it **at the end of every working session**, not only when something
|
||||
ships. A session that produced a decision and no code still produces a Change
|
||||
Log entry.
|
||||
4. **Read `AGENTS.md` §12 Standing Reminders at the start of every substantial
|
||||
session and surface anything live to Pouya.** These are decisions he parked
|
||||
deliberately, not settled matters — R1 in particular is his explicit
|
||||
instruction to keep raising the licensure wording. A parked decision that
|
||||
stops being raised has quietly become permanent, which is the failure mode
|
||||
§12 exists to prevent.
|
||||
|
||||
## The one rule that matters more than the code
|
||||
|
||||
Pouya is a licensed legal professional. **No factual claim about him, his
|
||||
credentials, his experience, or his practice may appear on a public page unless
|
||||
it is in the Verified table in `AGENTS.md` §4.**
|
||||
|
||||
If a page needs a fact you do not have:
|
||||
|
||||
- Do not infer it from context.
|
||||
- Do not soften it into something defensible ("extensive experience", "years of").
|
||||
- Do not carry it over from the old site — the old site contained a fictitious
|
||||
founder, invented matter values, and a fabricated testimonial.
|
||||
- **Leave `TODO(pouya): <the exact question>` in the source, and add the question
|
||||
to `AGENTS.md` §9.** A build that fails on an unanswered question is a correct
|
||||
build.
|
||||
|
||||
Read the Forbidden table in §4 before writing any statistic, number, or
|
||||
superlative.
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
npm install
|
||||
npm run dev # local dev server
|
||||
npm run build # static build to ./dist
|
||||
npm run preview # serve ./dist locally
|
||||
npm run check # astro check — type and template errors
|
||||
npm run lint # eslint + prettier check
|
||||
```
|
||||
|
||||
## Where things live
|
||||
|
||||
```
|
||||
AGENTS.md living project record — read first, maintain always
|
||||
docs/ the specs you build from
|
||||
01-architecture.md sitemap, URL map, per-page content outline
|
||||
02-design-system.md tokens, type scale, motion, contrast constraints
|
||||
03-content-spec.md voice, copy rules, per-page copy deck
|
||||
04-seo-spec.md metadata, structured data, sitemap, crawlability
|
||||
05-backend-spec.md intake form, Lambda/DynamoDB/SES, booking, PIPEDA
|
||||
06-deployment.md S3/CloudFront, GitHub Actions OIDC, cutover checklist
|
||||
src/
|
||||
styles/tokens.css design tokens — the single source of colour and scale
|
||||
styles/global.css reset, base type, utilities
|
||||
layouts/ page shells
|
||||
components/ UI components
|
||||
pages/ routes (file-based)
|
||||
content/ content collections; Insights MDX lives here
|
||||
data/site.ts site-wide constants, nav, contact details
|
||||
public/ static assets served as-is
|
||||
```
|
||||
|
||||
## Conventions
|
||||
|
||||
**Framework.** Astro, `output: 'static'`. Never introduce a server runtime
|
||||
without a Change Log entry recording why.
|
||||
|
||||
**JavaScript.** Default to zero. Reach for an Astro island only when a feature
|
||||
genuinely cannot be CSS or progressive HTML. If you add a `client:*` directive,
|
||||
say why in the Change Log. A `<details>` element beats a JS accordion.
|
||||
|
||||
**Styling.** Plain CSS with custom properties. No Tailwind, no CSS-in-JS, no
|
||||
utility framework. Every colour, space, and font size comes from a token in
|
||||
`tokens.css` — no raw hex values and no magic numbers in component styles.
|
||||
|
||||
**Accessibility is a build requirement, not a polish pass.** Semantic landmarks,
|
||||
one `<h1>` per page, heading levels never skipped, visible focus states, all
|
||||
interactive elements reachable by keyboard, `prefers-reduced-motion` honoured on
|
||||
every animation. Gold `#c9a876` never sits on cream — it fails contrast at
|
||||
2.10:1. See `docs/02-design-system.md`.
|
||||
|
||||
**Images.** Astro `<Image>` with explicit width and height. AVIF/WebP with
|
||||
fallback. Never base64-inline an image into HTML — the old site did this with
|
||||
~1 MB of logo PNGs.
|
||||
|
||||
**Fonts.** Self-hosted, subset, `font-display: swap`, preloaded. No Google Fonts
|
||||
request at runtime — it costs a round trip and adds a third-party call to a
|
||||
page that collects legal inquiries.
|
||||
|
||||
**Every page ships with:** a unique `<title>` and meta description, a canonical
|
||||
URL, Open Graph and Twitter card tags, and appropriate JSON-LD. See
|
||||
`docs/04-seo-spec.md`. A page without these is not finished.
|
||||
|
||||
**Commits.** Conventional Commits (`feat:`, `fix:`, `docs:`, `chore:`, `refactor:`).
|
||||
One logical change per commit. Never commit secrets, `.env` files, or AWS
|
||||
credentials — deploys use OIDC role assumption.
|
||||
|
||||
**Performance budget.** Lighthouse ≥ 95 on all four categories, on mobile, for
|
||||
every page. Under 100 KB of JS on any route. LCP under 2.0 s on a simulated
|
||||
Slow 4G connection. Treat a budget breach as a failing build.
|
||||
|
||||
## What "done" means for a page
|
||||
|
||||
- [ ] Copy written from `docs/03-content-spec.md`, every claim traceable to `AGENTS.md` §4
|
||||
- [ ] No `TODO(pouya)` left unlogged in §9
|
||||
- [ ] Unique title, meta description, canonical, OG/Twitter tags, JSON-LD
|
||||
- [ ] Semantic HTML; keyboard navigable; reduced-motion honoured
|
||||
- [ ] Lighthouse ≥ 95 mobile, all four categories
|
||||
- [ ] Renders correctly with JavaScript disabled
|
||||
- [ ] `AGENTS.md` Change Log entry appended
|
||||
@@ -0,0 +1,41 @@
|
||||
# adr.smlcompany.ca
|
||||
|
||||
The dispute resolution practice of Pouya Lajevardi — Toronto.
|
||||
|
||||
A static site built with [Astro](https://astro.build), deployed to Amazon S3
|
||||
behind CloudFront by GitHub Actions.
|
||||
|
||||
## Quick start
|
||||
|
||||
```bash
|
||||
nvm use # Node 22
|
||||
npm install
|
||||
npm run dev # http://localhost:4321
|
||||
```
|
||||
|
||||
## Scripts
|
||||
|
||||
| Command | Does |
|
||||
|---|---|
|
||||
| `npm run dev` | Development server with hot reload |
|
||||
| `npm run build` | Static build to `./dist` |
|
||||
| `npm run preview` | Serve the built site locally |
|
||||
| `npm run check` | `astro check` — type and template errors |
|
||||
| `npm run lint` | ESLint + Prettier |
|
||||
|
||||
## Before you contribute
|
||||
|
||||
Read **`AGENTS.md`** first, and maintain it as you work — it is the living
|
||||
record of what this project is, what was decided, and why. Then read
|
||||
**`CLAUDE.md`** for the working rules, and the specs in `docs/`.
|
||||
|
||||
The single hardest rule: **no factual claim about the practice ships unless it
|
||||
appears in the verified register in `AGENTS.md` §4.** This is a licensed
|
||||
professional's public marketing surface, and the site this replaces contained
|
||||
fabricated credentials.
|
||||
|
||||
## Deployment
|
||||
|
||||
Pushes to `main` build and deploy automatically via
|
||||
`.github/workflows/deploy.yml`, using OIDC role assumption — there are no
|
||||
long-lived AWS credentials in this repository. See `docs/06-deployment.md`.
|
||||
@@ -0,0 +1,35 @@
|
||||
import { defineConfig } from 'astro/config';
|
||||
import mdx from '@astrojs/mdx';
|
||||
import sitemap from '@astrojs/sitemap';
|
||||
|
||||
// Canonical origin. Drives canonical URLs, OG tags, and the sitemap.
|
||||
const SITE = process.env.PUBLIC_SITE_URL ?? 'https://adr.smlcompany.ca';
|
||||
|
||||
export default defineConfig({
|
||||
site: SITE,
|
||||
|
||||
// Static output is the point of this rebuild — see docs/04-seo-spec.md.
|
||||
// Do not switch to a server adapter without an AGENTS.md Change Log entry.
|
||||
output: 'static',
|
||||
|
||||
// Directory-style URLs with a trailing slash, matched by the CloudFront
|
||||
// trailing-slash function. See docs/06-deployment.md.
|
||||
trailingSlash: 'always',
|
||||
build: { format: 'directory', inlineStylesheets: 'auto' },
|
||||
|
||||
integrations: [
|
||||
mdx(),
|
||||
sitemap({
|
||||
filter: (page) => !page.includes('/legal/'),
|
||||
changefreq: 'monthly',
|
||||
lastmod: new Date(),
|
||||
}),
|
||||
],
|
||||
|
||||
image: {
|
||||
// Explicit dimensions everywhere; never base64-inline an image.
|
||||
service: { entrypoint: 'astro/assets/services/sharp' },
|
||||
},
|
||||
|
||||
prefetch: { prefetchAll: true, defaultStrategy: 'viewport' },
|
||||
});
|
||||
@@ -0,0 +1,344 @@
|
||||
# 01 — Information architecture
|
||||
|
||||
Authority: `AGENTS.md` §3 D5 (full multi-page), §6, §5 (audience model).
|
||||
Every claim in the copy outlines below must clear `AGENTS.md` §4.
|
||||
|
||||
---
|
||||
|
||||
## Why multi-page at all
|
||||
|
||||
The site being replaced is one scrolling page. One page can hold one title, one
|
||||
meta description, one canonical URL, and one primary topic. It therefore gets
|
||||
one shot at a search result.
|
||||
|
||||
The practice's target searches are not "Toronto mediator" — that term is owned by
|
||||
retired judges with twenty years of name recognition, and the strategy brief is
|
||||
explicit that competing there is the wrong game (§II). The winnable searches are
|
||||
specific: *construction lien mediation Ontario*, *SaaS contract arbitration
|
||||
Canada*, *SABS mediation Toronto*, *technology dispute neutral*, *Farsi-speaking
|
||||
mediator*. Each of those wants its own page, its own title, its own copy, and its
|
||||
own structured data.
|
||||
|
||||
That is the entire argument for the structure below. It is a discoverability
|
||||
decision, not an aesthetic one.
|
||||
|
||||
---
|
||||
|
||||
## Sitemap
|
||||
|
||||
```
|
||||
/ Home
|
||||
/about/ Biography, credentials, the professional record
|
||||
/mediation/ Mediation — the process, formats, rules
|
||||
/arbitration/ Arbitration — the process, tracks, rules
|
||||
/med-arb/ Med-Arb and hybrid processes
|
||||
/practice/ Practice areas index
|
||||
/practice/construction/ Construction and infrastructure disputes
|
||||
/practice/technology/ Technology, AI, and data disputes
|
||||
/practice/energy/ Energy, grid, and regulatory disputes
|
||||
/practice/insurance/ Insurance, SABS, and accident benefits
|
||||
/practice/shareholder/ Shareholder, partnership, and family business
|
||||
/practice/cross-cultural/ Cross-border and diaspora disputes
|
||||
/process/ What an engagement looks like, step by step
|
||||
/fees/ Fee schedule and engagement terms
|
||||
/for-parties/ Plain language: what mediation actually is
|
||||
/insights/ Article index
|
||||
/insights/[slug]/ Individual articles
|
||||
/contact/ Intake form and booking
|
||||
/legal/privacy/ Privacy policy — PIPEDA
|
||||
/legal/terms/ Terms of use
|
||||
```
|
||||
|
||||
Nineteen fixed URLs plus one per article.
|
||||
|
||||
### URL rules
|
||||
|
||||
- Lowercase, hyphenated, trailing slash, no file extensions.
|
||||
- `/practice/<area>/` is a stable namespace — new practice areas slot in without
|
||||
touching anything else.
|
||||
- `/insights/<slug>/` — no dates in the path. A dated URL makes a piece look
|
||||
stale at 18 months, and this content is mostly evergreen.
|
||||
- Never change a published URL. If one must move, ship a CloudFront Function
|
||||
301 and record it in the Change Log.
|
||||
|
||||
### Navigation
|
||||
|
||||
**Primary (header).** About · Mediation · Arbitration · Practice · Fees ·
|
||||
Insights · Contact
|
||||
|
||||
"Practice" is a dropdown to the six areas, with `/practice/` itself reachable.
|
||||
Build it as a `<details>` element or a CSS-only disclosure — no JavaScript.
|
||||
|
||||
**Footer.** Full sitemap in three columns, plus contact block, professional
|
||||
designations, LinkedIn, privacy, terms, and the SML Company Ltd. entity line.
|
||||
|
||||
**Deliberately not in primary nav:** `/process/`, `/for-parties/`, `/med-arb/`.
|
||||
These are linked contextually from the pages that lead to them. Seven items is
|
||||
the ceiling before a nav stops being scannable.
|
||||
|
||||
---
|
||||
|
||||
## Deliberate omission: Indigenous engagement
|
||||
|
||||
The strategy brief (§III.4) rates Indigenous engagement, IBA, and consultation-
|
||||
breakdown mediation as *"strategically the most valuable single niche"* for a
|
||||
Q.Med on the C.Med-Arb pathway.
|
||||
|
||||
There is no page for it at launch, on the following reasoning:
|
||||
|
||||
The brief itself says the niche *"requires deliberate relationship work with
|
||||
First Nations advisors, federal and provincial engagement staff, and corporate
|
||||
proponents over a multi-year horizon."* A practice page is a claim of present
|
||||
capability. Publishing one before that relationship work exists would be read as
|
||||
exactly what it is by the audience best positioned to notice — and that audience
|
||||
is small, well-connected, and unforgiving of practitioners who arrive claiming a
|
||||
seat. The cost of getting this wrong is much higher than the cost of waiting.
|
||||
|
||||
Revisit at month 12–18, once there is relationship history to point to.
|
||||
**This reasoning is Claude's, recorded for Pouya's decision — not yet his call.**
|
||||
|
||||
---
|
||||
|
||||
## Page specifications
|
||||
|
||||
Each page below gives its job, its primary audience, its target search intent,
|
||||
and its section outline. Copy itself is in `03-content-spec.md`.
|
||||
|
||||
### `/` — Home
|
||||
|
||||
**Job:** establish the unusual stack in under ten seconds, and route each of the
|
||||
four audiences to its surface.
|
||||
**Audience:** all four; leans in-house counsel.
|
||||
**Search intent:** brand and name searches; "Toronto ADR practice".
|
||||
|
||||
1. **Hero.** Eyebrow (`Mediation · Arbitration · Toronto`), display headline,
|
||||
two-sentence positioning paragraph, two CTAs (*Request a consultation* /
|
||||
*How I work*), portrait.
|
||||
2. **Credential row.** Three slots: `Q.Med` · `JD + ML` · `EN · FA`. Never
|
||||
matter counts — `AGENTS.md` §4.
|
||||
3. **The approach.** The "two directions at once" argument — law and engineering
|
||||
converging on the same dispute. Infinity mark as the visual anchor.
|
||||
4. **Two practices.** Mediation and Arbitration cards → `/mediation/`, `/arbitration/`.
|
||||
Med-Arb named here as the long-term arc, linking to `/med-arb/`.
|
||||
5. **Practice areas.** Six-card grid → `/practice/*`. This is the most important
|
||||
block on the page for search, because it distributes authority to the pages
|
||||
that can actually rank.
|
||||
6. **Process preview.** Compressed five-step strip → `/process/`.
|
||||
7. **Latest insights.** Three most recent → `/insights/`.
|
||||
8. **Contact band.** Intake CTA and booking link.
|
||||
|
||||
### `/about/` — Biography and credentials
|
||||
|
||||
**Job:** be the page an appointing body or opposing counsel reads before agreeing
|
||||
to an appointment. This page carries the verifiable record.
|
||||
**Audience:** appointing bodies, ADR institutions, opposing counsel.
|
||||
**Search intent:** `"Pouya Lajevardi"`, `Pouya Lajevardi mediator`.
|
||||
|
||||
1. Portrait, name, designation line.
|
||||
2. **Narrative biography**, 400–600 words. The three-track story — law,
|
||||
engineering, operating a company — told as one arc rather than three lists.
|
||||
3. **Credentials**, structured and scannable: designations, education,
|
||||
certifications, memberships. Every line from `AGENTS.md` §4 Verified.
|
||||
4. **The credentialing arc.** Q.Med held → Q.Arb in progress → C.Med-Arb as the
|
||||
endpoint. The brief (§V) treats the arc itself as part of the story; say so
|
||||
openly rather than implying a finished state.
|
||||
5. **Languages and cross-cultural practice.**
|
||||
6. **Speaking and publications.** Omit the section entirely until there is
|
||||
something in it. An empty "Speaking" heading is worse than no heading.
|
||||
7. `Person` JSON-LD. Downloadable one-page PDF bio — brief §VIII lists this as
|
||||
an asset for circulation with appointment proposals.
|
||||
|
||||
### `/mediation/`
|
||||
|
||||
**Job:** convert counsel who have already decided on mediation and are choosing a
|
||||
neutral.
|
||||
**Search intent:** `commercial mediator Toronto`, `ADRIC mediation rules`,
|
||||
`what happens at mediation Ontario`.
|
||||
|
||||
1. What the service is; the neutral's role stated plainly.
|
||||
2. **Formats:** full-day, half-day, shuttle, remote, hybrid.
|
||||
3. **Rules:** ADRIC Model Mediation Rules, or a bespoke protocol agreed by the
|
||||
parties.
|
||||
4. **What parties should bring** — briefs, documents, authority to settle.
|
||||
5. **Confidentiality and without-prejudice framing.**
|
||||
6. Practice areas → `/practice/*`.
|
||||
7. Fees → `/fees/`. Booking → `/contact/`.
|
||||
|
||||
### `/arbitration/`
|
||||
|
||||
**Job:** the same, for arbitration — and to state the Q.Arb position honestly.
|
||||
**Search intent:** `sole arbitrator Ontario`, `expedited arbitration Canada`,
|
||||
`documents-only arbitration`.
|
||||
|
||||
1. What the service is; sole-arbitrator, party-appointed, and tribunal-secretary
|
||||
appointments.
|
||||
2. **Tracks:** documents-only, expedited, full hearing.
|
||||
3. **Rules:** ADRIC, ADR Chambers, ad hoc.
|
||||
4. Awards — form, reasoning, timing.
|
||||
5. **Credentialing status, stated plainly.** The Q.Arb pathway is in progress;
|
||||
the page says so and describes what is available now (co-arbitration,
|
||||
tribunal secretary) versus what follows designation. Honesty here is a
|
||||
differentiator, not a weakness — and misstating it is a conduct problem.
|
||||
6. Fees, booking.
|
||||
|
||||
### `/med-arb/`
|
||||
|
||||
**Job:** own a term few Canadian neutrals explain well, and frame the C.Med-Arb
|
||||
endpoint.
|
||||
**Search intent:** `med-arb Canada`, `what is med-arb`, `arb-med`.
|
||||
|
||||
1. What Med-Arb is; how it differs from Arb-Med.
|
||||
2. The procedural fairness objection, addressed head-on rather than elided.
|
||||
3. When it fits and when it does not.
|
||||
4. The C.Med-Arb designation and why it is the practice's stated endpoint.
|
||||
|
||||
This page is a strong candidate for the best-performing page on the site.
|
||||
Search demand exists, competition is thin, and it maps exactly to the brand's
|
||||
long-term narrative.
|
||||
|
||||
### `/practice/` — index
|
||||
|
||||
Six cards, one paragraph each, linking onward. Also the natural home for the
|
||||
"also offered" strip: early neutral evaluation, settlement counsel, dispute-
|
||||
system design, and pre-dispute technical advisory.
|
||||
|
||||
### `/practice/construction/`
|
||||
|
||||
**Search intent:** `construction lien mediation Ontario`, `delay claim mediation`,
|
||||
`subcontract dispute arbitration Toronto`.
|
||||
|
||||
Dispute types (lien, delay, change orders, scheduling, subcontract, deficiency);
|
||||
what an active litigation practice in the same matters brings to the room; the
|
||||
Ontario megaproject pipeline as context — Darlington SMR, Bruce C, data centres,
|
||||
transit; typical process shape. Strongest immediate fit per brief §III.1.
|
||||
|
||||
### `/practice/technology/`
|
||||
|
||||
**Search intent:** `SaaS dispute arbitration Canada`, `AI vendor dispute`,
|
||||
`data residency dispute resolution`, `software contract mediator`.
|
||||
|
||||
The differentiator page. Dispute types: software contracts, SLA and MSA
|
||||
breakdowns, data residency and processing, AI vendor diligence, cloud
|
||||
sub-processor disputes, IP and licensing.
|
||||
|
||||
**Write this page in the register the brief demands:** a neutral who can read an
|
||||
API trace, a model card, or a System Impact Assessment on the same page as the
|
||||
contract. The brief warns explicitly against softening this to "technologically
|
||||
literate" — the claim is engineering practice, so the copy says engineering
|
||||
practice.
|
||||
|
||||
### `/practice/energy/`
|
||||
|
||||
**Search intent:** `Bill 40 dispute`, `IESO dispute resolution`,
|
||||
`OEB leave to construct dispute`, `grid connection dispute Ontario`.
|
||||
|
||||
Grid connection and allocation, leave-to-construct, proponent–municipality
|
||||
disputes, IESO market participation, data-centre connection allocation. Brief
|
||||
§III.2 frames this as a 24–36 month build. **Write it as a genuine position, not
|
||||
a claim of existing volume.**
|
||||
|
||||
### `/practice/insurance/`
|
||||
|
||||
**Search intent:** `SABS mediation`, `LAT pre-hearing mediation`,
|
||||
`accident benefits mediator Ontario`, `MIG dispute`.
|
||||
|
||||
Highest realistic near-term volume — it flows directly from the existing
|
||||
personal-injury and SABS practice, and brief §IV.7 notes the segment is
|
||||
underserved by senior mediators. Unglamorous and worth doing well.
|
||||
|
||||
### `/practice/shareholder/`
|
||||
|
||||
**Search intent:** `shareholder dispute mediation Ontario`,
|
||||
`partnership dissolution mediator`, `family business succession dispute`.
|
||||
|
||||
Shareholder and partnership disputes, co-founder breakdowns, family-business
|
||||
succession, SME exits. The operator angle — running SML Company Ltd. alongside
|
||||
the practice — is the differentiator here.
|
||||
|
||||
### `/practice/cross-cultural/`
|
||||
|
||||
**Search intent:** `Farsi speaking mediator Toronto`,
|
||||
`Iranian Canadian business dispute`, `diaspora shareholder dispute`.
|
||||
|
||||
Note that D4 makes the site English-only. This page describes Farsi-language
|
||||
capability in English; it is not a Farsi page. Diaspora family-business
|
||||
succession, dual-jurisdiction shareholder disputes, partnership disputes among
|
||||
diaspora entrepreneurs, cross-cultural commercial matters.
|
||||
|
||||
### `/process/`
|
||||
|
||||
Five steps, from intake to conclusion: confidential intake (day 0) · engagement
|
||||
and framing (1–7) · pre-session exchange (7–21) · the session (21–30) · binding
|
||||
conclusion (30+). Also: conflicts checking, confidentiality, and what happens if
|
||||
a matter does not settle.
|
||||
|
||||
### `/fees/`
|
||||
|
||||
**Blocked on `AGENTS.md` Q4 — do not invent numbers.**
|
||||
|
||||
Hourly rate; half-day and full-day mediation; preparation time policy;
|
||||
cancellation terms; administrative fee; HST treatment; who pays and how costs
|
||||
are shared between parties; payment terms. A real page with real numbers, or a
|
||||
`TODO(pouya)` — nothing in between.
|
||||
|
||||
### `/for-parties/`
|
||||
|
||||
**Job:** serve the self-represented tier without diluting the counsel-facing
|
||||
pages. Plain language, short sentences, no jargon.
|
||||
|
||||
What mediation is · what it is not · who the mediator is and is not (not your
|
||||
lawyer, not a judge) · what happens on the day · what it costs · what happens if
|
||||
you do not settle · how to prepare.
|
||||
|
||||
### `/insights/` and `/insights/[slug]/`
|
||||
|
||||
Astro content collection, MDX. Index reverse-chronological with topic filtering
|
||||
by practice area.
|
||||
|
||||
Article frontmatter: `title`, `description`, `publishDate`, `updatedDate`,
|
||||
`topics[]`, `practiceAreas[]`, `readingTime`, `draft`.
|
||||
|
||||
Content territories, from brief §VII: process explainers · regulatory commentary ·
|
||||
industry-specific dispute commentary · anonymised reflections · technical
|
||||
explainers for lawyers · credentialing and career-arc content.
|
||||
|
||||
`Article` JSON-LD with `author` pointing at the `Person` entity. Each article
|
||||
links to the relevant practice-area page — this is what turns the blog into
|
||||
ranking power for the pages that convert.
|
||||
|
||||
**The section stays out of primary navigation until at least two pieces are
|
||||
live.** An empty blog signals abandonment more loudly than no blog signals
|
||||
anything.
|
||||
|
||||
### `/contact/`
|
||||
|
||||
Intake form (`05-backend-spec.md`), booking embed, direct email and phone
|
||||
(Q3), Toronto by-appointment line, response-time expectation, and an explicit
|
||||
note that submitting the form does not create a retainer or a mediator–party
|
||||
relationship and does not itself create a conflict check.
|
||||
|
||||
### `/legal/privacy/` and `/legal/terms/`
|
||||
|
||||
Required, not optional — the intake form collects personal information about
|
||||
identifiable third parties in live legal disputes. What is collected, why, where
|
||||
it is stored (DynamoDB, region), retention period, who can access it, how to
|
||||
request deletion, and the contact for privacy inquiries. Must match what the
|
||||
backend actually does.
|
||||
|
||||
---
|
||||
|
||||
## Build order
|
||||
|
||||
Dependency-ordered, so nothing is blocked mid-stream:
|
||||
|
||||
1. Scaffold, tokens, base layout, header, footer, SEO component
|
||||
2. `/` — proves the design system end to end
|
||||
3. `/about/` — the credential spine everything else references
|
||||
4. `/mediation/`, `/arbitration/`, `/med-arb/`
|
||||
5. `/practice/` and the six area pages
|
||||
6. `/process/`, `/for-parties/`
|
||||
7. `/insights/` plumbing, then the drafted articles
|
||||
8. `/contact/` and the intake backend
|
||||
9. `/fees/` — last, since it is blocked on Q4
|
||||
10. `/legal/*` — written to match the backend as actually built
|
||||
11. Audit and cutover (`06-deployment.md`)
|
||||
@@ -0,0 +1,195 @@
|
||||
# 02 — Design system
|
||||
|
||||
Authority: `AGENTS.md` §3 D7 — *keep the palette and the infinity mark;
|
||||
modernize the execution.* The look is not up for redesign. What follows is the
|
||||
system that preserves it while fixing what the old build got wrong.
|
||||
|
||||
---
|
||||
|
||||
## What carries over unchanged
|
||||
|
||||
- The **palette**: cream, ink, maroon, gold.
|
||||
- The **infinity mark** — SML Company Ltd.'s actual logo, and the metaphor holds:
|
||||
a dispute is a loop, and the work is redrawing the loop into a line.
|
||||
- The **type pairing**: Instrument Serif for display, Geist for text, Geist Mono
|
||||
for eyebrows and labels.
|
||||
- The **editorial register** — generous whitespace, restrained colour, serif
|
||||
display type at large sizes.
|
||||
|
||||
## What changes
|
||||
|
||||
| Was | Is | Why |
|
||||
|---|---|---|
|
||||
| Google Fonts at runtime | Self-hosted, subset, preloaded | Removes a render-blocking third-party round trip from a page that collects legal inquiries |
|
||||
| Fixed px type sizes | Fluid `clamp()` scale | One scale from 360 px to 1600 px with no breakpoint jumps |
|
||||
| Ad hoc spacing values | 8 px base scale | Consistent vertical rhythm; no magic numbers |
|
||||
| Gold used as a text colour on cream | Gold restricted to decorative and on-dark | **It fails WCAG AA at 2.10:1.** Measured, not assumed |
|
||||
| Scroll-reveal on every element, always on | Reveal on major sections only, gated behind `prefers-reduced-motion` | Motion that reads as confident rather than decorative; accessible by default |
|
||||
| 2.2 MB single file, ~1 MB of base64 logos | Optimized SVG mark, AVIF/WebP photography | The mark is geometry; it should be vector, not a 470 KB PNG |
|
||||
| React 18 dev build + Babel Standalone in the browser | Static HTML, near-zero JS | The reason the site is invisible to crawlers |
|
||||
|
||||
---
|
||||
|
||||
## Colour
|
||||
|
||||
Tokens live in `src/styles/tokens.css`. Never write a raw hex value in a
|
||||
component.
|
||||
|
||||
| Token | Value | Use |
|
||||
|---|---|---|
|
||||
| `--cream` | `#faf7f2` | Page background |
|
||||
| `--cream-2` | `#f3ede0` | Alternating section background |
|
||||
| `--cream-3` | `#ebe3d1` | Cards and insets on cream |
|
||||
| `--ink` | `#1a1614` | Body text; dark section backgrounds |
|
||||
| `--ink-soft` | `#3a322c` | Secondary text |
|
||||
| `--muted` | `#6e6359` | Metadata, captions — **on cream only** |
|
||||
| `--maroon` | `#5a1a1c` | Primary action, accents, dark panels |
|
||||
| `--maroon-d` | `#3d1112` | Hover on maroon |
|
||||
| `--maroon-l` | `#7a2a2c` | Links on cream |
|
||||
| `--gold` | `#c9a876` | Rules, dividers, on-dark accent — **never text on cream** |
|
||||
| `--gold-d` | `#a88858` | Large decorative text on cream only |
|
||||
| `--gold-l` | `#e2c89a` | Text on ink or maroon |
|
||||
|
||||
### Contrast — measured, 2026-08-25
|
||||
|
||||
Against `--cream` `#faf7f2`:
|
||||
|
||||
| Colour | Ratio | AA body (4.5) | AA large (3.0) |
|
||||
|---|---|---|---|
|
||||
| `--ink` `#1a1614` | **16.81** | pass | pass |
|
||||
| `--ink-soft` `#3a322c` | **11.75** | pass | pass |
|
||||
| `--maroon` `#5a1a1c` | **12.29** | pass | pass |
|
||||
| `--maroon-l` `#7a2a2c` | **8.95** | pass | pass |
|
||||
| `--muted` `#6e6359` | **5.47** | pass | pass |
|
||||
| `--gold-d` `#a88858` | **3.11** | **FAIL** | pass |
|
||||
| `--gold` `#c9a876` | **2.10** | **FAIL** | **FAIL** |
|
||||
|
||||
Against `--maroon` `#5a1a1c`: cream 12.29 · gold-l 8.11 · gold 5.84 — all pass.
|
||||
Against `--ink` `#1a1614`: cream 16.81 · gold-l 11.09 · gold 8.00 — all pass.
|
||||
`--muted` on ink measures **3.07 and fails**; use `--gold-l` or cream at reduced
|
||||
opacity for secondary text on dark.
|
||||
|
||||
**Hard rules.**
|
||||
|
||||
1. `--gold` is never a text colour on cream. Rules, borders, dividers, icon
|
||||
strokes, and on-dark text only.
|
||||
2. `--gold-d` on cream only at 24 px+ / 19 px bold, and only for decorative
|
||||
display text — never for anything a reader must parse.
|
||||
3. Body text on cream is `--ink` or `--ink-soft`. Metadata may use `--muted`.
|
||||
4. Secondary text on dark is `--gold-l` or `--cream` at ≥ 70% opacity.
|
||||
5. **No dark mode.** A single committed light identity is the right call for a
|
||||
legal practice, and halving the surface area halves the ways contrast breaks.
|
||||
|
||||
---
|
||||
|
||||
## Typography
|
||||
|
||||
**Faces.** Instrument Serif (display) · Geist 300/400/500/600 (text) ·
|
||||
Geist Mono 400/500 (eyebrows, labels, data).
|
||||
|
||||
Self-host all three. Subset to Latin + Latin Extended-A. `font-display: swap`.
|
||||
Preload only the two faces used above the fold — Instrument Serif regular and
|
||||
Geist 400.
|
||||
|
||||
**Scale.** Fluid, `clamp()`, `1.25` ratio at the small end widening to `1.333` at
|
||||
the display end. Tokens `--text-xs` through `--text-6xl` in `tokens.css`.
|
||||
|
||||
**Rules.**
|
||||
|
||||
- Display type (`--font-serif`) at `--text-4xl` and above only. It has almost no
|
||||
hinting at small sizes and looks weak below 32 px.
|
||||
- Display line-height `0.95`–`1.05`; letter-spacing `-0.02em`.
|
||||
- Body line-height `1.6`. Measure capped at `68ch` — the old site ran full-bleed
|
||||
paragraphs at 1400 px, which is unreadable.
|
||||
- Eyebrows: mono, 11–12 px, `0.18em` tracking, uppercase, always paired with a
|
||||
real heading. An eyebrow is not a heading and never carries the `<h*>`.
|
||||
- Italic display (`.it`) is the one flourish the design allows. One italic phrase
|
||||
per headline, at most.
|
||||
- Never skip a heading level. `<h1>` once per page.
|
||||
|
||||
---
|
||||
|
||||
## Spacing and layout
|
||||
|
||||
8 px base: `--space-1` `4px` · `-2` `8` · `-3` `12` · `-4` `16` · `-5` `24` ·
|
||||
`-6` `32` · `-7` `48` · `-8` `64` · `-9` `96` · `-10` `128` · `-11` `160`.
|
||||
|
||||
Content width `1280px`; prose measure `68ch`; wide media `1440px`.
|
||||
Gutters: `24px` mobile, `48px` desktop.
|
||||
Section rhythm: `--space-9` (96px) mobile, `--space-11` (160px) desktop.
|
||||
|
||||
Grid: 12 columns desktop, 6 tablet, 4 mobile, `--space-5` gutter.
|
||||
|
||||
---
|
||||
|
||||
## Motion
|
||||
|
||||
The old build animated nearly everything on scroll. The replacement is
|
||||
deliberate and quiet.
|
||||
|
||||
- **Reveal on section entry only** — not on every child element. Sub-element
|
||||
stagger is limited to card grids, and capped at six children.
|
||||
- Duration `600ms`, easing `cubic-bezier(.2,.7,.2,1)`. Transform and opacity
|
||||
only — never layout properties.
|
||||
- Implement with `IntersectionObserver` in one tiny inline script, or
|
||||
`animation-timeline: view()` where supported. Not a framework, not a library.
|
||||
- **Content is visible without JavaScript.** The reveal is an enhancement layered
|
||||
on top of already-rendered HTML. If the observer never runs, the page reads
|
||||
normally. The old build had this exactly backwards.
|
||||
- Hover transitions `250ms`.
|
||||
|
||||
```css
|
||||
@media (prefers-reduced-motion: reduce) {
|
||||
*, *::before, *::after {
|
||||
animation-duration: 0.01ms !important;
|
||||
animation-iteration-count: 1 !important;
|
||||
transition-duration: 0.01ms !important;
|
||||
scroll-behavior: auto !important;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Nothing animates infinitely. Nothing autoplays. Nothing moves on page load
|
||||
except the reveal of the hero.
|
||||
|
||||
---
|
||||
|
||||
## Components
|
||||
|
||||
| Component | Notes |
|
||||
|---|---|
|
||||
| `InfinityMark` | Inline SVG, `currentColor`, `aria-hidden` when decorative. Never a PNG |
|
||||
| `SiteHeader` | Sticky, condenses on scroll. Practice dropdown as CSS-only `<details>` |
|
||||
| `SiteFooter` | Three-column sitemap, contact block, designations, entity line |
|
||||
| `Eyebrow` | Mono label with optional maroon dot |
|
||||
| `SectionHeading` | Eyebrow + display heading + optional lede, one measure |
|
||||
| `Button` | Variants `primary` (maroon) · `ghost` (outlined) · `gold` (ink bg, gold-l text). Renders `<a>` or `<button>` correctly |
|
||||
| `Pill` | Small bordered label for designations and sector chips |
|
||||
| `CredentialRow` | Three or four credential slots. **Never matter counts** — `AGENTS.md` §4 |
|
||||
| `PracticeCard` | Sector chip, heading, one paragraph, arrow link |
|
||||
| `ProcessStep` | Numbered step, timing, body |
|
||||
| `ArticleCard` | Title, description, date, topic pills, reading time |
|
||||
| `Prose` | Long-form wrapper. Owns all typographic defaults for MDX |
|
||||
| `SEO` | Title, description, canonical, OG, Twitter, JSON-LD — see `04-seo-spec.md` |
|
||||
|
||||
**Focus states.** Every interactive element gets a visible focus ring:
|
||||
`outline: 2px solid var(--maroon); outline-offset: 3px`. Use `:focus-visible`.
|
||||
Never `outline: none` without a replacement — the old build removed it globally.
|
||||
|
||||
---
|
||||
|
||||
## Accessibility floor
|
||||
|
||||
Not a polish pass. A build requirement.
|
||||
|
||||
- One `<h1>` per page; heading levels never skipped.
|
||||
- Landmarks: `<header>`, `<nav>`, `<main>`, `<footer>`. Skip-to-content link first
|
||||
in tab order.
|
||||
- Every image has `alt`. Decorative images get `alt=""`.
|
||||
- Colour never carries meaning alone.
|
||||
- All functionality reachable by keyboard; focus order matches visual order.
|
||||
- Forms: real `<label>` elements, `aria-describedby` for hints, errors announced
|
||||
with `role="alert"` and tied to their field.
|
||||
- Touch targets ≥ 44 × 44 px.
|
||||
- Test at 200% zoom and at 320 px width.
|
||||
- Every page must be readable and navigable with JavaScript disabled.
|
||||
@@ -0,0 +1,198 @@
|
||||
# 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 and tribunal-secretary work is available now." 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". LSO marketing rules,
|
||||
and they read as insecure.
|
||||
- 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 a working litigator 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 an active litigation practice; 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
|
||||
**Blocked on Q4.** Real numbers or `TODO(pouya)`. 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
|
||||
@@ -0,0 +1,132 @@
|
||||
# 04 — Discoverability
|
||||
|
||||
The problem this project exists to fix. `AGENTS.md` §2 has the measurements: a
|
||||
server-side fetch of the live site returns three words.
|
||||
|
||||
---
|
||||
|
||||
## The baseline being replaced
|
||||
|
||||
| | Now `[verified 2026-08-25]` | Target |
|
||||
|---|---|---|
|
||||
| Content in server HTML | `SML Company · DISPUTE RESOLUTION · Unpacking...` | Every word |
|
||||
| Indexable pages | 1 | 19 + articles |
|
||||
| `<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, LegalService, 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"
|
||||
Home: "Pouya Lajevardi · Mediation & Arbitration · Toronto"
|
||||
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. Generate at build with `satori` or `astro-og-canvas`
|
||||
using the site's own type and palette. One template: display headline on cream,
|
||||
infinity mark, designation line. Never a screenshot.
|
||||
|
||||
## Structured data
|
||||
|
||||
JSON-LD only. Validate against Google's Rich Results Test before cutover.
|
||||
|
||||
| Type | Where | Notes |
|
||||
|---|---|---|
|
||||
| `Person` | `/about/`, referenced site-wide | `name`, `jobTitle`, `description`, `alumniOf` (Bond University), `knowsLanguage` (en, fa), `hasCredential` (Q.Med), `sameAs` (LinkedIn — **Q12**), `image`, `worksFor` |
|
||||
| `LegalService` | Home | `areaServed` Toronto/Ontario, `serviceType` Mediation/Arbitration, `provider` → Person, `priceRange` once `/fees/` is real |
|
||||
| `Service` | Each practice page | `serviceType`, `provider` → Person, `areaServed` |
|
||||
| `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 is held. Q.Arb is not. Marking an
|
||||
unheld credential as held in structured data is a misrepresentation that happens
|
||||
to be machine-readable.
|
||||
|
||||
## Crawlability
|
||||
|
||||
**`public/robots.txt`:**
|
||||
|
||||
```
|
||||
User-agent: *
|
||||
Allow: /
|
||||
Disallow: /legal/
|
||||
|
||||
Sitemap: https://adr.smlcompany.ca/sitemap-index.xml
|
||||
```
|
||||
|
||||
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 |
|
||||
|
||||
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 name, address, and phone across all of them.
|
||||
|
||||
## 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, LegalService, 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
|
||||
@@ -0,0 +1,175 @@
|
||||
# 05 — Intake, booking, and data handling
|
||||
|
||||
Authority: `AGENTS.md` §3 D10 — rebuilt intake form plus calendar booking.
|
||||
Existing infrastructure is documented in `AWS-Hosting-Guide.md` Parts 8–10.
|
||||
**Read that guide before changing anything**; the resources already exist and
|
||||
were built by hand in the console.
|
||||
|
||||
---
|
||||
|
||||
## What exists today
|
||||
|
||||
API Gateway (HTTP API) → Lambda → DynamoDB, with SES for notification email and
|
||||
a verified sender on `smlcompany.ca`. `[verified 2026-08-25 — AWS-Hosting-Guide.md]`
|
||||
|
||||
The shape is right. This is a hardening and rework pass, not a replacement.
|
||||
|
||||
## What this data actually is
|
||||
|
||||
The form collects, in a live legal dispute: the inquirer's identity and contact
|
||||
details, the names of opposing parties and their counsel, the nature of the
|
||||
dispute, and often the amounts at issue.
|
||||
|
||||
That is **personal information about identifiable third parties who have not
|
||||
consented and do not know the submission happened.** It is more sensitive than a
|
||||
typical contact form by a wide margin, and it is potentially conflict-relevant.
|
||||
Design accordingly. Nothing in this section is optional.
|
||||
|
||||
---
|
||||
|
||||
## Form fields
|
||||
|
||||
| Field | Type | Required | Notes |
|
||||
|---|---|---|---|
|
||||
| Name | text | yes | |
|
||||
| Email | email | yes | Validated server-side, not only in the browser |
|
||||
| Phone | tel | no | |
|
||||
| Role | select | yes | Counsel · In-house · Party · Institution · Other |
|
||||
| Firm / organisation | text | no | |
|
||||
| Process sought | select | yes | Mediation · Arbitration · Med-Arb · ENE · Not sure |
|
||||
| Practice area | select | yes | The six areas plus Other |
|
||||
| Other parties | text | no | Surfaced for conflicts screening |
|
||||
| Opposing counsel | text | no | Same |
|
||||
| Matter summary | textarea | yes | 2000 char cap. Hint: *no privileged or confidential detail* |
|
||||
| Timing | select | no | Urgent · 30 days · 90 days · Exploring |
|
||||
| Preferred contact | radio | no | Email · Phone |
|
||||
| Consent | checkbox | **yes** | Explicit, unchecked by default, links to `/legal/privacy/` |
|
||||
|
||||
**Do not collect** dollar amounts, document uploads, or anything the inquirer
|
||||
might reasonably treat as privileged. The intake call is for that.
|
||||
|
||||
### Consent text
|
||||
|
||||
> I consent to Pouya Lajevardi storing and using the information in this form to
|
||||
> respond to my inquiry and to run a conflicts check. I understand that
|
||||
> submitting this form does not create a retainer, does not appoint a neutral,
|
||||
> and does not itself establish a mediator–party relationship.
|
||||
|
||||
## Validation and abuse control
|
||||
|
||||
Client-side validation is a convenience. **The Lambda re-validates everything.**
|
||||
|
||||
- Required fields present; email well-formed; lengths within bounds
|
||||
- Reject any field over its cap rather than truncating silently
|
||||
- **Honeypot** field, hidden from sighted and screen-reader users, must be empty
|
||||
- **Timestamp check** — reject submissions completed in under 3 seconds
|
||||
- **Rate limit** by source IP at API Gateway: 5 requests / 5 minutes
|
||||
- No CAPTCHA. It is a third-party script on a page collecting legal information,
|
||||
and the two controls above stop the traffic that matters
|
||||
- CORS restricted to `https://adr.smlcompany.ca` — no wildcard
|
||||
- Strip HTML from every field before storage and before it enters an email body
|
||||
|
||||
## Storage
|
||||
|
||||
DynamoDB, `ca-central-1` — **Canadian data residency is a real selling point for
|
||||
a Canadian legal practice, and the privacy policy will say so.** Confirm the
|
||||
existing table's region and migrate if it is elsewhere (**Q10**).
|
||||
|
||||
| Attribute | |
|
||||
|---|---|
|
||||
| `pk` | `INTAKE#<uuid>` |
|
||||
| `sk` | `<ISO-8601 timestamp>` |
|
||||
| fields | as above |
|
||||
| `sourceIp`, `userAgent` | abuse investigation only |
|
||||
| `ttl` | epoch seconds — **automatic deletion** |
|
||||
|
||||
**Encryption at rest** with a customer-managed KMS key. **Point-in-time recovery
|
||||
on.** Table access limited to the Lambda role and one named administrative
|
||||
principal.
|
||||
|
||||
### Retention
|
||||
|
||||
**24 months, enforced by DynamoDB TTL.** Not a policy someone remembers — a
|
||||
mechanism that runs whether anyone remembers or not.
|
||||
|
||||
Rationale: long enough to serve conflicts screening across a normal matter
|
||||
lifecycle; short enough to be defensible under PIPEDA's requirement to retain
|
||||
personal information only as long as necessary. Whatever number ships must match
|
||||
`/legal/privacy/` exactly.
|
||||
|
||||
## Notification
|
||||
|
||||
SES on submission:
|
||||
|
||||
- **To Pouya:** the full submission, plainly formatted, replyable to the inquirer.
|
||||
- **To the inquirer:** confirmation of receipt, expected response time, a repeat
|
||||
of the no-retainer language, and a link to the privacy policy. This email is
|
||||
the reason the form beats a `mailto:` link.
|
||||
|
||||
SES must have SPF, DKIM, and DMARC aligned on `smlcompany.ca` or these land in
|
||||
spam. The guide covers domain verification; **DMARC needs confirming (Q3)**.
|
||||
|
||||
Failure handling: SES failure must never lose the submission. Write to DynamoDB
|
||||
first, then send. A dead-letter queue on the Lambda, and a CloudWatch alarm on
|
||||
DLQ depth ≥ 1.
|
||||
|
||||
## Booking
|
||||
|
||||
An embedded scheduler for the 30–45 minute confidential intake call
|
||||
(**Q5** — tool not yet chosen).
|
||||
|
||||
- Prefer a provider with Canadian or EU data residency and no advertising
|
||||
business. Cal.com self-hosted is the strongest privacy posture; Cal.com cloud
|
||||
or Calendly are acceptable.
|
||||
- **Lazy-load behind a click.** No third-party iframe on first paint, and no
|
||||
third-party script on any other page.
|
||||
- Provide a plain link fallback that works with JavaScript disabled.
|
||||
- The booking page must carry the same no-retainer language.
|
||||
- Disclose the provider by name in `/legal/privacy/`.
|
||||
|
||||
## Security headers
|
||||
|
||||
Set at CloudFront via a response-headers policy:
|
||||
|
||||
```
|
||||
Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
|
||||
X-Content-Type-Options: nosniff
|
||||
Referrer-Policy: strict-origin-when-cross-origin
|
||||
Permissions-Policy: geolocation=(), microphone=(), camera=(), interest-cohort=()
|
||||
Content-Security-Policy: default-src 'self'; img-src 'self' data:;
|
||||
style-src 'self' 'unsafe-inline'; script-src 'self';
|
||||
frame-src <booking-provider>; form-action 'self' <api-endpoint>;
|
||||
base-uri 'self'; frame-ancestors 'none'
|
||||
```
|
||||
|
||||
Tighten CSP once the booking provider is chosen. `unsafe-inline` on styles is
|
||||
tolerable for critical CSS; `unsafe-inline` on scripts is not — use a hash or
|
||||
nonce for the reveal script.
|
||||
|
||||
## Privacy policy must state
|
||||
|
||||
Written to match what is actually built, not what is typical:
|
||||
|
||||
What is collected · why · lawful basis (consent) · where it is stored (DynamoDB,
|
||||
region, encrypted at rest) · **the retention period and that deletion is
|
||||
automatic** · who can access it · third parties involved (AWS, SES, the booking
|
||||
provider, analytics if any) · how to request access or deletion and the address
|
||||
to use · that submitting the form creates no retainer and no mediator–party
|
||||
relationship · cookie and analytics disclosure · last-updated date.
|
||||
|
||||
If analytics ship, prefer a cookieless privacy-preserving tool (Plausible,
|
||||
Fathom). GA4 on a page collecting legal-dispute information is a poor fit for a
|
||||
practice whose privacy posture is part of its offer (**Q11**).
|
||||
|
||||
## Definition of done
|
||||
|
||||
- [ ] Server-side validation independent of the client
|
||||
- [ ] Honeypot and timing checks live; rate limit configured
|
||||
- [ ] CORS restricted to the production origin
|
||||
- [ ] TTL set and verified by test record
|
||||
- [ ] KMS encryption and PITR enabled
|
||||
- [ ] Both emails send; SPF/DKIM/DMARC aligned; inbox-tested, not spam-tested
|
||||
- [ ] DLQ and CloudWatch alarm configured
|
||||
- [ ] Form usable by keyboard only; errors announced with `role="alert"`
|
||||
- [ ] Form degrades to a `mailto:` fallback with JavaScript disabled
|
||||
- [ ] Privacy policy matches the implementation line for line
|
||||
@@ -0,0 +1,274 @@
|
||||
# 06 — Deployment and cutover
|
||||
|
||||
Authority: `AGENTS.md` §3 D3 (git + GitHub Actions → existing S3/CloudFront) and
|
||||
D11 (build everything, one clean cutover).
|
||||
Existing infrastructure: `AWS-Hosting-Guide.md`.
|
||||
|
||||
---
|
||||
|
||||
## Topology
|
||||
|
||||
```
|
||||
GitHub push to main
|
||||
└─ GitHub Actions
|
||||
├─ npm ci && npm run build → ./dist
|
||||
├─ assume AWS role via OIDC (no stored keys)
|
||||
├─ aws s3 sync ./dist s3://<bucket>
|
||||
└─ cloudfront create-invalidation
|
||||
Namecheap DNS → CloudFront → S3 (OAC)
|
||||
API Gateway → Lambda → DynamoDB / SES (intake, unchanged path)
|
||||
```
|
||||
|
||||
DNS is at **Namecheap, not Route 53** `[verified 2026-08-25]`. Nothing in the
|
||||
pipeline touches DNS. Certificate renewal is ACM-automatic as long as the
|
||||
validation CNAME stays in place at Namecheap — **do not delete it.**
|
||||
|
||||
## CI runs on Gitea, not GitHub
|
||||
|
||||
`AGENTS.md` D3 as amended, 2026-08-26: self-hosted **Gitea**, repo `adr-sml`,
|
||||
local clone at `/Users/pouya/Dev/Websites/adr-sml`.
|
||||
|
||||
**The live pipeline is `.gitea/workflows/deploy.yml`.** Gitea Actions speaks
|
||||
GitHub Actions syntax, so it is a near-direct port — the build steps, the
|
||||
two-pass sync, and the cache headers are unchanged. `.github/workflows/deploy.yml`
|
||||
stays in the repo as the OIDC reference in case the project ever moves.
|
||||
|
||||
### The one real difference: no OIDC
|
||||
|
||||
Gitea is not an AWS OIDC provider. There is no role to assume, so deploys
|
||||
authenticate with a **scoped IAM user** whose access key lives only in the
|
||||
repository's Gitea secrets.
|
||||
|
||||
This is a genuine step down in security from the GitHub setup, and it should be
|
||||
treated as one. The mitigations are the policy scope and the rotation schedule.
|
||||
|
||||
**Create the user:**
|
||||
|
||||
1. IAM → Users → `adr-sml-deploy`. **Programmatic access only** — no console
|
||||
password, no MFA device, no group membership.
|
||||
2. Attach this inline policy and nothing else. Substitute the real bucket name,
|
||||
account ID, and distribution ID from `scripts/aws-discover.sh`:
|
||||
|
||||
```json
|
||||
{
|
||||
"Version": "2012-10-17",
|
||||
"Statement": [
|
||||
{
|
||||
"Sid": "ListSiteBucket",
|
||||
"Effect": "Allow",
|
||||
"Action": "s3:ListBucket",
|
||||
"Resource": "arn:aws:s3:::BUCKET_NAME"
|
||||
},
|
||||
{
|
||||
"Sid": "WriteSiteObjects",
|
||||
"Effect": "Allow",
|
||||
"Action": ["s3:PutObject", "s3:PutObjectAcl", "s3:DeleteObject"],
|
||||
"Resource": "arn:aws:s3:::BUCKET_NAME/*"
|
||||
},
|
||||
{
|
||||
"Sid": "InvalidateOneDistribution",
|
||||
"Effect": "Allow",
|
||||
"Action": "cloudfront:CreateInvalidation",
|
||||
"Resource": "arn:aws:cloudfront::ACCOUNT_ID:distribution/DISTRIBUTION_ID"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
No `s3:*`. No `cloudfront:*`. No wildcard resources. If a deploy step needs a
|
||||
permission this policy lacks, the correct response is to question the step, not
|
||||
to widen the policy.
|
||||
|
||||
3. Create an access key. **Copy it once** — AWS will not show the secret again.
|
||||
|
||||
### Gitea configuration
|
||||
|
||||
**Repository → Settings → Actions → Secrets:**
|
||||
|
||||
| Name | Value |
|
||||
|---|---|
|
||||
| `AWS_ACCESS_KEY_ID` | from the IAM user |
|
||||
| `AWS_SECRET_ACCESS_KEY` | from the IAM user |
|
||||
|
||||
**The real values** (captured 2026-08-26, `aws-inventory.txt`):
|
||||
|
||||
| Variable | Value |
|
||||
|---|---|
|
||||
| `AWS_REGION` | `ca-central-1` |
|
||||
| `S3_BUCKET` | `adr-smlcompany-site` |
|
||||
| `CLOUDFRONT_DISTRIBUTION_ID` | `E1OK7G98KNKUTA` |
|
||||
| `INTAKE_ENDPOINT` | `https://4tl0m5igkj.execute-api.ca-central-1.amazonaws.com` |
|
||||
| `BOOKING_URL` | *(empty — parked, R6)* |
|
||||
|
||||
IAM policy substitutions: `BUCKET_NAME` = `adr-smlcompany-site`,
|
||||
`ACCOUNT_ID` = `327082975128`, `DISTRIBUTION_ID` = `E1OK7G98KNKUTA`.
|
||||
|
||||
> **Read this before creating the key.** Account `327082975128` is shared across
|
||||
> `meshkinilaw.ca`, `demesne.media`, `orynenergy.ca`, `lajirugs.ca`, and
|
||||
> `mlp-clientdb-prod-backups` — a law firm's client-database backups. A static
|
||||
> deploy key for a marketing site lives in the same account. The scoped policy is
|
||||
> what keeps a compromised Gitea runner from reaching any of that. Do not widen
|
||||
> it, and never put the `user/pouya` credentials in CI.
|
||||
|
||||
**Repository → Settings → Actions → Variables** (not secrets — these are not
|
||||
sensitive, and keeping them as variables means they appear in run logs where they
|
||||
are useful for debugging):
|
||||
|
||||
| Name | Value |
|
||||
|---|---|
|
||||
| `AWS_REGION` | e.g. `ca-central-1` |
|
||||
| `S3_BUCKET` | the site bucket |
|
||||
| `CLOUDFRONT_DISTRIBUTION_ID` | the `E...` ID |
|
||||
| `INTAKE_ENDPOINT` | API Gateway invoke URL |
|
||||
| `BOOKING_URL` | once chosen (Q5) |
|
||||
|
||||
### A runner must exist
|
||||
|
||||
Gitea Actions needs `act_runner` registered to this repository or its
|
||||
organisation, and Actions enabled both site-wide in `app.ini`
|
||||
(`[actions] ENABLED = true`) and per-repository. Without a runner the workflow
|
||||
queues silently and never runs — which looks exactly like a broken pipeline.
|
||||
|
||||
The workflow installs the AWS CLI if the runner image lacks it, and runs
|
||||
`aws sts get-caller-identity` before touching anything, so a credential problem
|
||||
fails loudly and early rather than halfway through a sync.
|
||||
|
||||
### Key rotation — an operational obligation
|
||||
|
||||
**Rotate `adr-sml-deploy` quarterly.** OIDC would have made this unnecessary;
|
||||
with a static key it is a standing task:
|
||||
|
||||
1. Create a second access key on the same user.
|
||||
2. Update the Gitea secrets.
|
||||
3. Run the workflow and confirm it succeeds.
|
||||
4. **Delete the old key.** Rotation that leaves the old key active is not
|
||||
rotation.
|
||||
|
||||
Set a calendar reminder. A key that is never rotated is the failure mode this
|
||||
whole section exists to bound.
|
||||
|
||||
## Finding the AWS identifiers
|
||||
|
||||
`scripts/aws-discover.sh` collects everything Q10 needs — bucket, distribution
|
||||
ID, regions, API endpoint, certificate, SES identities, and whether S3 versioning
|
||||
is on. Read-only; every call is a list or describe.
|
||||
|
||||
```bash
|
||||
chmod +x scripts/aws-discover.sh
|
||||
./scripts/aws-discover.sh > aws-inventory.txt
|
||||
```
|
||||
|
||||
The output contains resource names and IDs but no secrets.
|
||||
|
||||
## Why OIDC and not access keys
|
||||
|
||||
The alternative is a long-lived `AWS_ACCESS_KEY_ID` in GitHub secrets: a
|
||||
credential that never expires, is invisible once set, and grants its permissions
|
||||
to anyone who can reach the repository. OIDC issues a short-lived token per run,
|
||||
scoped to this repository and this branch.
|
||||
|
||||
One-time setup:
|
||||
|
||||
1. IAM → Identity providers → add OIDC provider `token.actions.githubusercontent.com`,
|
||||
audience `sts.amazonaws.com`.
|
||||
2. Create role `adr-site-deploy` trusting that provider, with a condition on
|
||||
`token.actions.githubusercontent.com:sub` equal to
|
||||
`repo:<org>/<repo>:ref:refs/heads/main` (**Q9**).
|
||||
3. Attach a policy granting **only**: `s3:PutObject`, `s3:DeleteObject`,
|
||||
`s3:ListBucket` on the site bucket, and `cloudfront:CreateInvalidation` on the
|
||||
one distribution. Nothing else. No `s3:*`, no `cloudfront:*`.
|
||||
4. Store the role ARN, bucket name, and distribution ID as repository
|
||||
**variables** (they are not secrets), and reference them in the workflow.
|
||||
|
||||
## Cache policy
|
||||
|
||||
The mistake to avoid is caching HTML aggressively — a stale index page is a site
|
||||
that does not update.
|
||||
|
||||
| Pattern | `Cache-Control` |
|
||||
|---|---|
|
||||
| `*.html` | `public, max-age=0, must-revalidate` |
|
||||
| `/_astro/*` (hashed) | `public, max-age=31536000, immutable` |
|
||||
| Fonts | `public, max-age=31536000, immutable` |
|
||||
| Images | `public, max-age=604800` |
|
||||
| `robots.txt`, `sitemap*.xml` | `public, max-age=3600` |
|
||||
|
||||
Sync in two passes: hashed assets first with the long TTL, then HTML with the
|
||||
short one. Uploading HTML last means a user never fetches a new page whose assets
|
||||
have not landed yet.
|
||||
|
||||
Invalidate `/*` on deploy. At this traffic volume the cost is nil, and partial
|
||||
invalidation paths are a reliable source of confusing bugs.
|
||||
|
||||
## CloudFront configuration
|
||||
|
||||
- Origin: S3 with **Origin Access Control**, bucket not public. The guide's
|
||||
Part 2.2 bucket policy already does this — verify it was not loosened.
|
||||
- Redirect HTTP → HTTPS. TLS 1.2 minimum.
|
||||
- Default root object `index.html`.
|
||||
- **Custom error response:** 404 → `/404.html` with **response code 404**, not
|
||||
200. Returning 200 for a missing page tells crawlers every bad URL is real
|
||||
content, and it is the single most common misconfiguration in this stack.
|
||||
- Compression on. Response-headers policy from `05-backend-spec.md`.
|
||||
- A CloudFront Function for trailing-slash normalisation, so `/about` and
|
||||
`/about/` do not both resolve as separate indexable URLs.
|
||||
|
||||
## Branch model
|
||||
|
||||
`main` is production; every push deploys. Work on short-lived branches, open a
|
||||
PR, let CI build and run Lighthouse, merge.
|
||||
|
||||
**Pull request checks (blocking):** `npm run build` · `astro check` · lint ·
|
||||
Lighthouse CI against the budgets in `04-seo-spec.md` · link check.
|
||||
|
||||
Tag every production deploy `v<year>.<n>` so a rollback has something to name.
|
||||
|
||||
## Rollback
|
||||
|
||||
1. Re-run the workflow at the last good tag, or
|
||||
2. `git revert` and push, or
|
||||
3. Restore from S3 object versioning — **enable versioning on the bucket if it is
|
||||
off**; it is the difference between a rollback and a rebuild.
|
||||
|
||||
Then invalidate `/*`.
|
||||
|
||||
## Cutover checklist — D11 is a single shot, so run all of it
|
||||
|
||||
**Content and compliance**
|
||||
- [ ] Every claim traced to `AGENTS.md` §4 Verified
|
||||
- [ ] No `TODO(pouya)` remains in any shipped page
|
||||
- [ ] No matter counts, rates, dollar figures, or testimonials anywhere
|
||||
- [ ] Q.Arb described as in progress everywhere it appears
|
||||
- [ ] `/fees/` carries real numbers (Q4) or the page does not ship
|
||||
- [ ] Privacy policy matches the backend as actually built
|
||||
|
||||
**Technical**
|
||||
- [ ] Lighthouse ≥ 95 mobile on `/`, `/about/`, a practice page, an article
|
||||
- [ ] Every page renders fully with JavaScript disabled
|
||||
- [ ] `curl` of each URL returns real content, not a shell
|
||||
- [ ] All internal links resolve; no orphan pages
|
||||
- [ ] Sitemap generated and correct; `robots.txt` served, not 403
|
||||
- [ ] Rich Results Test passes; OG previews render in LinkedIn and Slack
|
||||
- [ ] 404 returns a 404 status
|
||||
- [ ] Security headers present (`securityheaders.com` A or better)
|
||||
- [ ] **SES identities verified for sending** (Q18) — `aws sesv2 get-email-identity --email-identity smlcompany.ca` and confirm `VerifiedForSendingStatus: true`
|
||||
- [ ] **SES out of the sandbox** (Q19) — `aws sesv2 get-account --query 'ProductionAccessEnabled'`. In sandbox, mail reaches only pre-verified addresses and the inquirer's confirmation silently fails
|
||||
- [ ] Intake form tested end to end: DynamoDB record written to `adr-intake-submissions`, both emails delivered to a real inbox, TTL set
|
||||
- [ ] Booking link works, including the no-JavaScript fallback
|
||||
- [ ] Favicon set complete
|
||||
- [ ] Tested on iOS Safari, Android Chrome, desktop Safari/Chrome/Firefox
|
||||
- [ ] Tested at 320 px and at 200% zoom
|
||||
|
||||
**Infrastructure**
|
||||
- [ ] S3 versioning enabled
|
||||
- [ ] Bucket not publicly readable; OAC in force
|
||||
- [ ] ACM certificate valid; Namecheap validation CNAME still present
|
||||
- [ ] CloudWatch alarms: Lambda errors, DLQ depth, 5xx rate
|
||||
- [ ] Billing alarm still active (guide Part 0.3)
|
||||
|
||||
**Post-cutover, same day**
|
||||
- [ ] Sitemap submitted to Google Search Console and Bing Webmaster Tools
|
||||
- [ ] Live site fetched as an anonymous crawler to confirm indexable content
|
||||
- [ ] LinkedIn profile and ADRIC/ADRIO listings updated to point here
|
||||
- [ ] Archive the old single-file build to `_archive/` — do not delete it
|
||||
- [ ] `AGENTS.md` Change Log entry recording the cutover
|
||||
+202
@@ -0,0 +1,202 @@
|
||||
# 07 — Fee research and recommended rate card
|
||||
|
||||
Authority: `AGENTS.md` §3 D8 (publish a full rate card) and D14 (two-tier
|
||||
structure, **pending Pouya's sign-off — Q14**).
|
||||
|
||||
**Nothing in this document publishes until Pouya confirms the figures.** These
|
||||
are researched recommendations, not decisions. This is business pricing
|
||||
information, not legal or financial advice.
|
||||
|
||||
Research date: 2026-08-26. All figures below are **plus HST** unless stated.
|
||||
|
||||
---
|
||||
|
||||
## The Ontario market, measured
|
||||
|
||||
### The regulated floor
|
||||
|
||||
Ontario's mandatory mediation tariff (Rule 24.1) sets the roster rate. ADR
|
||||
Chambers publishes it as **$600 to $825 depending on the number of parties**,
|
||||
covering *"one half hour of preparation time per party and up to three hours of
|
||||
mediation."*
|
||||
|
||||
This is the floor of the market, and it is a floor with a signal attached:
|
||||
pricing at or near it reads as roster-filler work.
|
||||
|
||||
### Published hourly bands
|
||||
|
||||
ADR Chambers, across its full roster:
|
||||
|
||||
| | Range |
|
||||
|---|---|
|
||||
| Mediators | **$150 – $750 / hour** *"depending on the experience of the mediator"* |
|
||||
| Arbitrators | **$250 – $800 / hour** |
|
||||
|
||||
Plus, on the arbitration side: an **$800 filing fee**, a **$800 venue fee** for a
|
||||
hearing room and one breakout room, and **$400** per additional room.
|
||||
|
||||
### Published practitioner rate cards
|
||||
|
||||
Four Ontario practitioners publishing real numbers:
|
||||
|
||||
| Practice | Half-day | Full day | Overtime | Notes |
|
||||
|---|---|---|---|---|
|
||||
| **Patey** — Tier 1, PI / insurance | $800 (3 h) | $1,200 (6 h) | $250 / h | Multi-party 3 h $1,200; multi-party full day $2,400; pro forma to 1.5 h $500 |
|
||||
| **Patey** — Tier 2, estate / employment / civil | $1,200 (3 h) | $2,400 (6 h) | $375 / h | Pre-mediation caucus $175 flat |
|
||||
| **Zuber** — video | $1,800 (3 h) | $2,800 (6 h) | $500 / h | +$500 per additional party |
|
||||
| **Zuber** — in person, GTA | — | $4,000 (6 h) | $500 / h | Eastern Ontario $3,500. Prep and travel included |
|
||||
| **Carroll** — Ottawa | $1,750 (incl. 1.5 h prep) | $3,000 (incl. 2 h prep) | $400 / h | Arbitration day rate $3,000 |
|
||||
|
||||
### What the shape of that data says
|
||||
|
||||
Three observations that drive the recommendation.
|
||||
|
||||
1. **The market is already segmented by matter type, not only by seniority.**
|
||||
Patey runs two published tiers off the same neutral. Insurance and PI work
|
||||
clears around $800–$1,200 a day; estate, employment, and civil work clears
|
||||
$2,400 for the same hours. This is the single most useful structural fact in
|
||||
the research.
|
||||
2. **Prep time is a pricing lever, disclosed differently by everyone.** Carroll
|
||||
bundles named hours (1.5 h and 2 h). Zuber bundles prep *and* travel. Patey
|
||||
bundles neither and sells a caucus separately. Bundling explicitly reads as
|
||||
more confident and removes an argument later.
|
||||
3. **Additional parties are always priced, never absorbed.** $300–$500 per party
|
||||
beyond two is the norm, and a four-party construction mediation is materially
|
||||
more work than a two-party one.
|
||||
|
||||
---
|
||||
|
||||
## Where this practice should sit
|
||||
|
||||
**Not at the floor.** Pouya's stack — JD, an operating role inside a litigation
|
||||
and ADR boutique, Q.Med held, Q.Arb commenced, and a working engineering career —
|
||||
is not a junior generalist profile. Entering at roster rates would anchor him
|
||||
into SABS volume work and make the commercial rate very hard to raise later.
|
||||
Published rates are close to unrecoverable once set: raising them looks
|
||||
opportunistic, discounting privately never becomes public knowledge.
|
||||
|
||||
**Not at the top either.** $4,000-a-day in-person GTA rates belong to neutrals
|
||||
with twenty years of name recognition. Asking that without an independent track
|
||||
record invites a comparison he loses.
|
||||
|
||||
**The position is the upper-middle: at or just above Patey Tier 2, just below
|
||||
Zuber and Carroll.** That reads as *credentialed and serious, priced to be taken
|
||||
seriously, not yet a marquee name* — which is exactly true.
|
||||
|
||||
---
|
||||
|
||||
## The confirmed rate card
|
||||
|
||||
**Set by Pouya on 2026-08-26 (D14). This is the card. Build `/fees/` from it.**
|
||||
|
||||
He declined the two-tier structure and set one rate for all mediation matters.
|
||||
All figures **plus HST**.
|
||||
|
||||
### Mediation — all matters, one rate
|
||||
|
||||
| Item | Fee |
|
||||
|---|---|
|
||||
| Half day — up to 3.5 h, including 2 h preparation | **$2,000** |
|
||||
| Full day — up to 7 h, including 3 h preparation | **$4,000** |
|
||||
| Each party beyond two | **$500** |
|
||||
| Overtime, per hour | **$500** |
|
||||
|
||||
### Arbitration
|
||||
|
||||
Available now as co-arbitrator; sole appointments follow the Q.Arb designation,
|
||||
commenced August 2026. The page must say so — see `03-content-spec.md`.
|
||||
|
||||
| Item | Fee |
|
||||
|---|---|
|
||||
| Hourly | **$500** |
|
||||
| Hearing day | **$4,000** |
|
||||
| Documents-only / expedited, flat — simple | **$6,500** |
|
||||
| Documents-only / expedited, flat — complex | **$9,500** |
|
||||
|
||||
**No tribunal-secretary rate.** Removed by Pouya. Do not reinstate it, and do not
|
||||
offer tribunal-secretary work on the site.
|
||||
|
||||
### Other services — hourly
|
||||
|
||||
Early neutral evaluation, settlement counsel, dispute-system design, and
|
||||
pre-dispute technical advisory: **$500 / hour**.
|
||||
|
||||
### Cancellation — adopted as recommended
|
||||
|
||||
| When | Fee |
|
||||
|---|---|
|
||||
| More than 30 days before | No fee. Disbursements only |
|
||||
| 15 – 30 days before | 50% of the booked fee |
|
||||
| Fewer than 15 days before | 100% of the booked fee |
|
||||
| Rescheduled with a new date fixed at the same time | No charge |
|
||||
| Reserved time filled by another matter of equal or greater value | Waived |
|
||||
|
||||
### Terms to state on the page
|
||||
|
||||
- All fees plus HST.
|
||||
- Shared equally between the parties unless they agree otherwise in writing.
|
||||
- Payable on rendering; interest on overdue accounts at 5% per annum.
|
||||
- **Video and in-person at the same rate.** Do not discount remote sessions —
|
||||
the preparation is identical, and discounting teaches the market that the
|
||||
session is the product.
|
||||
- Travel outside the GTA billed separately or bundled at a stated day rate.
|
||||
|
||||
### All parameters confirmed
|
||||
|
||||
Q15, Q16, and Q17 were closed on 2026-08-26. **Preparation time is bundled and
|
||||
must be stated on the page** — "including 2 hours of preparation", "including
|
||||
3 hours of preparation". Do not quietly fold it into the hours figure. At these
|
||||
rates, saying preparation is included is the selling point, not a footnote.
|
||||
|
||||
---
|
||||
|
||||
## Recorded dissent — for the 12-month review (R5)
|
||||
|
||||
Claude recommended a two-tier card; Pouya set a single rate. The reasoning is
|
||||
recorded here so the 12-month review has something to test against, not to
|
||||
re-open a settled decision.
|
||||
|
||||
**Where the single rate lands relative to the measured market:**
|
||||
|
||||
| Segment | Published market, full day | This card |
|
||||
|---|---|---|
|
||||
| Insurance / SABS / LAT | ~$1,200 – $2,400 | **$4,000** |
|
||||
| Commercial / civil / estate | ~$2,400 – $3,000 | **$4,000** |
|
||||
| Established GTA in person | ~$3,500 – $4,000 | **$4,000** |
|
||||
|
||||
$4,000 is at the ceiling of the published Ontario market — level with Zuber's
|
||||
in-person GTA rate, and roughly **three times** the going rate for the insurance
|
||||
and SABS segment.
|
||||
|
||||
**The consequence worth watching.** The strategy brief (§IV.7) identifies
|
||||
accident-benefits and LAT mediation as the highest realistic near-term volume,
|
||||
flowing directly from the firm's existing practice. At $4,000 a day that segment
|
||||
is priced out. This is a coherent choice — a premium specialist position that
|
||||
forgoes volume — **provided the volume was not being counted on.** If early
|
||||
appointment flow is slower than expected, the SABS tier is the first place to
|
||||
look, and reintroducing a second tier is a cleaner fix than cutting the headline
|
||||
rate.
|
||||
|
||||
**What makes the rate defensible.** $4,000 for a neutral who reads the contract,
|
||||
the code, and the System Impact Assessment is a fair price. $4,000 for a
|
||||
generalist is not. The rate and `/practice/technology/` are load-bearing for each
|
||||
other, which is an argument for shipping them in the same release — and for the
|
||||
Insights section carrying real technical depth rather than process explainers
|
||||
alone.
|
||||
|
||||
**One thing the single rate gets right.** Published rates are close to
|
||||
unrecoverable, and it is far easier to add a lower tier later than to raise a
|
||||
headline rate. Setting the ceiling first and discounting privately preserves
|
||||
more optionality than the reverse.
|
||||
|
||||
---
|
||||
|
||||
## Sources
|
||||
|
||||
- [ADR Chambers — Mediation Fees](https://adrchambers.com/mediation/fees/)
|
||||
- [ADR Chambers — Roster Rate / Mandatory Mediations](https://adrchambers.com/roster-rate-mediation/)
|
||||
- [ADR Chambers — Arbitration Fees](https://adrchambers.com/arbitration/fees/)
|
||||
- [Patey Mediations — Rates & Cancellation](https://pateymediations.com/rates/)
|
||||
- [Zuber Mediation — Fees](https://www.zubermediation.com/fees.html)
|
||||
- [Carroll Mediation — Rates & Cancellation](https://www.carrollmediation.ca/?page_id=16)
|
||||
- [O. Reg. 451/98 — Mediators' Fees (Rule 24.1)](https://www.canlii.org/en/on/laws/regu/o-reg-451-98/latest/o-reg-451-98.html)
|
||||
@@ -0,0 +1,32 @@
|
||||
{
|
||||
"name": "adr-smlcompany-ca",
|
||||
"version": "0.1.0",
|
||||
"private": true,
|
||||
"description": "The dispute resolution practice of Pouya Lajevardi — Toronto",
|
||||
"type": "module",
|
||||
"engines": { "node": ">=22" },
|
||||
"scripts": {
|
||||
"dev": "astro dev",
|
||||
"build": "astro build",
|
||||
"preview": "astro preview",
|
||||
"check": "astro check",
|
||||
"lint": "eslint . && prettier --check .",
|
||||
"format": "prettier --write .",
|
||||
"lighthouse": "lhci autorun"
|
||||
},
|
||||
"dependencies": {
|
||||
"astro": "^5.0.0",
|
||||
"@astrojs/mdx": "^4.0.0",
|
||||
"@astrojs/sitemap": "^3.2.0",
|
||||
"sharp": "^0.33.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@astrojs/check": "^0.9.0",
|
||||
"typescript": "^5.7.0",
|
||||
"prettier": "^3.4.0",
|
||||
"prettier-plugin-astro": "^0.14.0",
|
||||
"eslint": "^9.0.0",
|
||||
"eslint-plugin-astro": "^1.3.0",
|
||||
"@lhci/cli": "^0.14.0"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,9 @@
|
||||
# adr.smlcompany.ca
|
||||
# AI crawlers are deliberately allowed. Being read by an assistant that counsel
|
||||
# is using to shortlist a neutral is the point. See docs/04-seo-spec.md.
|
||||
|
||||
User-agent: *
|
||||
Allow: /
|
||||
Disallow: /legal/
|
||||
|
||||
Sitemap: https://adr.smlcompany.ca/sitemap-index.xml
|
||||
Executable
+62
@@ -0,0 +1,62 @@
|
||||
#!/usr/bin/env bash
|
||||
# ---------------------------------------------------------------------------
|
||||
# Collects the AWS resource identifiers this project needs (AGENTS.md Q10).
|
||||
# Read-only: every call is a list/describe. Nothing is created or changed.
|
||||
#
|
||||
# chmod +x scripts/aws-discover.sh
|
||||
# ./scripts/aws-discover.sh > aws-inventory.txt
|
||||
#
|
||||
# aws-inventory.txt contains NO secrets — only resource names and IDs — so it
|
||||
# is safe to share. It is gitignored anyway.
|
||||
# ---------------------------------------------------------------------------
|
||||
set -uo pipefail
|
||||
|
||||
hr() { printf '\n== %s %s\n' "$1" "$(printf '=%.0s' $(seq 1 $((60 - ${#1}))))"; }
|
||||
try() { "$@" 2>&1 || echo " (failed — check permissions or region)"; }
|
||||
|
||||
command -v aws >/dev/null || { echo "AWS CLI not installed. See AWS-Hosting-Guide.md Part 0.5"; exit 1; }
|
||||
|
||||
hr "Identity and default region"
|
||||
try aws sts get-caller-identity --output table
|
||||
echo "default region: $(aws configure get region || echo '(unset)')"
|
||||
|
||||
hr "S3 buckets -> which one holds the site?"
|
||||
try aws s3 ls
|
||||
|
||||
hr "CloudFront distributions -> Id, Aliases, Origin"
|
||||
try aws cloudfront list-distributions \
|
||||
--query "DistributionList.Items[].{Id:Id,Status:Status,Domain:DomainName,Aliases:join(',',Aliases.Items||[\`none\`]),Origin:Origins.Items[0].DomainName}" \
|
||||
--output table
|
||||
|
||||
hr "ACM certificates (us-east-1 — CloudFront certs live there)"
|
||||
try aws acm list-certificates --region us-east-1 \
|
||||
--query "CertificateSummaryList[].{Domain:DomainName,Status:Status,Arn:CertificateArn}" --output table
|
||||
|
||||
hr "API Gateway HTTP APIs -> the intake endpoint"
|
||||
try aws apigatewayv2 get-apis \
|
||||
--query "Items[].{Name:Name,ApiId:ApiId,Endpoint:ApiEndpoint,Protocol:ProtocolType}" --output table
|
||||
|
||||
hr "Lambda functions"
|
||||
try aws lambda list-functions \
|
||||
--query "Functions[].{Name:FunctionName,Runtime:Runtime,Modified:LastModified}" --output table
|
||||
|
||||
hr "DynamoDB tables"
|
||||
try aws dynamodb list-tables --output table
|
||||
|
||||
hr "SES verified identities"
|
||||
try aws sesv2 list-email-identities \
|
||||
--query "EmailIdentities[].{Identity:IdentityName,Type:IdentityType,Verified:VerifiedForSendingStatus}" --output table
|
||||
|
||||
hr "S3 versioning on each bucket (rollback depends on this)"
|
||||
for b in $(aws s3api list-buckets --query 'Buckets[].Name' --output text 2>/dev/null); do
|
||||
printf ' %-45s %s\n' "$b" "$(aws s3api get-bucket-versioning --bucket "$b" --query 'Status' --output text 2>/dev/null || echo '?')"
|
||||
done
|
||||
|
||||
hr "Done"
|
||||
cat <<'NOTE'
|
||||
Send back:
|
||||
* the S3 bucket that holds the site
|
||||
* the CloudFront distribution Id whose Aliases include adr.smlcompany.ca
|
||||
* the default region, and the region of the DynamoDB table
|
||||
* the API Gateway Endpoint for the intake API
|
||||
NOTE
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 73 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 349 KiB |
@@ -0,0 +1,42 @@
|
||||
import { defineCollection, z } from 'astro:content';
|
||||
import { PRACTICE_AREAS } from '../data/site';
|
||||
|
||||
const practiceSlugs = PRACTICE_AREAS.map((a) => a.slug) as [string, ...string[]];
|
||||
|
||||
/**
|
||||
* Insights. Content territories are set by the strategy brief §VII and
|
||||
* restated in docs/03-content-spec.md.
|
||||
*
|
||||
* Every piece must link to at least one practice-area page — that is what
|
||||
* turns the blog into ranking power for the pages that convert.
|
||||
*/
|
||||
const insights = defineCollection({
|
||||
type: 'content',
|
||||
schema: ({ image }) =>
|
||||
z.object({
|
||||
title: z.string().max(70),
|
||||
description: z.string().min(70).max(160), // doubles as the meta description
|
||||
publishDate: z.date(),
|
||||
updatedDate: z.date().optional(),
|
||||
topic: z.enum([
|
||||
'process-explainer',
|
||||
'regulatory-commentary',
|
||||
'industry-commentary',
|
||||
'reflection',
|
||||
'technical-explainer',
|
||||
'credentialing',
|
||||
]),
|
||||
practiceAreas: z.array(z.enum(practiceSlugs)).min(1),
|
||||
image: image().optional(),
|
||||
imageAlt: z.string().optional(),
|
||||
/** Drafts are excluded from the build, the index, and the sitemap. */
|
||||
draft: z.boolean().default(true),
|
||||
/**
|
||||
* Every article is reviewed by Pouya before publication (AGENTS.md D9).
|
||||
* An article with draft:false and reviewedByPouya:false is a bug.
|
||||
*/
|
||||
reviewedByPouya: z.boolean().default(false),
|
||||
}),
|
||||
});
|
||||
|
||||
export const collections = { insights };
|
||||
@@ -0,0 +1,161 @@
|
||||
/**
|
||||
* Site-wide constants.
|
||||
*
|
||||
* Anything marked TODO(pouya) is an unanswered question in AGENTS.md §9.
|
||||
* Do not guess a value to make the build pass — an unanswered question is
|
||||
* supposed to be visible. See CLAUDE.md.
|
||||
*/
|
||||
|
||||
export const SITE = {
|
||||
name: 'Pouya Lajevardi',
|
||||
tagline: 'Mediation · Arbitration · Toronto',
|
||||
url: 'https://adr.smlcompany.ca',
|
||||
locale: 'en_CA',
|
||||
entity: 'SML Company Ltd. · Ontario, Canada',
|
||||
} as const;
|
||||
|
||||
/**
|
||||
* Verified credentials only — mirrors AGENTS.md §4.
|
||||
* Adding a line here without adding it there is a bug.
|
||||
*
|
||||
* D13: the site asserts the JD and makes NO licensure claim. Do not add
|
||||
* 'lawyer', 'called to the bar', 'licensed', or any post-nominal implying a
|
||||
* licence — and do not imply it either. See AGENTS.md §4 Forbidden.
|
||||
*/
|
||||
export const CREDENTIALS = {
|
||||
designations: ['Q.Med (ADRIC / ADRIO)'],
|
||||
inProgress: ['Q.Arb — commenced August 2026'], // [verified 2026-08-26]
|
||||
goal: 'C.Med-Arb (Chartered Mediator-Arbitrator)',
|
||||
education: ['JD, Bond University'],
|
||||
certifications: [
|
||||
'Kompass Arbitration Certificate Program',
|
||||
'Stitt Feld Handy — negotiation and ADR workshop series',
|
||||
],
|
||||
languages: ['English', 'Farsi'],
|
||||
/** [verified 2026-08-26]. NOT OCNI (lapsed) and NOT the Law Society —
|
||||
* listing the LSO implies licensure, which D13 bars. Do not add either. */
|
||||
memberships: [
|
||||
'ADR Institute of Canada (ADRIC)',
|
||||
'ADR Institute of Ontario (ADRIO)',
|
||||
'Ontario Bar Association — Construction & Infrastructure, ADR, and Civil Litigation sections',
|
||||
],
|
||||
} as const;
|
||||
|
||||
/** The three credential slots. Never matter counts — AGENTS.md §4. */
|
||||
export const CREDENTIAL_ROW = [
|
||||
{ value: 'Q.Med', label: 'ADRIC / ADRIO designation' },
|
||||
{ value: 'JD + ML', label: 'Law and engineering' },
|
||||
{ value: 'EN · FA', label: 'Bilingual practice' },
|
||||
] as const;
|
||||
|
||||
/**
|
||||
* The Toronto boutique is NEVER named — AGENTS.md D16. Use this string.
|
||||
* Do not infer a name from an email domain or anywhere else.
|
||||
*/
|
||||
export const BOUTIQUE = 'a Toronto litigation and ADR boutique' as const;
|
||||
|
||||
/** Analytics: privacy-first and cookieless (D15). No GA4, no consent banner. */
|
||||
export const ANALYTICS = {
|
||||
provider: 'plausible' as 'plausible' | 'fathom' | null,
|
||||
domain: 'adr.smlcompany.ca',
|
||||
} as const;
|
||||
|
||||
export const CONTACT = {
|
||||
email: 'info@smlcompany.ca', // [verified 2026-08-26]
|
||||
/** No public phone by choice. Render 'By scheduled call' wherever a number
|
||||
* would go — do not leave the field visually empty. */
|
||||
phone: null as string | null, // [verified 2026-08-26]
|
||||
phoneFallback: 'By scheduled call',
|
||||
location: 'Toronto · Ontario · By appointment',
|
||||
responseTime: 'Inquiries are answered within one business day.',
|
||||
linkedin: 'https://www.linkedin.com/in/pouyalajevardi/', // [verified 2026-08-26]
|
||||
/** Booking parked 2026-08-26 (AGENTS.md R6). Build /contact/ with the intake
|
||||
* form and a reserved slot so an embed drops in later without a rebuild. */
|
||||
bookingUrl: null as string | null,
|
||||
} as const;
|
||||
|
||||
/** Portrait assets. Astro derives AVIF/WebP variants from the master at build. */
|
||||
export const PORTRAIT = {
|
||||
master: 'src/assets/pouya-lajevardi.jpg', // 1600x1600
|
||||
og: 'src/assets/og-portrait.jpg', // 1200x630, cropped high
|
||||
alt: 'Pouya Lajevardi',
|
||||
} as const;
|
||||
|
||||
/** Shown on /contact/ and with the booking embed. Do not reword casually. */
|
||||
export const NO_RETAINER_NOTICE =
|
||||
'Submitting this form does not create a retainer, does not appoint a neutral, ' +
|
||||
'and does not itself establish a mediator–party relationship.';
|
||||
|
||||
/**
|
||||
* Rate card — AGENTS.md D14, confirmed by Pouya 2026-08-26.
|
||||
* One rate for all mediation matters. All figures PLUS HST.
|
||||
* Full research and reasoning: docs/07-fees.md
|
||||
*/
|
||||
export const FEES = {
|
||||
currency: 'CAD',
|
||||
taxNote: 'All fees are plus HST.',
|
||||
mediation: {
|
||||
/** Prep is bundled AND stated on the page — [verified 2026-08-26].
|
||||
* Do not hide it: at these rates, saying preparation is included is the
|
||||
* point, not a detail. */
|
||||
halfDay: { amount: 2000, hours: 3.5, prepIncluded: 2 },
|
||||
fullDay: { amount: 4000, hours: 7, prepIncluded: 3 },
|
||||
additionalParty: 500, // each party beyond two
|
||||
overtimePerHour: 500, // [verified 2026-08-26]
|
||||
},
|
||||
arbitration: {
|
||||
perHour: 500,
|
||||
hearingDay: 4000,
|
||||
documentsOnlySimple: 6500, // flat
|
||||
documentsOnlyComplex: 9500, // flat
|
||||
// No tribunal-secretary rate — removed by Pouya 2026-08-26.
|
||||
},
|
||||
// ENE, settlement counsel, dispute-system design, pre-dispute technical advisory
|
||||
hourly: 500, // [verified 2026-08-26]
|
||||
cancellation: [
|
||||
{ window: 'More than 30 days before', fee: 'No fee. Disbursements only.' },
|
||||
{ window: '15 to 30 days before', fee: '50% of the booked fee.' },
|
||||
{ window: 'Fewer than 15 days before', fee: '100% of the booked fee.' },
|
||||
],
|
||||
cancellationNotes: [
|
||||
'Rescheduling at the time of cancellation, with a new date fixed, is not charged.',
|
||||
'The cancellation fee is waived if the reserved time is filled by another matter of equal or greater value.',
|
||||
],
|
||||
terms: [
|
||||
'Fees are shared equally between the parties unless they agree otherwise in writing.',
|
||||
'Accounts are payable on rendering. Interest accrues on overdue accounts at 5% per annum.',
|
||||
'Video and in-person sessions are charged at the same rate.',
|
||||
],
|
||||
} as const;
|
||||
|
||||
export const PRACTICE_AREAS = [
|
||||
{ slug: 'construction', name: 'Construction & Infrastructure', chip: 'Construction' },
|
||||
{ slug: 'technology', name: 'Technology, AI & Data', chip: 'Technology' },
|
||||
{ slug: 'energy', name: 'Energy, Grid & Regulatory', chip: 'Energy' },
|
||||
{ slug: 'insurance', name: 'Insurance, SABS & LAT', chip: 'Insurance' },
|
||||
{ slug: 'shareholder', name: 'Shareholder & Family Business', chip: 'Shareholder' },
|
||||
{ slug: 'cross-cultural', name: 'Cross-Border & Diaspora', chip: 'Cross-cultural' },
|
||||
] as const;
|
||||
|
||||
/** Seven items is the ceiling before a nav stops being scannable. */
|
||||
export const PRIMARY_NAV = [
|
||||
{ href: '/about/', label: 'About' },
|
||||
{ href: '/mediation/', label: 'Mediation' },
|
||||
{ href: '/arbitration/', label: 'Arbitration' },
|
||||
{ href: '/practice/', label: 'Practice', children: PRACTICE_AREAS },
|
||||
{ href: '/fees/', label: 'Fees' },
|
||||
{ href: '/insights/', label: 'Insights' },
|
||||
{ href: '/contact/', label: 'Contact' },
|
||||
] as const;
|
||||
|
||||
/** Linked contextually rather than from the primary nav. */
|
||||
export const SECONDARY_NAV = [
|
||||
{ href: '/process/', label: 'How I work' },
|
||||
{ href: '/med-arb/', label: 'Med-Arb' },
|
||||
{ href: '/for-parties/', label: 'For parties' },
|
||||
] as const;
|
||||
|
||||
export const LEGAL_NAV = [
|
||||
{ href: '/legal/privacy/', label: 'Privacy' },
|
||||
{ href: '/legal/terms/', label: 'Terms' },
|
||||
] as const;
|
||||
@@ -0,0 +1,192 @@
|
||||
/* ============================================================================
|
||||
Global base. Spec: docs/02-design-system.md
|
||||
========================================================================= */
|
||||
|
||||
@import './tokens.css';
|
||||
|
||||
/* --- Fonts: self-hosted, subset, swap. No runtime Google Fonts request. ----
|
||||
TODO(claude-code): place subset woff2 files in /public/fonts/ and preload
|
||||
Instrument Serif 400 and Geist 400 in BaseLayout — they are the only two
|
||||
faces used above the fold. */
|
||||
|
||||
@font-face {
|
||||
font-family: 'Instrument Serif';
|
||||
src: url('/fonts/instrument-serif-400.woff2') format('woff2');
|
||||
font-weight: 400; font-style: normal; font-display: swap;
|
||||
unicode-range: U+0000-00FF, U+0100-017F, U+2000-206F, U+2190-21BB;
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'Instrument Serif';
|
||||
src: url('/fonts/instrument-serif-400-italic.woff2') format('woff2');
|
||||
font-weight: 400; font-style: italic; font-display: swap;
|
||||
unicode-range: U+0000-00FF, U+0100-017F, U+2000-206F;
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'Geist';
|
||||
src: url('/fonts/geist-variable.woff2') format('woff2-variations');
|
||||
font-weight: 300 600; font-style: normal; font-display: swap;
|
||||
unicode-range: U+0000-00FF, U+0100-017F, U+2000-206F, U+2190-21BB;
|
||||
}
|
||||
@font-face {
|
||||
font-family: 'Geist Mono';
|
||||
src: url('/fonts/geist-mono-variable.woff2') format('woff2-variations');
|
||||
font-weight: 400 500; font-style: normal; font-display: swap;
|
||||
unicode-range: U+0000-00FF, U+2000-206F;
|
||||
}
|
||||
|
||||
/* --- Reset ---------------------------------------------------------------- */
|
||||
|
||||
*, *::before, *::after { box-sizing: border-box; }
|
||||
* { margin: 0; }
|
||||
|
||||
html {
|
||||
-webkit-text-size-adjust: 100%;
|
||||
scroll-behavior: smooth;
|
||||
scroll-padding-top: var(--space-8);
|
||||
}
|
||||
|
||||
body {
|
||||
background: var(--bg);
|
||||
color: var(--text);
|
||||
font-family: var(--font-sans);
|
||||
font-size: var(--text-base);
|
||||
font-weight: var(--weight-normal);
|
||||
line-height: var(--leading-body);
|
||||
-webkit-font-smoothing: antialiased;
|
||||
-moz-osx-font-smoothing: grayscale;
|
||||
text-rendering: optimizeLegibility;
|
||||
overflow-x: hidden;
|
||||
min-height: 100vh;
|
||||
}
|
||||
|
||||
img, picture, video, canvas, svg { display: block; max-width: 100%; }
|
||||
img { height: auto; }
|
||||
input, button, textarea, select { font: inherit; color: inherit; }
|
||||
p, h1, h2, h3, h4, h5, h6 { overflow-wrap: break-word; }
|
||||
ul[role='list'], ol[role='list'] { list-style: none; padding: 0; }
|
||||
|
||||
/* --- Type ----------------------------------------------------------------- */
|
||||
|
||||
h1, h2, h3, h4 { font-weight: var(--weight-normal); text-wrap: balance; }
|
||||
|
||||
.display {
|
||||
font-family: var(--font-serif);
|
||||
font-weight: var(--weight-normal);
|
||||
line-height: var(--leading-display);
|
||||
letter-spacing: var(--tracking-display);
|
||||
}
|
||||
/* The one flourish the design allows. One italic phrase per headline, max. */
|
||||
.display .it { font-style: italic; }
|
||||
|
||||
.eyebrow {
|
||||
font-family: var(--font-mono);
|
||||
font-size: var(--text-xs);
|
||||
font-weight: var(--weight-medium);
|
||||
letter-spacing: var(--tracking-eyebrow);
|
||||
text-transform: uppercase;
|
||||
color: var(--text-meta);
|
||||
}
|
||||
/* An eyebrow is a label, never the page's heading element. */
|
||||
.eyebrow .dot {
|
||||
display: inline-block;
|
||||
inline-size: 6px; block-size: 6px;
|
||||
border-radius: 50%;
|
||||
background: var(--accent);
|
||||
margin-inline-end: var(--space-3);
|
||||
vertical-align: 0.15em;
|
||||
}
|
||||
|
||||
p { max-inline-size: var(--width-prose); }
|
||||
|
||||
a { color: var(--link); text-decoration-thickness: 1px; text-underline-offset: 0.2em; }
|
||||
a:hover { color: var(--accent-hover); }
|
||||
|
||||
/* --- Focus: visible, always. The previous build removed it globally. ------- */
|
||||
|
||||
:focus-visible {
|
||||
outline: 2px solid var(--focus-ring);
|
||||
outline-offset: 3px;
|
||||
border-radius: var(--radius-sm);
|
||||
}
|
||||
:focus:not(:focus-visible) { outline: none; }
|
||||
|
||||
.skip-link {
|
||||
position: absolute;
|
||||
inset-block-start: var(--space-2);
|
||||
inset-inline-start: var(--space-2);
|
||||
z-index: var(--z-skip);
|
||||
padding: var(--space-3) var(--space-5);
|
||||
background: var(--accent);
|
||||
color: var(--text-inverse);
|
||||
border-radius: var(--radius-md);
|
||||
transform: translateY(-200%);
|
||||
transition: transform var(--dur-fast) var(--ease);
|
||||
}
|
||||
.skip-link:focus { transform: translateY(0); }
|
||||
|
||||
::selection { background: var(--accent); color: var(--text-inverse); }
|
||||
|
||||
/* --- Layout --------------------------------------------------------------- */
|
||||
|
||||
.wrap { inline-size: 100%; max-inline-size: var(--width-content); margin-inline: auto; padding-inline: var(--gutter); }
|
||||
.wrap-wide { max-inline-size: var(--width-wide); }
|
||||
.prose { max-inline-size: var(--width-prose); }
|
||||
.section { padding-block: var(--section-y); }
|
||||
.section-alt { background: var(--bg-alt); }
|
||||
.section-inverse { background: var(--bg-inverse); color: var(--text-inverse); }
|
||||
.section-inverse .eyebrow,
|
||||
.section-inverse .text-meta { color: var(--text-inverse-2); }
|
||||
|
||||
hr { border: none; border-block-start: 1px solid var(--border); }
|
||||
.rule-gold { border: none; border-block-start: 1px solid var(--rule); }
|
||||
|
||||
.visually-hidden {
|
||||
position: absolute; inline-size: 1px; block-size: 1px;
|
||||
padding: 0; margin: -1px; overflow: hidden;
|
||||
clip-path: inset(50%); white-space: nowrap; border: 0;
|
||||
}
|
||||
|
||||
/* --- Reveal ---------------------------------------------------------------
|
||||
Progressive enhancement, not a dependency. Content is rendered and visible
|
||||
in the HTML; `.reveal` only takes effect once JS adds `js-reveal` to <html>.
|
||||
If the observer never runs, every page reads normally. The previous build
|
||||
had this backwards and shipped a blank page to anything without JS. */
|
||||
|
||||
.js-reveal .reveal { opacity: 0; transform: translateY(20px); }
|
||||
.js-reveal .reveal.is-in {
|
||||
opacity: 1; transform: none;
|
||||
transition: opacity var(--dur-reveal) var(--ease), transform var(--dur-reveal) var(--ease);
|
||||
}
|
||||
.js-reveal .reveal-stagger > * { opacity: 0; transform: translateY(16px); }
|
||||
.js-reveal .reveal-stagger.is-in > * {
|
||||
opacity: 1; transform: none;
|
||||
transition: opacity var(--dur-reveal) var(--ease), transform var(--dur-reveal) var(--ease);
|
||||
}
|
||||
.js-reveal .reveal-stagger.is-in > *:nth-child(1) { transition-delay: 0ms; }
|
||||
.js-reveal .reveal-stagger.is-in > *:nth-child(2) { transition-delay: 70ms; }
|
||||
.js-reveal .reveal-stagger.is-in > *:nth-child(3) { transition-delay: 140ms; }
|
||||
.js-reveal .reveal-stagger.is-in > *:nth-child(4) { transition-delay: 210ms; }
|
||||
.js-reveal .reveal-stagger.is-in > *:nth-child(5) { transition-delay: 280ms; }
|
||||
.js-reveal .reveal-stagger.is-in > *:nth-child(6) { transition-delay: 350ms; }
|
||||
/* Stagger caps at six children by design. */
|
||||
|
||||
@media (prefers-reduced-motion: reduce) {
|
||||
html { scroll-behavior: auto; }
|
||||
*, *::before, *::after {
|
||||
animation-duration: 0.01ms !important;
|
||||
animation-iteration-count: 1 !important;
|
||||
transition-duration: 0.01ms !important;
|
||||
scroll-behavior: auto !important;
|
||||
}
|
||||
.js-reveal .reveal,
|
||||
.js-reveal .reveal-stagger > * { opacity: 1 !important; transform: none !important; }
|
||||
}
|
||||
|
||||
/* --- Print: the About page will be printed by people evaluating an appointment */
|
||||
|
||||
@media print {
|
||||
body { background: #fff; color: #000; font-size: 11pt; }
|
||||
.site-header, .site-footer, .skip-link, .no-print { display: none !important; }
|
||||
a[href^='http']::after { content: ' (' attr(href) ')'; font-size: 9pt; }
|
||||
.section { padding-block: var(--space-5); }
|
||||
}
|
||||
@@ -0,0 +1,144 @@
|
||||
/* ============================================================================
|
||||
Design tokens — the single source of colour, type, space, and motion.
|
||||
Spec: docs/02-design-system.md
|
||||
|
||||
Never write a raw hex value or a magic number in a component. If a value is
|
||||
missing here, add it here.
|
||||
========================================================================= */
|
||||
|
||||
:root {
|
||||
/* --- Colour ------------------------------------------------------------
|
||||
Palette carried over unchanged from the previous build (AGENTS.md D7).
|
||||
Contrast ratios measured 2026-08-25 and recorded in docs/02. */
|
||||
|
||||
--cream: #faf7f2; /* page background */
|
||||
--cream-2: #f3ede0; /* alternating section background */
|
||||
--cream-3: #ebe3d1; /* cards and insets on cream */
|
||||
|
||||
--ink: #1a1614; /* body text; dark section backgrounds 16.81:1 */
|
||||
--ink-soft: #3a322c; /* secondary text 11.75:1 */
|
||||
--muted: #6e6359; /* metadata — ON CREAM ONLY (3.07:1 on ink) */
|
||||
|
||||
--maroon: #5a1a1c; /* primary action, dark panels 12.29:1 */
|
||||
--maroon-d: #3d1112; /* hover on maroon */
|
||||
--maroon-l: #7a2a2c; /* links on cream 8.95:1 */
|
||||
|
||||
/* GOLD IS NOT A TEXT COLOUR ON CREAM.
|
||||
--gold on cream measures 2.10:1 and fails AA for body AND large text.
|
||||
--gold-d measures 3.11:1 — large decorative text only, 24px+.
|
||||
Both are fine on --ink (8.00) and --maroon (5.84). See docs/02. */
|
||||
--gold: #c9a876; /* rules, dividers, icon strokes, on-dark text */
|
||||
--gold-d: #a88858; /* large decorative display text on cream only */
|
||||
--gold-l: #e2c89a; /* text on ink or maroon 11.09:1 */
|
||||
|
||||
--line: rgb(26 22 20 / 0.10);
|
||||
--line-2: rgb(26 22 20 / 0.06);
|
||||
--line-dark: rgb(250 247 242 / 0.14);
|
||||
|
||||
/* Semantic aliases — prefer these in components over raw palette names. */
|
||||
--bg: var(--cream);
|
||||
--bg-alt: var(--cream-2);
|
||||
--bg-raised: var(--cream-3);
|
||||
--bg-inverse: var(--ink);
|
||||
--text: var(--ink);
|
||||
--text-secondary: var(--ink-soft);
|
||||
--text-meta: var(--muted);
|
||||
--text-inverse: var(--cream);
|
||||
--text-inverse-2: var(--gold-l);
|
||||
--accent: var(--maroon);
|
||||
--accent-hover: var(--maroon-d);
|
||||
--link: var(--maroon-l);
|
||||
--rule: var(--gold);
|
||||
--border: var(--line);
|
||||
--focus-ring: var(--maroon);
|
||||
|
||||
/* --- Type -------------------------------------------------------------- */
|
||||
|
||||
--font-serif: 'Instrument Serif', 'Cormorant Garamond', Georgia, 'Times New Roman', serif;
|
||||
--font-sans: 'Geist', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
|
||||
--font-mono: 'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
|
||||
|
||||
/* Fluid scale, 360px → 1600px viewport. Ratio widens toward the display
|
||||
end (1.25 → 1.333) so headlines scale harder than body copy. */
|
||||
--text-xs: 0.75rem; /* 12 — legal */
|
||||
--text-sm: 0.875rem; /* 14 — meta */
|
||||
--text-base: 1rem; /* 16 — body */
|
||||
--text-lg: clamp(1.0625rem, 0.99rem + 0.32vw, 1.1875rem); /* 17→19 */
|
||||
--text-xl: clamp(1.25rem, 1.14rem + 0.48vw, 1.5rem); /* 20→24 */
|
||||
--text-2xl: clamp(1.5rem, 1.31rem + 0.81vw, 1.875rem); /* 24→30 */
|
||||
--text-3xl: clamp(1.875rem, 1.55rem + 1.37vw, 2.5rem); /* 30→40 */
|
||||
--text-4xl: clamp(2.25rem, 1.66rem + 2.50vw, 3.5rem); /* 36→56 */
|
||||
--text-5xl: clamp(2.75rem, 1.75rem + 4.25vw, 4.75rem); /* 44→76 */
|
||||
--text-6xl: clamp(3.25rem, 1.75rem + 6.35vw, 6rem); /* 52→96 */
|
||||
|
||||
--leading-display: 0.98;
|
||||
--leading-tight: 1.15;
|
||||
--leading-snug: 1.35;
|
||||
--leading-body: 1.6;
|
||||
--leading-relaxed: 1.75;
|
||||
|
||||
--tracking-display: -0.02em;
|
||||
--tracking-tight: -0.01em;
|
||||
--tracking-normal: 0;
|
||||
--tracking-wide: 0.06em;
|
||||
--tracking-eyebrow: 0.18em;
|
||||
|
||||
--weight-light: 300;
|
||||
--weight-normal: 400;
|
||||
--weight-medium: 500;
|
||||
--weight-semi: 600;
|
||||
|
||||
/* --- Space — 8px base -------------------------------------------------- */
|
||||
|
||||
--space-1: 0.25rem; /* 4 */
|
||||
--space-2: 0.5rem; /* 8 */
|
||||
--space-3: 0.75rem; /* 12 */
|
||||
--space-4: 1rem; /* 16 */
|
||||
--space-5: 1.5rem; /* 24 */
|
||||
--space-6: 2rem; /* 32 */
|
||||
--space-7: 3rem; /* 48 */
|
||||
--space-8: 4rem; /* 64 */
|
||||
--space-9: 6rem; /* 96 */
|
||||
--space-10: 8rem; /* 128 */
|
||||
--space-11: 10rem; /* 160 */
|
||||
|
||||
--section-y: clamp(var(--space-9), 6vw + 2rem, var(--space-11));
|
||||
|
||||
/* --- Layout ------------------------------------------------------------ */
|
||||
|
||||
--width-content: 80rem; /* 1280 */
|
||||
--width-wide: 90rem; /* 1440 */
|
||||
--width-prose: 68ch; /* reading measure — never exceed for body copy */
|
||||
--gutter: var(--space-5);
|
||||
--gutter-lg: var(--space-7);
|
||||
|
||||
/* --- Radius, elevation, motion ----------------------------------------- */
|
||||
|
||||
--radius-sm: 4px;
|
||||
--radius-md: 8px;
|
||||
--radius-lg: 16px;
|
||||
--radius-full: 999px;
|
||||
|
||||
--shadow-sm: 0 1px 2px rgb(26 22 20 / 0.04);
|
||||
--shadow-md: 0 4px 16px rgb(26 22 20 / 0.06);
|
||||
--shadow-lg: 0 12px 40px rgb(26 22 20 / 0.10);
|
||||
|
||||
--ease: cubic-bezier(0.2, 0.7, 0.2, 1);
|
||||
--ease-out: cubic-bezier(0.16, 1, 0.3, 1);
|
||||
--dur-fast: 150ms;
|
||||
--dur-hover: 250ms;
|
||||
--dur-reveal: 600ms;
|
||||
|
||||
--z-base: 0;
|
||||
--z-sticky: 100;
|
||||
--z-header: 200;
|
||||
--z-overlay: 300;
|
||||
--z-skip: 400;
|
||||
}
|
||||
|
||||
@media (min-width: 48rem) {
|
||||
:root { --gutter: var(--gutter-lg); }
|
||||
}
|
||||
|
||||
/* No dark mode by design (docs/02). A single committed light identity is the
|
||||
right call for a legal practice and halves the ways contrast can break. */
|
||||
@@ -0,0 +1,16 @@
|
||||
{
|
||||
"extends": "astro/tsconfigs/strict",
|
||||
"compilerOptions": {
|
||||
"strictNullChecks": true,
|
||||
"allowJs": true,
|
||||
"baseUrl": ".",
|
||||
"paths": {
|
||||
"@components/*": ["src/components/*"],
|
||||
"@layouts/*": ["src/layouts/*"],
|
||||
"@styles/*": ["src/styles/*"],
|
||||
"@data/*": ["src/data/*"]
|
||||
}
|
||||
},
|
||||
"include": [".astro/types.d.ts", "**/*"],
|
||||
"exclude": ["dist", "node_modules"]
|
||||
}
|
||||
Reference in New Issue
Block a user