To adopt Cosmos, use the following scenario:

1. Update your application to 8.7.

   For more information, see:

   • Pega CRM Update Guide
   • Pega CRM for Financial Services Update Guide
   • Pega CRM for Healthcare Update Guide
   • Pega CRM for Insurance Update Guide
2. Depending on the level of customization, to adjust your application to use Cosmos, follow the suggestions in articles below:

   For any UI-related update that you made, you must first analyze the changes and their impact, and then point to the Cosmos-based application.

   • Migrating an existing application from UI-Kit to Cosmos UI
   • Customizing a Cosmos application 
   • Customizing the Case Summary Panel in Cosmos 
   • How to update the summary panel of the Cosmos UI inside a case flow action
   • Creating a Basic Cosmos Work Application in Pega 8.3 
   • Creating and customizing case tabs in a Cosmos application
3. Review all the access groups in your implementation layer and ensure that they point to the User Portal portal.
4. Review all the roles in your implementation layer and modify the inherited role from product layer to point to the Cosmos equivalent.
   For example: The ImplLayer:SalesRep role inheriting from the PegaCRM-SFA:SalesRep role must be modified to inherit from the PegaCRM-SFACosmos:SalesRep role.
5. Review the Lead case type in your implementation layer and ensure that the case life cycle includes primary stages.