diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index f6859bf2..5c5d7873 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -84,7 +84,7 @@ this order: explicit args → env (`AAASM_GATEWAY_URL` / `AAASM_API_KEY`) →
 - **Branch:** `<release-or-phase>/<ticket>/<type>/<short_summary>`
   (e.g. `v0.0.1/AAASM-42/feat/add_langchain_adapter`).
 - **PR title:** `[<ticket>] <emoji> (<scope>): <summary>`; base branch **always
-  `master`**; body follows `.github/pull_request_template.md`; ≥1 Pioneer-team
+  `main`**; body follows `.github/pull_request_template.md`; ≥1 Pioneer-team
   approval.
 
 ## Repo-specific gotchas
@@ -93,7 +93,7 @@ this order: explicit args → env (`AAASM_GATEWAY_URL` / `AAASM_API_KEY`) →
   has confirmed MIT for this SDK twice. The `LICENSE`, the PyPI classifier, and the
   README badge are all intentionally MIT — **do not "fix" it** to Apache.
 - **Push remote is `remote`** (→ `ai-agent-assembly/python-sdk`, canonical), not
-  `origin` (a personal fork). Scope changes against `remote/master`, which is often
+  `origin` (a personal fork). Scope changes against `remote/main`, which is often
   ahead of a fork checkout. The "This repository moved"
   (old-uppercase→`ai-agent-assembly`) redirect notice on push is harmless.
 - **Docs-only PRs run NO CI.** `ci.yaml`'s `pull_request.paths` allow-list covers
diff --git a/.claude/skills/release-runbook/SKILL.md b/.claude/skills/release-runbook/SKILL.md
index e7ffc6c6..f91f0248 100644
--- a/.claude/skills/release-runbook/SKILL.md
+++ b/.claude/skills/release-runbook/SKILL.md
@@ -222,7 +222,7 @@ authoritative checker.)
 
 ## Pre-conditions
 
-- Canonical remote is `remote` (not `origin`); dispatch against `--ref master`.
+- Canonical remote is `remote` (not `origin`); dispatch against `--ref main`.
 - For Path B, `pypi_version` must be a **higher** PEP 440 version than the latest
   on PyPI, and `binary_source_tag` must be an existing `agent-assembly` tag with
   published `aasm-*` assets for all four platforms.
diff --git a/.claude/skills/sdk-only-release/EXAMPLES.md b/.claude/skills/sdk-only-release/EXAMPLES.md
index 2aa57c3e..3063591d 100644
--- a/.claude/skills/sdk-only-release/EXAMPLES.md
+++ b/.claude/skills/sdk-only-release/EXAMPLES.md
@@ -14,7 +14,7 @@ prior coordinated release.
 ```bash
 gh workflow run release-python.yml \
   --repo ai-agent-assembly/python-sdk \
-  --ref master \
+  --ref main \
   -f pypi_version=0.0.1a9.post1 \
   -f binary_source_tag=v0.0.1-alpha.9 \
   -f dry-run=true
@@ -46,7 +46,7 @@ filenames + sizes, and authorises the real publish.
 ```bash
 gh workflow run release-python.yml \
   --repo ai-agent-assembly/python-sdk \
-  --ref master \
+  --ref main \
   -f pypi_version=0.0.1a9.post1 \
   -f binary_source_tag=v0.0.1-alpha.9 \
   -f dry-run=false
@@ -109,7 +109,7 @@ If no PR is listed, the upstream `update-python-sdk-ffi-pin` job (AAASM-2883) ha
 ```bash
 gh workflow run release-python.yml \
   --repo ai-agent-assembly/python-sdk \
-  --ref master \
+  --ref main \
   -f pypi_version=0.0.1b3 \
   -f binary_source_tag=v0.0.1-beta.3 \
   -f dry-run=true
diff --git a/.claude/skills/sdk-only-release/SKILL.md b/.claude/skills/sdk-only-release/SKILL.md
index f1545375..5433534c 100644
--- a/.claude/skills/sdk-only-release/SKILL.md
+++ b/.claude/skills/sdk-only-release/SKILL.md
@@ -91,13 +91,13 @@ metadata only. Always `grep -rn` the outgoing version across `agent_assembly/**`
 
 ## How to use
 
-Invoke `release-python.yml` via `workflow_dispatch` against `master`, three
+Invoke `release-python.yml` via `workflow_dispatch` against `main`, three
 input axes:
 
 ```bash
 gh workflow run release-python.yml \
   --repo ai-agent-assembly/python-sdk \
-  --ref master \
+  --ref main \
   -f pypi_version=<X> \
   -f binary_source_tag=<Y> \
   -f dry-run=true
@@ -125,7 +125,7 @@ semantics, the strict regex, and Trusted-Publisher auth are in
    `aasm-*.tar.gz` assets for all four platforms
    (`gh release view <tag> --repo ai-agent-assembly/agent-assembly`).
 3. The operator ran `dry-run=true` first and reviewed resolve output + wheels.
-4. The `--ref` dispatched against is `master`.
+4. The `--ref` dispatched against is `main`.
 
 ## Executable plan
 
diff --git a/.github/workflows/benchmarks.yml b/.github/workflows/benchmarks.yml
index 9c5431c9..1454076e 100644
--- a/.github/workflows/benchmarks.yml
+++ b/.github/workflows/benchmarks.yml
@@ -6,7 +6,7 @@ on:
     # so benchmarks stay off the default per-PR path (noisy on shared runners).
     types: [labeled]
     branches:
-      - "master"
+      - "main"
     paths:
       - "agent_assembly/**/*.py"
       - "test/bench/**/*.py"
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index b1b84689..6ba3b2b5 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -5,7 +5,7 @@ on:
   # For the push event, it only runs building and testing.
   push:
     branches:
-      - "master"
+      - "main"
       - "!**e2e"
       - "!e2e**"
     paths:
@@ -32,7 +32,7 @@ on:
   # or other checking, i.e., record the test report by CodeCov and check the code quality by SonarQube.
   pull_request:
     branches:
-      - "master"
+      - "main"
       - "!**e2e"
       - "!e2e**"
     paths:
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index 86ae06e7..eed08360 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -12,7 +12,7 @@ on:
       - "docs/**"
       - "LICENSE"
     branches:
-      - master
+      - main
   schedule:
     - cron: "0 3 * * 1"
 
diff --git a/.github/workflows/docs-backfill.yaml b/.github/workflows/docs-backfill.yaml
index 5d0103fe..4d42c063 100644
--- a/.github/workflows/docs-backfill.yaml
+++ b/.github/workflows/docs-backfill.yaml
@@ -67,7 +67,7 @@ jobs:
         uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7
         with:
           fetch-depth: 0
-          ref: master
+          ref: main
 
       - name: Install uv
         uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
diff --git a/.github/workflows/documentation.yaml b/.github/workflows/documentation.yaml
index de7215bd..b2bbe0aa 100644
--- a/.github/workflows/documentation.yaml
+++ b/.github/workflows/documentation.yaml
@@ -3,7 +3,7 @@ name: documentation
 on:
   push:
     branches:
-      - "master"
+      - "main"
     paths:
       # Doc — CI workflow + deploy scripts
       - ".github/workflows/documentation.yaml"
@@ -36,7 +36,7 @@ on:
   workflow_run:
     workflows: ["Release Python SDK"]
     types: [completed]
-    branches: ["master"]
+    branches: ["main"]
   # Operator-driven, on-demand republish (AAASM-3853). Between coordinated
   # releases the default-served channel (pre-release/stable + the root redirect)
   # is only recomputed by the workflow_run release path, so doc fixes merged to
@@ -180,7 +180,7 @@ jobs:
         uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7
         with:
           fetch-depth: 0
-          ref: master
+          ref: main
 
       # The triggering "Release Python SDK" run published the real release tag
       # as a `release-tag` artifact (the workflow_run event only carries the
@@ -276,7 +276,7 @@ jobs:
         uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7
         with:
           fetch-depth: 0
-          ref: master
+          ref: main
 
       - name: Install uv
         uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
diff --git a/.github/workflows/framework-resolution-check.yml b/.github/workflows/framework-resolution-check.yml
index a74e5be8..2e434ec1 100644
--- a/.github/workflows/framework-resolution-check.yml
+++ b/.github/workflows/framework-resolution-check.yml
@@ -13,7 +13,7 @@ on:
       - "scripts/ci/check_framework_resolution.py"
       - ".github/workflows/framework-resolution-check.yml"
   push:
-    branches: [master]
+    branches: [main]
     paths:
       - "pyproject.toml"
       - "uv.lock"
diff --git a/.github/workflows/native-pin-consistency.yml b/.github/workflows/native-pin-consistency.yml
index f9fe02ff..33e426ce 100644
--- a/.github/workflows/native-pin-consistency.yml
+++ b/.github/workflows/native-pin-consistency.yml
@@ -8,7 +8,7 @@ on:
     paths:
       - "native/aa-ffi-python/Cargo.toml"
   push:
-    branches: [master]
+    branches: [main]
     paths:
       - "native/aa-ffi-python/Cargo.toml"
 
diff --git a/.github/workflows/quickstart-tabs-check.yml b/.github/workflows/quickstart-tabs-check.yml
index 8ba44bbd..1c27932d 100644
--- a/.github/workflows/quickstart-tabs-check.yml
+++ b/.github/workflows/quickstart-tabs-check.yml
@@ -15,7 +15,7 @@ on:
       - ".github/workflows/quickstart-tabs-check.yml"
   push:
     branches:
-      - master
+      - main
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
diff --git a/.github/workflows/readme-version-check.yml b/.github/workflows/readme-version-check.yml
index c7d3f379..028ba239 100644
--- a/.github/workflows/readme-version-check.yml
+++ b/.github/workflows/readme-version-check.yml
@@ -14,7 +14,7 @@ on:
       - ".github/workflows/readme-version-check.yml"
   push:
     branches:
-      - master
+      - main
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
diff --git a/.github/workflows/release-python-conversion-test.yml b/.github/workflows/release-python-conversion-test.yml
index b301fcae..0abed21e 100644
--- a/.github/workflows/release-python-conversion-test.yml
+++ b/.github/workflows/release-python-conversion-test.yml
@@ -11,7 +11,7 @@ name: Release-Python conversion tests
 on:
   push:
     branches:
-      - master
+      - main
     paths:
       - ".github/scripts/tag-to-pep440.sh"
       - ".github/scripts/test_tag_to_pep440.sh"
@@ -21,7 +21,7 @@ on:
       - ".github/workflows/release-python-conversion-test.yml"
   pull_request:
     branches:
-      - master
+      - main
     paths:
       - ".github/scripts/tag-to-pep440.sh"
       - ".github/scripts/test_tag_to_pep440.sh"
diff --git a/.github/workflows/rw_build_and_test.yaml b/.github/workflows/rw_build_and_test.yaml
index ed096709..4cb361b1 100644
--- a/.github/workflows/rw_build_and_test.yaml
+++ b/.github/workflows/rw_build_and_test.yaml
@@ -69,7 +69,7 @@ jobs:
 #    name: For unit test, organize and generate the testing report and upload it to Codecov
     if: ${{
         contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-        (github.event_name == 'push' && github.ref_name == 'master')
+        (github.event_name == 'push' && github.ref_name == 'main')
       }}
     needs: run_unit-test
     uses: Chisanan232/GitHub-Action_Reusable_Workflows-Python/.github/workflows/rw_organize_test_cov_reports.yaml@4a6480470b90c0b6139e05489868585fa50aad6f  # master @ 2026-05-26
@@ -81,7 +81,7 @@ jobs:
 #    name: For unit test, organize and generate the testing report and upload it to Codecov
     if: ${{
         contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-        (github.event_name == 'push' && github.ref_name == 'master')
+        (github.event_name == 'push' && github.ref_name == 'main')
       }}
     needs: run_integration-test
     uses: Chisanan232/GitHub-Action_Reusable_Workflows-Python/.github/workflows/rw_organize_test_cov_reports.yaml@4a6480470b90c0b6139e05489868585fa50aad6f  # master @ 2026-05-26
@@ -93,7 +93,7 @@ jobs:
 #    name: For end-to-end test, organize and generate the testing report and upload it to Codecov
     if: ${{
         contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-        (github.event_name == 'push' && github.ref_name == 'master')
+        (github.event_name == 'push' && github.ref_name == 'main')
       }}
     needs: run_e2e-test
     uses: Chisanan232/GitHub-Action_Reusable_Workflows-Python/.github/workflows/rw_organize_test_cov_reports.yaml@4a6480470b90c0b6139e05489868585fa50aad6f  # master @ 2026-05-26
@@ -106,7 +106,7 @@ jobs:
     if: ${{
         (
             contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         ) &&
         inputs.run_e2e == false
       }}
@@ -122,7 +122,7 @@ jobs:
     if: ${{
         (
             contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         ) &&
         inputs.run_e2e == true
       }}
diff --git a/.github/workflows/rw_run_all_test_and_record.yaml b/.github/workflows/rw_run_all_test_and_record.yaml
index 0dddfdc5..648fb82c 100644
--- a/.github/workflows/rw_run_all_test_and_record.yaml
+++ b/.github/workflows/rw_run_all_test_and_record.yaml
@@ -54,7 +54,7 @@ jobs:
         !contains(github.event.pull_request.labels.*.name, 'dependencies') && 
         (
             contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) || 
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         ) 
       }}
     needs: build-and-test
@@ -75,7 +75,7 @@ jobs:
         !contains(github.event.pull_request.labels.*.name, 'dependencies') &&
         (
             contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         )
       }}
     needs: build-and-test
@@ -96,7 +96,7 @@ jobs:
         !contains(github.event.pull_request.labels.*.name, 'dependencies') &&
         (
             (contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         )) &&
         inputs.run_e2e == true
       }}
@@ -118,7 +118,7 @@ jobs:
         !contains(github.event.pull_request.labels.*.name, 'dependencies') &&
         (
             contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         )
       }}
     needs: build-and-test
@@ -139,7 +139,7 @@ jobs:
         !contains(github.event.pull_request.labels.*.name, 'dependencies') &&
         (
             contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         )
       }}
     needs: build-and-test
@@ -160,7 +160,7 @@ jobs:
         !contains(github.event.pull_request.labels.*.name, 'dependencies') &&
         (
             contains(fromJSON('["pull_request","workflow_dispatch","schedule"]'), github.event_name) ||
-            (github.event_name == 'push' && github.ref_name == 'master')
+            (github.event_name == 'push' && github.ref_name == 'main')
         )
       }}
     needs: build-and-test
diff --git a/.github/workflows/type-check.yml b/.github/workflows/type-check.yml
index 2c2cadae..8dab9bdb 100644
--- a/.github/workflows/type-check.yml
+++ b/.github/workflows/type-check.yml
@@ -1,10 +1,10 @@
 name: PEP 561 Type Distribution
 
 on:
-  # Run on push to master and pull requests
+  # Run on push to main and pull requests
   push:
     branches:
-      - "master"
+      - "main"
     paths:
       # GitHub Action workflow files
       - ".github/workflows/type-check.yml"
@@ -18,7 +18,7 @@ on:
 
   pull_request:
     branches:
-      - "master"
+      - "main"
     paths:
       # GitHub Action workflow files
       - ".github/workflows/type-check.yml"
diff --git a/.github/workflows/wheel-python-matrix.yml b/.github/workflows/wheel-python-matrix.yml
index 6b69edea..93ab2d3b 100644
--- a/.github/workflows/wheel-python-matrix.yml
+++ b/.github/workflows/wheel-python-matrix.yml
@@ -15,7 +15,7 @@ name: Wheel Python matrix drift guard
 on:
   push:
     branches:
-      - master
+      - main
     paths:
       - "pyproject.toml"
       - ".github/workflows/release-python.yml"
@@ -24,7 +24,7 @@ on:
       - ".github/workflows/wheel-python-matrix.yml"
   pull_request:
     branches:
-      - master
+      - main
     paths:
       - "pyproject.toml"
       - ".github/workflows/release-python.yml"
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0b971f38..fe667ede 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -41,8 +41,8 @@ After this, `from agent_assembly._core import RuntimeClient` should succeed insi
 For isolated feature work, create a `git worktree` so multiple branches can be developed in parallel without context-switching the main checkout:
 
 ```bash
-git fetch remote && git checkout master && git pull --ff-only remote master
-git worktree add -b v0.0.0/AAASM-XXXX/short_summary ../python-sdk-AAASM-XXXX-short_summary master
+git fetch remote && git checkout main && git pull --ff-only remote main
+git worktree add -b v0.0.0/AAASM-XXXX/short_summary ../python-sdk-AAASM-XXXX-short_summary main
 ```
 
 Each worktree gets its own `.venv` — re-run `uv sync` inside the worktree before running tests.
@@ -172,7 +172,7 @@ to match — never leave the two out of sync.
 ## Branch naming and commit style
 
 - **Branch**: `<release-or-phase>/<ticket>/<type>/<short_summary>` — a four-part scheme. `<type>` is the change category (see the table below), and `<short_summary>` is 2–4 words in `snake_case`. Example: `v0.0.1/AAASM-42/feat/add_registry`.
-- **Base branch**: always `master`. Never branch from another feature branch.
+- **Base branch**: always `main`. Never branch from another feature branch.
 - **Push remote**: `remote` (= `https://github.com/ai-agent-assembly/python-sdk`). Never push feature branches to `origin` (the personal fork).
 - **Commit message format**: `<gitemoji> (<scope>): <imperative summary under 72 chars>` — e.g. `📝 (readme): Add badge strip`. See [gitmoji.dev](https://gitmoji.dev/) for the full emoji table.
 - **One concern per commit.** Each commit must be bisectable: tests pass, build succeeds. Prefer many small commits over one large commit.
@@ -197,7 +197,7 @@ Before requesting review, confirm every item below.
 
 - [ ] PR title is `[AAASM-XXXX] <emoji> (<scope>): <imperative summary>` (matches the commit style)
 - [ ] PR body filled in from `.github/PULL_REQUEST_TEMPLATE.md` (Description, Type of Change, Breaking Changes, Related Issues, Testing, Checklist)
-- [ ] Branch is up to date with `master` (rebased, not merged)
+- [ ] Branch is up to date with `main` (rebased, not merged)
 - [ ] `uv run pytest` is green locally (full suite, not just impacted tests)
 - [ ] `uv run pre-commit run --all-files` is green
 - [ ] `uv run mypy agent_assembly` is green
diff --git a/README.md b/README.md
index dc38058a..63cd6c2b 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # Agent Assembly Python SDK
 
-[![CI](https://img.shields.io/github/actions/workflow/status/ai-agent-assembly/python-sdk/ci.yaml?branch=master&logo=githubactions&logoColor=white&label=CI)](https://github.com/ai-agent-assembly/python-sdk/actions/workflows/ci.yaml)
-[![Docs](https://img.shields.io/github/actions/workflow/status/ai-agent-assembly/python-sdk/documentation.yaml?branch=master&logo=readthedocs&logoColor=white&label=docs)](https://github.com/ai-agent-assembly/python-sdk/actions/workflows/documentation.yaml)
+[![CI](https://img.shields.io/github/actions/workflow/status/ai-agent-assembly/python-sdk/ci.yaml?branch=main&logo=githubactions&logoColor=white&label=CI)](https://github.com/ai-agent-assembly/python-sdk/actions/workflows/ci.yaml)
+[![Docs](https://img.shields.io/github/actions/workflow/status/ai-agent-assembly/python-sdk/documentation.yaml?branch=main&logo=readthedocs&logoColor=white&label=docs)](https://github.com/ai-agent-assembly/python-sdk/actions/workflows/documentation.yaml)
 [![PyPI version](https://img.shields.io/pypi/v/agent-assembly?logo=pypi&logoColor=white)](https://pypi.org/project/agent-assembly/)
 [![GitHub release](https://img.shields.io/github/v/release/ai-agent-assembly/python-sdk?include_prereleases&sort=semver&label=release&logo=github)](https://github.com/ai-agent-assembly/python-sdk/releases)
 [![Python versions](https://img.shields.io/pypi/pyversions/agent-assembly?logo=python&logoColor=white)](https://pypi.org/project/agent-assembly/)
@@ -113,7 +113,7 @@ uv add --prerelease=allow agent-assembly
 > as a pre-release on PyPI, so `uv add agent-assembly` fails to resolve without it.
 > Drop the flag once a stable (non-pre-release) version is published.
 
-To track unreleased changes, install from the `master` branch:
+To track unreleased changes, install from the `main` branch:
 
 ```bash
 pip install git+https://github.com/ai-agent-assembly/python-sdk.git
diff --git a/codecov.yml b/codecov.yml
index f00a0fe8..8f80b25b 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -1,7 +1,7 @@
 codecov:
   token: $CODECOV_TOKEN
-  branch: master
-  strict_yaml_branch: master
+  branch: main
+  strict_yaml_branch: main
 
 coverage:
   status:
diff --git a/docs/release/RUNBOOK.md b/docs/release/RUNBOOK.md
index ae0c978b..35476a62 100644
--- a/docs/release/RUNBOOK.md
+++ b/docs/release/RUNBOOK.md
@@ -34,7 +34,7 @@ after a tag push — see `agent-assembly/docs/release/RUNBOOK.md` section
 ```bash
 gh workflow run release-python.yml \
   --repo ai-agent-assembly/python-sdk \
-  --ref master \
+  --ref main \
   -f pypi_version=0.0.1a9 \
   -f binary_source_tag=v0.0.1-alpha.9 \
   -f dry-run=false
@@ -42,7 +42,7 @@ gh workflow run release-python.yml \
 
 What happens:
 
-1. The workflow checks out master.
+1. The workflow checks out main.
 2. `pypi_version` (PEP 440, e.g. `0.0.1a9`) is stamped on
    `pyproject.toml`'s `project.version`.
 3. For each of the 4 wheel jobs, the matching `aasm-*.tar.gz` from the
@@ -74,7 +74,7 @@ new PyPI version **without** cutting a new agent-assembly tag.
 ```bash
 gh workflow run release-python.yml \
   --repo ai-agent-assembly/python-sdk \
-  --ref master \
+  --ref main \
   -f pypi_version=0.0.1a8.post1 \
   -f binary_source_tag=v0.0.1-alpha.8 \
   -f dry-run=false
@@ -82,7 +82,7 @@ gh workflow run release-python.yml \
 
 What happens:
 
-1. The workflow runs against master.
+1. The workflow runs against main.
 2. `pypi_version` (e.g. `0.0.1a8.post1`) is stamped on
    `pyproject.toml`'s `project.version`.
 3. `binary_source_tag` (e.g. `v0.0.1-alpha.8`) is the agent-assembly
diff --git a/mkdocs.yml b/mkdocs.yml
index 6a3915ba..a12bd5ea 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -10,7 +10,7 @@ site_description: >-
 # Repository
 repo_name: ai-agent-assembly/python-sdk
 repo_url: https://github.com/ai-agent-assembly/python-sdk
-edit_uri: edit/master/docs/
+edit_uri: edit/main/docs/
 
 # Copyright
 copyright: Copyright &copy; 2026 Agent Assembly Team