How to Migrate Agent Files from CodeStudio v1.x.x to v2.0.0+

This article explains how to migrate Agent files from CodeStudio v1.x.x to v2.0.0 and later versions so that Agent rules remain compatible with the updated configuration system.

Why Migration Is Needed

• In Code Studio v2.0.0+, the file naming convention has changed.
• Agent rules will not work unless the file is renamed from agent.md to agents.md.
• The Agents settings are also updated to recognize the new file format.

Resolution Steps

Step 1: Rename Agent File

• Navigate to your project root directory.
• Rename the file agent.md to agents.md (plural).
• This change is required for CodeStudio v2.0.0+ to recognize Agent instructions.

Step 2: Update Agents Settings

• Click the Settings icon in CodeStudio and choose ‘open settings’.
  
  
• In the Settings window, select Agents from the sidebar.
  
  
• Ensure the following options are enabled:
  • Agent Enabled
  • Use Agents Md file

Additional Notes

• Keep Agent instructions under 500 lines to avoid context length issues.
• If Agents are not recognized after migration, verify both the file name and settings configuration.

Following these steps ensures your Agent rules continue to work seamlessly after upgrading to CodeStudio v2.0.0+.