diff --git a/.claude/commands/cpp.md b/.claude/commands/cpp.md
index e51aaa5a38..57b9d954ea 100644
--- a/.claude/commands/cpp.md
+++ b/.claude/commands/cpp.md
@@ -1 +1,30 @@
-Commit, push, pull request 
+Commit, push, pull request
+
+## Usage
+```
+/cpp [in branch <branch-name>]
+```
+
+## Description
+Commits the current changes, pushes to remote, and creates a pull request.
+
+## Optional Arguments
+- `in branch <branch-name>` - Specifies the target branch to use for the commit, push, and PR
+
+## Branch Handling
+When a branch name is provided:
+1. **Branch doesn't exist locally or remotely**: Creates a new branch with the specified name
+2. **Branch exists locally**: Switches to that branch
+3. **Branch exists only remotely**: Checks out the remote branch locally
+
+## Examples
+```bash
+# Commit, push, and PR on current branch
+/cpp
+
+# Commit, push, and PR on specific branch (creates if doesn't exist)
+/cpp in branch ios-5364-add-claude-to-gh-actions
+
+# Commit, push, and PR on existing branch
+/cpp in branch develop
+```
diff --git a/.github/WORKFLOWS_REFERENCE.md b/.github/WORKFLOWS_REFERENCE.md
index fdad2b5d75..f5322281f1 100644
--- a/.github/WORKFLOWS_REFERENCE.md
+++ b/.github/WORKFLOWS_REFERENCE.md
@@ -66,8 +66,9 @@ This document provides an overview of GitHub workflows, custom actions, and auto
 
 #### `ipa.yaml` - IPA Build
 **File:** `.github/workflows/ipa.yaml`
-**Triggers:** Manual dispatch
-**Purpose:** Creates IPA builds for distribution outside TestFlight/App Store.
+**Triggers:** Manual dispatch, repository dispatch (triggers test run repository after build)
+**Purpose:** Builds IPA file for the application. After successful build, triggers automated tests in the anytype-test repository.
+**Purpose:** Builds IPA file for the application. Invoked from the test run repository for automated testing.
 
 ---
 
@@ -163,10 +164,11 @@ This document provides an overview of GitHub workflows, custom actions, and auto
 
 ---
 
-#### `test_fastlane_build.yaml` - Fastlane Testing
+#### `test_fastlane_build.yaml` - Workflow Development Testing
 **File:** `.github/workflows/test_fastlane_build.yaml`
 **Triggers:** Manual dispatch
-**Purpose:** Tests Fastlane configuration changes without full builds.
+**Purpose:** Test workflow used when developing new GitHub workflows. Helps test workflow changes before merging to dev branch.
+**Note:** Due to GitHub limitations, new workflow files are not visible in the Actions UI until merged into the dev branch.
 
 ---
 
@@ -409,5 +411,5 @@ jobs:
 
 ---
 
-**Last Updated:** 2025-10-27
+**Last Updated:** 2025-10-29
 **Maintainers:** iOS Team