[AAASM-4959] 🔧 (config): Migrate default branch master → main (outbound refs)

.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

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

.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

.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
 

.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"

.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:

.github/workflows/codeql.yml

@@ -12,7 +12,7 @@ on:
       - "docs/**"
       - "LICENSE"
     branches:
-      - master
+      - main
   schedule:
     - cron: "0 3 * * 1"
 

.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

.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

.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"

.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"
 

.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 }}

.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 }}

.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"

.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
       }}

.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

.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"

.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"

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