add walkthrough

Author: nedaKaighobadi

package.json

@@ -33,6 +33,51 @@
   ],
   "main": "./dist/extension.js",
   "contributes": {
+    "walkthroughs": [
+      {
+        "id": "codacy.setup",
+        "title": "Get Started with Codacy",
+        "description": "Set up Codacy to analyze your code, connect to the cloud, and enable AI guardrails.",
+        "steps": [
+          {
+            "id": "codacy.walkthrough.cloudSync",
+            "title": "Connect to Codacy",
+            "description": "Create or sign-in to your account to customize analysis, PR overviews, see coverage in the IDE, and much more.\n\n[Connect to Codacy](command:codacy.codacyAuth)",
+            "media": {
+              "image": "resources/walkthrough/cloud-sync.svg",
+              "altText": "Cloud sync illustration showing connection to Codacy"
+            }
+          },
+          {
+            "id": "codacy.walkthrough.aiGuardrails",
+            "title": "Set Up AI Guardrails",
+            "description": "Control your AI-generated code with Codacy Guardrails.\n\nInstall the MCP Server to get access to Codacy information from your AI agent.\n\n[Install Codacy MCP](command:codacy.configureMCP)",
+            "media": {
+              "image": "resources/walkthrough/ai-guardrails.svg",
+              "altText": "Shield icon representing AI guardrails protection"
+            }
+          },
+          {
+            "id": "codacy.walkthrough.localAnalysis",
+            "title": "Install Local Analysis",
+            "description": "Get instant feedback as you type by analyzing your code locally.\n\n[Install Codacy CLI](command:codacy.installCLI)\n\nInstalls all required dependencies: Node, Python, Java",
+            "media": {
+              "image": "resources/walkthrough/local-analysis.svg",
+              "altText": "Terminal showing Codacy CLI analyzing code"
+            }
+          },
+          {
+            "id": "codacy.walkthrough.customizeAnalysis",
+            "title": "Customize Your Analysis",
+            "description": "With your organization and repository added to Codacy, configure the patterns and standards you want to follow in the cloud and the IDE.\n\n[Configure patterns](command:codacy.configurePatterns)\n\nPlus you can adjust gates / goals for duplication, complexity and even coverage.",
+            "media": {
+              "image": "resources/walkthrough/customize-analysis.svg",
+              "altText": "Settings icon representing customization"
+            }
+          }
+        ]
+      }
+    ],
     "viewsContainers": {
       "activitybar": [
         {
@@ -332,6 +377,12 @@
         "title": "Install Codacy CLI",
         "category": "Codacy commands",
         "when": "!codacy:cliInstalled && codacy:canInstallCLI"
+      },
+      {
+        "command": "codacy.configurePatterns",
+        "title": "Configure Patterns",
+        "category": "Codacy commands",
+        "when": "Codacy:CodacyCloudStateContext == Loaded"
       }
     ],
     "menus": {

resources/walkthrough/ai-guardrails.svg

@@ -117,6 +117,12 @@ const registerCommands = async (context: vscode.ExtensionContext, codacyCloud: C
       )
       Config.updateOnboardingSkipped(false)
     },
+    'codacy.configurePatterns': () => {
+      const { provider, organization, repository } = codacyCloud.params!
+      vscode.env.openExternal(
+        vscode.Uri.parse(`https://app.codacy.com/${provider}/${organization}/${repository}/patterns`)
+      )
+    },
   }
 
   Object.keys(commands).forEach((cmd) => {