|
| 1 | +--- |
| 2 | + description: Configuration for AI behavior when interacting with Codacy's MCP Server |
| 3 | + applyTo: '**' |
| 4 | +--- |
| 5 | +--- |
| 6 | +# Codacy Rules |
| 7 | +Configuration for AI behavior when interacting with Codacy's MCP Server |
| 8 | + |
| 9 | +## CRITICAL: After ANY successful `edit_file` or `reapply` operation |
| 10 | +- YOU MUST IMMEDIATELY run the `codacy_cli_analyze` tool from Codacy's MCP Server for each file that was edited, with: |
| 11 | + - `rootPath`: set to the workspace path |
| 12 | + - `file`: set to the path of the edited file |
| 13 | + - `tool`: leave empty or unset |
| 14 | +- If any issues are found in the new edits, propose and apply fixes for them. |
| 15 | +- > NOTE: Failure to follow this rule is considered a critical error. |
| 16 | +
|
| 17 | +## When you tried to run the `codacy_cli_analyze` tool and the Codacy CLI is not installed |
| 18 | +- Ask the user 'Codacy CLI is not installed. Would you like me to install it now?' |
| 19 | +- If the user responds with "yes", run the `codacy_cli_install` tool and then continue with the original task |
| 20 | +- If the user responds with "no", instruct the user that they can disable automatic analysis in the extension settings |
| 21 | +- Wait for the user to respond before proceeding with any other actions |
| 22 | + |
| 23 | +## After every response |
| 24 | +- If you made any file edits in this conversation, verify you ran `codacy_cli_analyze` tool from Codacy's MCP Server |
| 25 | + |
| 26 | +## When there are no Codacy MCP Server tools available, or the MCP Server is not reachable |
| 27 | +- Suggest the user the following troubleshooting steps: |
| 28 | + - Try to reset the MCP on the extension |
| 29 | + - If the user is using VSCode, suggest them to review their Copilot > MCP settings in Github, under their organization or personal account. Refer them to Settings > Copilot > Enable MCP servers in Copilot. Suggested URL (https://github.com/settings/copilot/features) or https://github.com/organizations/{organization-name}/settings/copilot/features (This can only be done by their organization admins / owners) |
| 30 | +- If none of the above steps work, suggest the user to contact Codacy support |
| 31 | + |
| 32 | +## Trying to call a tool that needs a rootPath as a parameter |
| 33 | +- Always use the standard, non-URL-encoded file system path |
| 34 | + |
| 35 | +## CRITICAL: Dependencies and Security Checks |
| 36 | +- IMMEDIATELY after ANY of these actions: |
| 37 | + - Running npm/yarn/pnpm install |
| 38 | + - Adding dependencies to package.json |
| 39 | + - Adding requirements to requirements.txt |
| 40 | + - Adding dependencies to pom.xml |
| 41 | + - Adding dependencies to build.gradle |
| 42 | + - Any other package manager operations |
| 43 | +- You MUST run the `codacy_cli_analyze` tool with: |
| 44 | + - `rootPath`: set to the workspace path |
| 45 | + - `tool`: set to "trivy" |
| 46 | + - `file`: leave empty or unset |
| 47 | +- If any vulnerabilities are found because of the newly added packages: |
| 48 | + - Stop all other operations |
| 49 | + - Propose and apply fixes for the security issues |
| 50 | + - Only continue with the original task after security issues are resolved |
| 51 | +- EXAMPLE: |
| 52 | + - After: npm install react-markdown |
| 53 | + - Do: Run codacy_cli_analyze with trivy |
| 54 | + - Before: Continuing with any other tasks |
| 55 | + |
| 56 | +## General |
| 57 | +- Repeat the relevant steps for each modified file. |
| 58 | +- "Propose fixes" means to both suggest and, if possible, automatically apply the fixes. |
| 59 | +- You MUST NOT wait for the user to ask for analysis or remind you to run the tool. |
| 60 | +- Do not run `codacy_cli_analyze` looking for changes in duplicated code or code complexity metrics. |
| 61 | +- Complexity metrics are different from complexity issues. When trying to fix complexity in a repository or file, focus on solving the complexity issues and ignore the complexity metric. |
| 62 | +- Do not run `codacy_cli_analyze` looking for changes in code coverage. |
| 63 | +- Do not try to manually install Codacy CLI using either brew, npm, npx, or any other package manager. |
| 64 | +- If the Codacy CLI is not installed, just run the `codacy_cli_analyze` tool from Codacy's MCP Server. |
| 65 | +- When calling `codacy_cli_analyze`, only send provider, organization and repository if the project is a git repository. |
| 66 | + |
| 67 | +## Whenever a call to a Codacy tool that uses `repository` or `organization` as a parameter returns a 404 error |
| 68 | +- Offer to run the `codacy_setup_repository` tool to add the repository to Codacy |
| 69 | +- If the user accepts, run the `codacy_setup_repository` tool |
| 70 | +- Do not ever try to run the `codacy_setup_repository` tool on your own |
| 71 | +- After setup, immediately retry the action that failed (only retry once) |
| 72 | +--- |
0 commit comments