use source branch

Author: yiliuTo

articles/java/migration/media/migrate-github-copilot-app-modernization-for-java/commit-for-custom-formula.png

@@ -51,7 +51,7 @@ For more information, see [Install a VS Code extension](https://code.visualstudi
 
 Use the following steps to start your migration process with solution assessment. This assessment helps you understand what your cloud readiness challenges are and how impactful they are, provides recommended solutions. A solution recommendation includes references to set up Azure resources, add configurations, and make code changes.
 
-1. Clone the [Java migration copilot samples](https://github.com/Azure-Samples/java-migration-copilot-samples) repository.
+1. Clone the [Java migration copilot samples](https://github.com/Azure-Samples/java-migration-copilot-samples) repository and check out to the ***source* branch.
 
 1. In Visual Studio Code, open the **mi-sql-public-demo** project folder in the samples repository.
 

articles/java/migration/migrate-github-copilot-app-modernization-for-java-quickstart-assess-migrate.md

@@ -0,0 +1,89 @@
+---
+title: "Quickstart: Create and Apply Your Own Formula"
+titleSuffix: GitHub Copilot App Modernization for Java - Azure
+description: Shows you how to create and apply your own formula.
+author: KarlErickson
+ms.author: karler
+ms.reviewer: xiading
+ms.topic: quickstart
+ms.date: 05/19/2025
+ms.custom: devx-track-java
+ms.service: azure-java
+---
+
+# Quickstart: create and apply your own formulas for GitHub Copilot App Modernization for Java (preview)
+
+This quickstart shows you how to create and apply your own formulas when you use GitHub Copilot App Modernization for Java (preview).
+
+In code development, enterprises often have different processes and controls to adhere to their organizational policies and business needs. This area is where *custom formulas* come in. A custom formula is generated by analyzing code commits from already-migrated code. The formula then guides Copilot to remediate code, following the pattern established by the already-migrated code.
+
+The following video demonstrates using GitHub Copilot App Modernization for Java (preview) to create and apply your own custom formula to migrate a Java project to Azure:
+
+<br>
+
+> [!VIDEO https://www.youtube.com/embed/ZiO3eznAl5w]
+
+## Prerequisites
+
+- A GitHub account with [GitHub Copilot](https://github.com/features/copilot) enabled. All plans are supported, including the Free plan.
+- The latest version of [Visual Studio Code](https://code.visualstudio.com/).
+- The latest version of the [GitHub Copilot extension in Visual Studio Code](https://code.visualstudio.com/docs/copilot/overview).
+- [GitHub Copilot App Modernization](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-app-mod-pack) extension pack. For install instructions, see [Quickstart: assess and migrate a Java project using GitHub Copilot App Modernization for Java (preview)](migrate-github-copilot-app-modernization-for-java-quickstart-assess-migrate.md).
+
+  This extension pack bundles the following two extensions:
+  - [GitHub Copilot App Modernization for Java (preview)](migrate-github-copilot-app-modernization-for-java.md)
+  - [GitHub Copilot App Modernization - upgrade for Java (preview)](/java/upgrade/overview)
+
+  App Modernization doesn't require Java in your local environment. However, to build your project successfully, install the correct version of Java and Maven. We recommend the [Microsoft Build of OpenJDK](/java/openjdk/) and [Maven](https://maven.apache.org/download.cgi).
+
+- [AppCAT](/azure/migrate/appcat/java-preview#download-and-install). This tool is required for the app assessment feature.
+
+## Create a custom formula
+
+Use the following steps to create a custom formula:
+
+1. Clone the [Java migration copilot samples](https://github.com/Azure-Samples/java-migration-copilot-samples) repository.
+
+1. In Visual Studio Code, open the **rabbitmq-sender** project folder in the samples repository. Then, check out the project to the **source** branch.
+
+1. In the **Activity** sidebar, open the **App Modernization for Java** extension pane and then, in the **Formulas** section, select **Create formula from source control**.
+
+   :::image type="content" source="./media/migrate-github-copilot-app-modernization-for-java/create-formula-from-source-control.png" lightbox="./media/migrate-github-copilot-app-modernization-for-java/create-formula-from-source-control.png" alt-text="Screenshot of Visual Studio Code that shows the button for Create formula from source control.":::
+
+1. Type **migrate rabbitmq to service bus** to search for the commit that migrates RabbitMQ. Select the corresponding commit and then select **OK**.
+
+   :::image type="content" source="./media/migrate-github-copilot-app-modernization-for-java/commit-for-custom-formula.png" lightbox="./media/migrate-github-copilot-app-modernization-for-java/commit-for-custom-formula.png" alt-text="Screenshot of the Visual Studio Code dialog box with the heading Select commits you want to save.":::
+
+1. Select **Create New** to create a new custom formula.
+
+1. A default formula name is generated. Name it **custom formula migrate rabbitmq**, then press <kbd>Enter</kbd> to confirm. A formula description and search patterns are generated in order. Press <kbd>Enter</kbd> repeatedly to confirm.
+
+1. Now, the custom formula for migrating `rabbitmq` is generated and shows in the **Formulas** section of the **App Modernization for Java** pane.
+
+   :::image type="content" source="./media/migrate-github-copilot-app-modernization-for-java/custom-formula-rabbitmq.png" lightbox="./media/migrate-github-copilot-app-modernization-for-java/custom-formula-rabbitmq.png" alt-text="Screenshot of Visual Studio Code that shows the Formulas section with the rabbitmq formula showing.":::
+
+## Apply the custom formula
+
+Use the following steps to apply the custom formula:
+
+1. Check out the project to the **main** branch. Find the custom formula in the **Formulas** section of **App Modernization for Java** pane. Run this formula by selecting **Run Formula**.
+
+   :::image type="content" source="./media/migrate-github-copilot-app-modernization-for-java/run-formula.png" lightbox="./media/migrate-github-copilot-app-modernization-for-java/run-formula.png" alt-text="Screenshot of Visual Studio Code that shows the Formulas section with the Run formula button indicated by a tooltip.":::
+
+   After you select the formula, the Copilot chat window with Agent Mode opens automatically.
+
+1. Select **Continue** repeatedly to confirm each tool action in the Copilot Chat window. The Copilot Agent uses various tools to facilitate application modernization. Each tool's usage requires confirmation by selecting **Continue**.
+
+1. After each step, manually input **continue** to confirm and proceed.
+
+1. Wait for the code changes to be generated.
+
+1. When you're prompted to run the **Java Application Build-Fix** tool, select **Continue** to build the project and fix errors. This tool attempts to resolve any build errors in up to 10 iterations.
+
+1. After the Build-Fix tool begins, select **Continue** to proceed and show progress.
+
+1. After the tool is finished, review the code changes and confirm them by selecting **Keep**.
+
+## See also
+
+[Predefined formulas for GitHub Copilot App Modernization for Java (preview)](migrate-github-copilot-app-modernization-for-java-predefined-formula.md)