diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index b7caa510..f6859bf2 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -119,7 +119,7 @@ this order: explicit args → env (`AAASM_GATEWAY_URL` / `AAASM_API_KEY`) →
 
 ## Project policy
 
-- **JIRA:** project AAASM; set **Component** (`customfield_10041`) to
+- **JIRA:** project AAASM; set the native **Components** field to
   `ai-agent-assembly/python-sdk`; Team (`customfield_10001`) = Pioneer.
   Epic → Story → Subtask (one Subtask ≈ one commit) + a `Verify …` subtask per Story.
 - **Self-hosted deployment is out of scope** product-wide — don't propose
diff --git a/README.md b/README.md
index 8a3391cd..dc38058a 100644
--- a/README.md
+++ b/README.md
@@ -318,7 +318,7 @@ directly:
 | [python-sdk](https://github.com/ai-agent-assembly/python-sdk) | **This repo** — the Python SDK. |
 | [node-sdk](https://github.com/ai-agent-assembly/node-sdk) · [go-sdk](https://github.com/ai-agent-assembly/go-sdk) | Sibling SDKs for TypeScript/Node and Go. |
 | [homebrew-tap](https://github.com/ai-agent-assembly/homebrew-tap) | Homebrew tap for installing the `aasm` runtime CLI. |
-| [agent-assembly-examples](https://github.com/ai-agent-assembly/examples) | Runnable examples — learn by running small, framework-specific Python (and Node/Go) samples covering policy enforcement, approvals, audit, trace, and runtime workflows. |
+| [examples](https://github.com/ai-agent-assembly/examples) | Runnable examples — learn by running small, framework-specific Python (and Node/Go) samples covering policy enforcement, approvals, audit, trace, and runtime workflows. |
 
 The protocol specification and gateway behaviour the SDK targets live in the core runtime
 monorepo; see its [README](https://github.com/ai-agent-assembly/agent-assembly#readme) for the
diff --git a/docs/examples/framework-support.md b/docs/examples/framework-support.md
index 82560e46..a1d59409 100644
--- a/docs/examples/framework-support.md
+++ b/docs/examples/framework-support.md
@@ -36,7 +36,7 @@ entry points. On exit, all hooks are removed in reverse order.
 Each framework below ships an adapter under `agent_assembly/adapters/`. The
 **Runnable example** column reflects whether a complete, validated example exists today —
 either inline in this guide or as a curated script in the central
-[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
+[`examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
 repository.
 
 | Framework | Adapter | Runnable example |
@@ -104,7 +104,7 @@ directory for additional in-repo runnable scripts and their status.
 ## More runnable examples
 
 Curated, end-to-end examples for each framework live in the central
-[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
+[`examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
 repository. Each directory is a self-contained, cloneable project. This section documents each
 one in detail — start with [Preparing the runtime environment](preparing-the-runtime-environment.md),
 then follow the per-framework page:
diff --git a/docs/examples/index.md b/docs/examples/index.md
index bd44ae86..a07001bc 100644
--- a/docs/examples/index.md
+++ b/docs/examples/index.md
@@ -2,7 +2,7 @@
 
 End-to-end, runnable examples that govern real AI agent frameworks with Agent Assembly. Each
 example is a self-contained project in the
-[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
+[`examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
 repository, and each page below walks through what it demonstrates, how the `init_assembly()`
 adapter flow wires the framework, an annotated code walkthrough, and the expected output.
 
diff --git a/docs/examples/preparing-the-runtime-environment.md b/docs/examples/preparing-the-runtime-environment.md
index 292b48d8..07340def 100644
--- a/docs/examples/preparing-the-runtime-environment.md
+++ b/docs/examples/preparing-the-runtime-environment.md
@@ -1,7 +1,7 @@
 # Preparing the runtime environment
 
 Every page in this section walks through a self-contained, cloneable example from the
-[`agent-assembly-examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
+[`examples`](https://github.com/ai-agent-assembly/examples/tree/master/python)
 repository. The examples share the same prerequisites and the same run shape, so this page
 collects everything you need **once** — each per-framework page then only lists what is
 specific to that example.
@@ -42,7 +42,7 @@ directory:
 
 ```bash
 git clone https://github.com/ai-agent-assembly/examples.git
-cd agent-assembly-examples/python
+cd examples/python
 ```
 
 Each subdirectory under `python/` is a standalone project with its own `README.md`,
diff --git a/pyproject.toml b/pyproject.toml
index 81824c77..072870f5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -78,8 +78,8 @@ all = ["agent-assembly[runtime]"]
 aasm = "agent_assembly.cli.main:main"
 
 [project.urls]
-Homepage = "https://github.com/AI-agent-assembly/python-sdk"
-Repository = "https://github.com/AI-agent-assembly/python-sdk"
+Homepage = "https://github.com/ai-agent-assembly/python-sdk"
+Repository = "https://github.com/ai-agent-assembly/python-sdk"
 
 [dependency-groups]
 dev = [