Make CONTRIBUTING.md more concise (#3472)

CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Contributing to Roo Code
 
-Roo Code is a community-driven project, and we highly value every contribution. To ensure a smooth and effective process for everyone, **we operate on an "[Issue-First](#2-key-principle-issue-first-approach)" basis.** This means all work should be linked to a GitHub Issue _before_ a Pull Request is submitted (see our [PR Policy](#pull-request-pr-policy) for details). Please read this guide carefully to understand how to contribute.
-This guide outlines how to contribute to Roo Code, whether you're fixing bugs, adding features, or improving documentation.
+Roo Code is a community-driven project, and we deeply value every contribution. To streamline collaboration, we operate on an [Issue-First](#issue-first-approach) basis, meaning all [Pull Requests (PRs)](#submitting-a-pull-request) must first be linked to a GitHub Issue. Please review this guide carefully.
 
 ## Table of Contents
 
-- [I. Before You Contribute](#i-before-you-contribute)
-    - [1. Code of Conduct](#1-code-of-conduct)
-    - [2. Understand the Project Roadmap](#2-understand-the-project-roadmap)
-        - [Reliability First](#reliability-first)
-        - [Enhanced User Experience](#enhanced-user-experience)
-        - [Leading on Agent Performance](#leading-on-agent-performance)
-    - [3. Join the Roo Code Community](#3-join-the-roo-code-community)
-- [II. Finding & Planning Your Contribution](#ii-finding--planning-your-contribution)
-    - [1. Types of Contributions](#1-types-of-contributions)
-    - [2. Key Principle: Issue-First Approach](#2-key-principle-issue-first-approach)
-    - [3. Deciding What to Work On](#3-deciding-what-to-work-on)
-    - [4. Reporting Bugs or Issues](#4-reporting-bugs-or-issues)
-- [III. Development & Submission Process](#iii-development--submission-process)
-    - [1. Development Setup](#1-development-setup)
-    - [2. Writing Code Guidelines](#2-writing-code-guidelines)
-    - [3. Submitting Code: Pull Request (PR) Process](#3-submitting-code-pull-request-pr-process)
-        - [Draft Pull Requests](#draft-pull-requests)
-        - [Pull Request Description](#pull-request-description)
-        - [Pull Request (PR) Policy](#pull-request-pr-policy)
-            - [Objective](#objective)
-            - [Issue-First Approach](#issue-first-approach)
-            - [Conditions for Open PRs](#conditions-for-open-prs)
-            - [Procedure](#procedure)
-            - [Responsibilities](#responsibilities)
-- [IV. Legal](#iv-legal)
-    - [Contribution Agreement](#contribution-agreement)
-
-## I. Before You Contribute
-
-First, familiarize yourself with our community standards and project direction.
+- [Before You Contribute](#before-you-contribute)
+- [Finding & Planning Your Contribution](#finding--planning-your-contribution)
+- [Development & Submission Process](#development--submission-process)
+- [Legal](#legal)
 
-### 1. Code of Conduct
-
-All contributors must adhere to our [Code of Conduct](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Please read it before contributing.
+## Before You Contribute
 
-### 2. Understand the Project Roadmap
+### 1. Code of Conduct
 
-Roo Code has a clear development roadmap that guides our priorities and future direction. Understanding our roadmap can help you:
+All contributors must adhere to our [Code of Conduct](./CODE_OF_CONDUCT.md).
 
-- Align your contributions with project goals
-- Identify areas where your expertise would be most valuable
-- Understand the context behind certain design decisions
-- Find inspiration for new features that support our vision
+### 2. Project Roadmap
 
-We're focused on making Roo Code the top choice for developers building with AI-driven coding tools. Here's how we'll get there:
+Our roadmap guides the project's direction. Align your contributions with these key goals:
 
-#### Reliability First
+### Reliability First
 
 - Ensure diff editing and command execution are consistently reliable.
 - Reduce friction points that deter regular usage.
 - Guarantee smooth operation across all locales and platforms.
 - Expand robust support for a wide variety of AI providers and models.
 
-#### Enhanced User Experience
+### Enhanced User Experience
 
 - Streamline the UI/UX for clarity and intuitiveness.
 - Continuously improve the workflow to meet the high expectations developers have for daily-use tools.
 
-#### Leading on Agent Performance
+### Leading on Agent Performance
 
 - Establish comprehensive evaluation benchmarks (evals) to measure real-world productivity.
 - Make it easy for everyone to easily run and interpret these evals.
-- Ship improvements to Roo Code that demonstrate clear increases in eval scores.
+- Ship improvements that demonstrate clear increases in eval scores.
 
-We especially welcome contributions that advance our roadmap goals. If you're working on something that aligns with these pillars, please mention it in your PR description.
+Mention alignment with these areas in your PRs.
 
 ### 3. Join the Roo Code Community
 
-Connecting with the Roo Code community is a great way to get started:
-
-- **Primary Method**:
-    1.  Join the [Roo Code Discord community](https://discord.gg/roocode).
-    2.  Once joined, send a direct message (DM) to **Hannes Rudolph** (Discord username: `hrudolph`) to discuss your interest and get guidance.
-- **Alternative for Experienced Contributors**: If you're comfortable with an issue-first approach, you can engage directly through GitHub by following the [Kanban board](https://github.com/orgs/RooVetGit/projects/1) and communicating via issues and pull requests.
-
-## II. Finding & Planning Your Contribution
-
-Identify what you'd like to work on and how to approach it.
-
-### 1. Types of Contributions
+- **Primary:** Join our [Discord](https://discord.gg/roocode) and DM **Hannes Rudolph (`hrudolph`)**.
+- **Alternative:** Experienced contributors can engage directly via [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-We welcome various contributions:
+## Finding & Planning Your Contribution
 
-- **Bug Fixes**: Addressing issues in existing code.
-- **New Features**: Adding new functionality.
-- **Documentation**: Improving guides, examples, or fixing typos.
+### Types of Contributions
 
-### 2. Key Principle: Issue-First Approach
+- **Bug Fixes:** Addressing code issues.
+- **New Features:** Adding functionality.
+- **Documentation:** Improving guides and clarity.
 
-**All contributions must start with a GitHub Issue.** This is a critical step to ensure alignment and prevent wasted effort.
+### Issue-First Approach
 
-- **Find or Create an Issue**:
-    - Before starting any work, search [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) to see if an issue for your intended contribution already exists.
-    - If it exists and is unassigned, comment on the issue to express your interest in taking it on. A maintainer will then assign it to you.
-    - If no issue exists, create a new one using the appropriate template on our [issues page](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - For bugs, use the "Bug Report" template.
-        - For new features, use the "Detailed Feature Proposal" template. Await approval from a maintainer (especially @hannesrudolph) before proceeding with implementation.
-        - **Note**: General ideas or preliminary discussions for features can start in [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Once an idea is more concrete, a "Detailed Feature Proposal" issue should be created.
-- **Claiming and Assignment**:
-    - Clearly state your intention to work on an issue by commenting on it.
-    - Wait for a maintainer to officially assign the issue to you in GitHub. This prevents multiple people from working on the same thing.
-- **Consequences of Not Following**:
-    - Pull Requests (PRs) submitted without a corresponding, pre-approved, and assigned issue may be closed without a full review. This policy is in place to ensure contributions align with project priorities and to respect the time of both contributors and maintainers.
+All contributions must begin with a GitHub Issue.
 
-This approach helps us track work, ensure changes are desired, and coordinate efforts effectively.
+- **Check existing issues**: Search [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Create an issue**: Use appropriate templates:
+    - **Bugs:** "Bug Report" template.
+    - **Features:** "Detailed Feature Proposal" template. Approval required before starting.
+- **Claim issues**: Comment and await official assignment.
 
-### 3. Deciding What to Work On
+**PRs without approved issues may be closed.**
 
-- **Good First Issues**: Check the "Issue [Unassigned]" section of our [Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) GitHub Project.
-- **Documentation**: While this `CONTRIBUTING.md` is the primary guide for code contributions, if you're interested in contributing to other documentation (like user guides or API docs), please check the [Roo Code Docs repository](https://github.com/RooVetGit/Roo-Code-Docs) or inquire in the Discord community.
-- **Proposing New Features**:
-    1.  **Initial Idea/Discussion**: For broad or initial feature ideas, start a conversation in [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Formal Proposal**: For specific, actionable feature proposals ready for consideration and potential approval, create a "Detailed Feature Proposal" issue using the template on our [issues page](https://github.com/RooVetGit/Roo-Code/issues/new/choose). This is a key part of our **Issue-First Approach**.
+### Deciding What to Work On
 
-### 4. Reporting Bugs or Issues
+- Check the [GitHub Project](https://github.com/orgs/RooVetGit/projects/1) for unassigned "Good First Issues."
+- For docs, visit [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-If you find a bug:
+### Reporting Bugs
 
-1.  **Search Existing Issues**: Check [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) for duplicates.
-2.  **Create a New Issue**: If unique, use the "Bug Report" template on our [issues page](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Check for existing reports first.
+- Create new bugs using the ["Bug Report" template](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Security issues**: Report privately via [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Security Vulnerabilities**: If you discover a security vulnerability, please report it privately using [GitHub's security advisory tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Do not create a public issue for security vulnerabilities.
+## Development & Submission Process
 
-## III. Development & Submission Process
+### Development Setup
 
-Follow these steps for coding and submitting your work.
+1. **Fork & Clone:**
 
-### 1. Development Setup
-
-1.  **Fork & Clone**:
-    - Fork the repository on GitHub.
-    - Clone your fork locally: `git clone https://github.com/YOUR_USERNAME/Roo-Code.git`
-2.  **Install Dependencies**: `npm run install:all`
-3.  **Run Webview (Dev Mode)**: `npm run dev` (for Vite/React app with HMR)
-4.  **Debug Extension**: Press `F5` in VS Code (or **Run** → **Start Debugging**) to open a new Extension Development Host window with Roo Code loaded.
-
-Webview changes (in `webview-ui`) will appear immediately with Hot Module Replacement. Changes to the core extension (in `src`) will require a restart of the Extension Development Host.
-
-Alternatively, to build and install a `.vsix` package:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/YOUR_USERNAME/Roo-Code.git
 ```
 
-(Replace `<version>` with the actual version number from the built file).
-
-### 2. Writing Code Guidelines
-
-- **Focused PRs**: One feature/bug fix per PR.
-- **Code Quality**:
-    - Pass CI checks (linting, formatting).
-    - Address ESLint warnings or errors (`npm run lint`).
-    - Respond to feedback from automated code review tools (e.g., Ellipsis, if configured).
-    - Follow TypeScript best practices and maintain type safety.
-- **Testing**:
-    - Add tests for new features.
-    - Run `npm test` to ensure all tests pass.
-    - Update existing tests if your changes affect them.
-- **Commit Messages**:
-    - Write clear, descriptive commit messages.
-    - Reference relevant issues in commits using `#issue-number` (e.g., `Fixes #123`).
-- **Pre-Submission Checklist (before creating a PR)**:
-    - Rebase your branch on the latest `main` from the upstream repository.
-    - Ensure your code builds successfully (`npm run build`).
-    - Double-check all tests are passing (`npm test`).
-    - Remove any debugging code or `console.log` statements.
-
-### 3. Submitting Code: Pull Request (PR) Process
-
-#### Draft Pull Requests
-
-Use Draft PRs for work that is not yet ready for full review but for which you'd like to:
-
-- Run automated checks (CI).
-- Get early feedback from maintainers or other contributors.
-- Signal that the work is in progress.
-
-Mark a PR as "Ready for Review" only when all checks are passing and you believe it meets the criteria outlined in the "Writing Code Guidelines" and "Pull Request Description" sections.
-
-#### Pull Request Description
-
-Your PR description must be comprehensive and follow the structure provided by our [Pull Request Template](.github/pull_request_template.md). Key elements include:
-
-- A link to the approved GitHub Issue it addresses.
-- A clear description of the changes made and their purpose.
-- Detailed steps to test the changes.
-- A list of any breaking changes.
-- **For UI changes, provide clear before-and-after screenshots or videos.**
-- **Crucially, state whether your PR necessitates updates to user-facing documentation. If so, specify which documents or sections are affected.**
-
-#### Pull Request (PR) Policy
-
-##### Objective
-
-Maintain a clean, focused, and actionable PR backlog.
+2. **Install Dependencies:**
 
-##### Issue-First Approach
+```
+npm run install:all
+```
 
-- **Required**: Before starting work, ensure there is an existing, approved, and assigned GitHub Issue (either a "Bug Report" or a "Detailed Feature Proposal"). (See "Key Principle: Issue-First Approach" under "II. Finding & Planning Your Contribution" for full details).
-- **Approval**: Issues, especially "Detailed Feature Proposals" or those involving significant changes, must be reviewed and approved by maintainers (particularly @hannesrudolph) _before_ coding begins.
-- **Reference**: PRs must explicitly reference these pre-approved issues in their description.
-- **Consequences**: Failure to follow this process may result in your PR being closed without a full review.
+3. **Debugging:** Open with VS Code (`F5`).
 
-##### Conditions for Open PRs
+### Writing Code Guidelines
 
-- **Ready for Merge**: Passes all CI tests, aligns with the project roadmap (if applicable), is linked to an approved and assigned issue, has clear documentation/comments, includes clear before-and-after images or videos for any UI changes.
-- **To be Closed**: Unresolved CI test failures, significant merge conflicts, misalignment with project goals, or prolonged inactivity (e.g., >30 days without updates after feedback).
+- One focused PR per feature or fix.
+- Follow ESLint and TypeScript best practices.
+- Write clear, descriptive commits referencing issues (e.g., `Fixes #123`).
+- Provide thorough testing (`npm test`).
+- Rebase onto the latest `main` branch before submission.
 
-##### Procedure
+### Submitting a Pull Request
 
-1.  **Issue Qualification & Assignment**: @hannesrudolph (or other maintainers) reviews new and existing issues to ensure they align with the project and follow the "Issue-First Approach." Issues ready for work are assigned.
-2.  **Initial PR Triage (Daily)**: Maintainers conduct a quick daily review of incoming PRs to filter for urgency or critical issues.
-3.  **Thorough PR Review (Weekly - Mondays, or as capacity allows)**: Maintainers perform a more in-depth review of PRs to assess readiness, alignment with an approved issue, and overall quality.
-4.  **Detailed Feedback & Iteration**: Based on the thorough review, maintainers provide feedback (Approve, Request Changes, or Reject). Contributors are expected to respond to feedback and iterate as needed.
-5.  **Decision Stage**: Approved PRs are merged. PRs with unresolvable issues or misalignment may be closed with a clear explanation.
-6.  **Follow-up**: Authors of closed PRs are encouraged to address feedback and open new ones if issues are resolved or project direction shifts.
+- Begin as a **Draft PR** if seeking early feedback.
+- Clearly describe your changes following the Pull Request Template.
+- Provide screenshots/videos for UI changes.
+- Indicate if documentation updates are necessary.
 
-##### Responsibilities
+### Pull Request Policy
 
-- **Issue Qualification & Process Adherence (@hannesrudolph & Maintainers)**: Ensure all contributions adhere to the "Issue-First Approach" by reviewing, qualifying, and assigning issues. Guide contributors on process.
-- **Maintainers (Dev Team)**: Conduct initial and thorough PR reviews, provide technical feedback, make approval/rejection decisions, and merge PRs.
-- **Contributors**: Ensure PRs are linked to an approved and assigned issue, meet quality guidelines, and respond promptly to feedback.
+- Must reference pre-approved, assigned issues.
+- PRs without adherence to the policy may be closed.
+- PRs should pass CI tests, align with the roadmap, and have clear documentation.
 
-This policy ensures clarity and efficient integration.
+### Review Process
 
-## IV. Legal
+- **Daily Triage:** Quick checks by maintainers.
+- **Weekly In-depth Review:** Comprehensive assessment.
+- **Iterate promptly** based on feedback.
 
-### Contribution Agreement
+## Legal
 
-By submitting a pull request, you agree that your contributions will be licensed under the [Apache 2.0 License](LICENSE) (or the project's current license, if different), the same as the project.
+By contributing, you agree your contributions will be licensed under the Apache 2.0 License, consistent with Roo Code's licensing.

locales/ca/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Contribuir a Roo Code
 
-Roo Code és un projecte impulsat per la comunitat i valorem molt cada contribució. Per garantir un procés fluid i efectiu per a tothom, **treballem amb un enfocament "[Issue-First](#2-principi-clau-enfoc-issue-first)".** Això vol dir que tota la feina ha d'estar vinculada a una Issue de GitHub _abans_ de presentar un Pull Request (consulta la nostra [Política de PR](#política-de-pull-request-pr) per a més detalls). Llegeix aquesta guia amb atenció per entendre com pots contribuir.
-Aquesta guia explica com contribuir a Roo Code, ja sigui corregint errors, afegint funcionalitats o millorant la documentació.
+Roo Code és un projecte impulsat per la comunitat i valorem molt cada contribució. Per simplificar la col·laboració, treballem amb un enfoc [Issue-First](#enfoc-issue-first), que significa que tots els [Pull Requests (PRs)](#enviar-un-pull-request) han d'estar primer vinculats a una Issue de GitHub. Si us plau, llegeix aquesta guia amb atenció.
 
 ## Taula de continguts
 
-- [I. Abans de contribuir](#i-abans-de-contribuir)
-    - [1. Codi de conducta](#1-codi-de-conducta)
-    - [2. Entendre la fulla de ruta del projecte](#2-entendre-la-fulla-de-ruta-del-projecte)
-        - [Fiabilitat primer](#fiabilitat-primer)
-        - [Experiència d'usuari millorada](#experiència-dusuari-millorada)
-        - [Lideratge en rendiment dels agents](#lideratge-en-rendiment-dels-agents)
-    - [3. Uneix-te a la comunitat Roo Code](#3-uneix-te-a-la-comunitat-roo-code)
-- [II. Trobar i planificar la teva contribució](#ii-trobar-i-planificar-la-teva-contribució)
-    - [1. Tipus de contribucions](#1-tipus-de-contribucions)
-    - [2. Principi clau: Enfoc Issue-First](#2-principi-clau-enfoc-issue-first)
-    - [3. Decidir en què treballar](#3-decidir-en-què-treballar)
-    - [4. Informar d'errors o problemes](#4-informar-derrors-o-problemes)
-- [III. Procés de desenvolupament i enviament](#iii-procés-de-desenvolupament-i-enviament)
-    - [1. Configuració de desenvolupament](#1-configuració-de-desenvolupament)
-    - [2. Guia per escriure codi](#2-guia-per-escriure-codi)
-    - [3. Enviar codi: Procés de Pull Request (PR)](#3-enviar-codi-procés-de-pull-request-pr)
-        - [Pull Requests en esborrany](#pull-requests-en-esborrany)
-        - [Descripció del Pull Request](#descripció-del-pull-request)
-        - [Política de Pull Request (PR)](#política-de-pull-request-pr)
-            - [Objectiu](#objectiu)
-            - [Enfoc Issue-First](#enfoc-issue-first)
-            - [Condicions per a PRs oberts](#condicions-per-a-prs-oberts)
-            - [Procediment](#procediment)
-            - [Responsabilitats](#responsabilitats)
-- [IV. Legal](#iv-legal)
-    - [Acord de contribució](#acord-de-contribució)
-
-## I. Abans de contribuir
-
-Primer, familiaritza't amb els nostres estàndards comunitaris i la direcció del projecte.
+- [Abans de contribuir](#abans-de-contribuir)
+- [Trobar i planificar la teva contribució](#trobar-i-planificar-la-teva-contribució)
+- [Procés de desenvolupament i enviament](#procés-de-desenvolupament-i-enviament)
+- [Legal](#legal)
 
-### 1. Codi de conducta
-
-Tots els col·laboradors han de complir el nostre [Codi de conducta](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Si us plau, llegeix-lo abans de contribuir.
+## Abans de contribuir
 
-### 2. Entendre la fulla de ruta del projecte
+### 1. Codi de conducta
 
-Roo Code té una fulla de ruta clara que guia les nostres prioritats i direcció futura. Entendre-la t'ajuda a:
+Tots els col·laboradors han de complir el nostre [Codi de conducta](./CODE_OF_CONDUCT.md).
 
-- Alinear les teves contribucions amb els objectius del projecte
-- Identificar àrees on la teva experiència sigui més valuosa
-- Comprendre el context darrere de certes decisions de disseny
-- Inspirar-te per a noves funcionalitats que donin suport a la nostra visió
+### 2. Fulla de ruta del projecte
 
-Ens centrem a fer de Roo Code la millor opció per als desenvolupadors que treballen amb eines de codificació impulsades per IA. Així és com ho aconseguirem:
+La nostra fulla de ruta orienta la direcció del projecte. Alinea les teves contribucions amb aquests objectius clau:
 
-#### Fiabilitat primer
+### Fiabilitat primer
 
 - Garantir que l'edició de diferències i l'execució de comandes siguin consistentment fiables
 - Reduir els punts de fricció que desanimen l'ús regular
 - Garantir un funcionament fluid en tots els idiomes i plataformes
 - Ampliar el suport robust per a una àmplia varietat de proveïdors i models d'IA
 
-#### Experiència d'usuari millorada
+### Experiència d'usuari millorada
 
 - Simplificar la interfície d'usuari per a més claredat i intuïció
-- Millorar contínuament el flux de treball per satisfer les altes expectatives que els desenvolupadors tenen per a eines d'ús diari
+- Millorar contínuament el flux de treball per satisfer les altes expectatives dels desenvolupadors
 
-#### Lideratge en rendiment dels agents
+### Lideratge en rendiment dels agents
 
 - Establir punts de referència d'avaluació (evals) complets per mesurar la productivitat real
 - Facilitar que tothom pugui executar i interpretar aquestes avaluacions fàcilment
-- Proporcionar millores a Roo Code que demostrin increments clars en les puntuacions d'avaluació
+- Proporcionar millores que demostrin increments clars en les puntuacions d'avaluació
 
-Agraïm especialment les contribucions que avancin els objectius de la nostra fulla de ruta. Si treballes en alguna cosa alineada amb aquests pilars, esmenta-ho a la descripció del teu PR.
+Esmenta la relació amb aquestes àrees als teus PRs.
 
 ### 3. Uneix-te a la comunitat Roo Code
 
-Connectar amb la comunitat Roo Code és una excel·lent manera de començar:
-
-- **Mètode principal**:
-    1.  Uneix-te a la [comunitat Roo Code a Discord](https://discord.gg/roocode).
-    2.  Un cop dins, envia un missatge directe (DM) a **Hannes Rudolph** (Discord: `hrudolph`) per comentar el teu interès i rebre orientació.
-- **Alternativa per a col·laboradors experimentats**: Si et sents còmode amb l'enfoc issue-first, pots participar directament a GitHub seguint el [tauler Kanban](https://github.com/orgs/RooVetGit/projects/1) i comunicant-te mitjançant issues i pull requests.
-
-## II. Trobar i planificar la teva contribució
-
-Identifica en què t'agradaria treballar i com abordar-ho.
-
-### 1. Tipus de contribucions
+- **Principal:** Uneix-te al nostre [Discord](https://discord.gg/roocode) i envia un DM a **Hannes Rudolph (`hrudolph`)**.
+- **Alternativa:** Els col·laboradors experimentats poden participar directament via [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Acceptem diversos tipus de contribucions:
+## Trobar i planificar la teva contribució
 
-- **Correcció d'errors**: Solucionar problemes en el codi existent.
-- **Noves funcionalitats**: Afegir noves funcionalitats.
-- **Documentació**: Millorar guies, exemples o corregir errors tipogràfics.
+### Tipus de contribucions
 
-### 2. Principi clau: Enfoc Issue-First
+- **Correcció d'errors:** Solucionar problemes en el codi.
+- **Noves funcionalitats:** Afegir noves capacitats.
+- **Documentació:** Millorar guies i claredat.
 
-**Totes les contribucions han de començar amb una Issue de GitHub.** Aquest pas és fonamental per garantir l'alineació i evitar esforços innecessaris.
+### Enfoc Issue-First
 
-- **Cerca o crea una Issue**:
-    - Abans de començar, busca a [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) si ja existeix una issue per a la teva contribució.
-    - Si existeix i no està assignada, comenta a la issue per expressar el teu interès. Un mantenidor te l'assignarà.
-    - Si no existeix, crea'n una de nova utilitzant la plantilla adequada a la nostra [pàgina d'issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Per a errors, utilitza la plantilla "Bug Report".
-        - Per a noves funcionalitats, utilitza la plantilla "Detailed Feature Proposal". Espera l'aprovació d'un mantenidor (especialment @hannesrudolph) abans de començar a implementar.
-        - **Nota**: Les idees generals o discussions preliminars sobre funcionalitats poden començar a [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Quan la idea sigui més concreta, s'ha de crear una issue de "Detailed Feature Proposal".
-- **Reclama i assigna**:
-    - Indica clarament la teva intenció de treballar en una issue comentant-la.
-    - Espera que un mantenidor te l'assigni oficialment a GitHub. Així evitem que diverses persones treballin en el mateix.
-- **Conseqüències de no seguir-ho**:
-    - Els Pull Requests (PRs) enviats sense una issue corresponent, preaprovada i assignada poden ser tancats sense revisió completa. Aquesta política existeix per garantir que les contribucions estiguin alineades amb les prioritats del projecte i per respectar el temps de tothom.
+Totes les contribucions han de començar amb una Issue de GitHub.
 
-Aquest enfoc ens ajuda a fer el seguiment de la feina, garantir que els canvis siguin desitjats i coordinar els esforços de manera efectiva.
+- **Revisar issues existents:** Cerca a [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Crear una issue:** Utilitza les plantilles adequades:
+    - **Errors:** Plantilla "Bug Report".
+    - **Funcionalitats:** Plantilla "Detailed Feature Proposal". Es requereix aprovació abans de començar.
+- **Reclamar issues:** Comenta i espera l'assignació oficial.
 
-### 3. Decidir en què treballar
+**Els PRs sense issues aprovades poden ser tancats.**
 
-- **Good First Issues**: Consulta la secció "Issue [Unassigned]" del nostre [Projecte Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) a GitHub.
-- **Documentació**: Tot i que aquest `CONTRIBUTING.md` és la guia principal per a contribucions de codi, si t'interessa contribuir a altra documentació (com guies d'usuari o API), revisa el [repositori Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) o pregunta a la comunitat de Discord.
-- **Proposar noves funcionalitats**:
-    1.  **Idea inicial/discussió**: Per a idees generals o inicials, inicia una conversa a [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Proposta formal**: Per a propostes específiques i llestes per a consideració, crea una issue de "Detailed Feature Proposal" utilitzant la plantilla a la nostra [pàgina d'issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Això és clau en el nostre **enfoc Issue-First**.
+### Decidir en què treballar
 
-### 4. Informar d'errors o problemes
+- Consulta el [Projecte GitHub](https://github.com/orgs/RooVetGit/projects/1) per trobar "Good First Issues" no assignades.
+- Per a documentació, visita [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Si trobes un error:
+### Informar d'errors
 
-1.  **Cerca issues existents**: Revisa [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) per veure si ja està reportat.
-2.  **Crea una nova issue**: Si és únic, utilitza la plantilla "Bug Report" a la nostra [pàgina d'issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Comprova primer els informes existents.
+- Crea nous informes d'errors utilitzant la [plantilla "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Vulnerabilitats de seguretat:** Informa de manera privada via [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Vulnerabilitats de seguretat**: Si descobreixes una vulnerabilitat de seguretat, informa-la de manera privada utilitzant l'[eina d'avisos de seguretat de GitHub](https://github.com/RooVetGit/Roo-Code/security/advisories/new). No creïs una issue pública per a vulnerabilitats de seguretat.
+## Procés de desenvolupament i enviament
 
-## III. Procés de desenvolupament i enviament
+### Configuració de desenvolupament
 
-Segueix aquests passos per programar i enviar la teva feina.
+1. **Fork & Clona:**
 
-### 1. Configuració de desenvolupament
-
-1.  **Fork & Clona**:
-    - Fes un fork del repositori a GitHub.
-    - Clona el teu fork localment: `git clone https://github.com/EL_TEU_USUARI/Roo-Code.git`
-2.  **Instal·la les dependències**: `npm run install:all`
-3.  **Executa Webview (mode dev)**: `npm run dev` (per a l'app Vite/React amb HMR)
-4.  **Depura l'extensió**: Prem `F5` a VS Code (o **Run** → **Start Debugging**) per obrir una nova finestra Extension Development Host amb Roo Code carregat.
-
-Els canvis a webview (`webview-ui`) apareixeran immediatament gràcies a Hot Module Replacement. Els canvis a l'extensió principal (`src`) requeriran reiniciar l'Extension Development Host.
-
-Alternativament, per construir i instal·lar un paquet `.vsix`:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<versió>.vsix
+```
+git clone https://github.com/EL_TEU_USUARI/Roo-Code.git
 ```
 
-(Substitueix `<versió>` pel número de versió real del fitxer generat).
-
-### 2. Guia per escriure codi
-
-- **PRs enfocats**: Una funcionalitat/fix per PR.
-- **Qualitat del codi**:
-    - Passar els checks de CI (lint, format)
-    - Corregir advertències o errors d'ESLint (`npm run lint`)
-    - Respondre al feedback d'eines automàtiques de revisió de codi
-    - Seguir bones pràctiques de TypeScript i mantenir la seguretat de tipus
-- **Proves**:
-    - Afegir tests per a noves funcionalitats
-    - Executar `npm test` per assegurar que tot passa
-    - Actualitzar tests existents si el teu canvi els afecta
-- **Missatges de commit**:
-    - Escriure missatges clars i descriptius
-    - Referenciar issues rellevants amb `#número-issue` (ex: `Fixes #123`)
-- **Checklist abans d'enviar PR**:
-    - Rebasejar la teva branca sobre l'últim `main` de l'upstream
-    - Assegura't que el codi compila (`npm run build`)
-    - Verifica que tots els tests passen (`npm test`)
-    - Elimina qualsevol codi de depuració o `console.log`
-
-### 3. Enviar codi: Procés de Pull Request (PR)
-
-#### Pull Requests en esborrany
-
-Utilitza PRs en esborrany per a feina que encara no està llesta per a revisió completa però per la qual vols:
-
-- Executar checks automàtics (CI)
-- Rebre feedback primerenc de mantenidors o altres col·laboradors
-- Indicar que la feina està en curs
-
-Marca un PR com a "Llest per a revisió" només quan tots els checks passin i creguis que compleix els criteris de "Guia per escriure codi" i "Descripció del Pull Request".
-
-#### Descripció del Pull Request
-
-La descripció del teu PR ha de ser completa i seguir l'estructura de la nostra [Plantilla de Pull Request](.github/pull_request_template.md). Elements clau:
-
-- Un enllaç a la Issue de GitHub aprovada que aborda
-- Descripció clara dels canvis realitzats i el seu propòsit
-- Passos detallats per provar els canvis
-- Llista de qualsevol canvi important (breaking changes)
-- **Per a canvis de UI, proporciona captures de pantalla o vídeos de l'abans i el després**
-- **Indica si el teu PR requereix actualitzar documentació d'usuari i quins documents o seccions es veuen afectats**
-
-#### Política de Pull Request (PR)
-
-##### Objectiu
-
-Mantenir un backlog de PRs net, enfocat i gestionable.
+2. **Instal·la dependències:**
 
-##### Enfoc Issue-First
+```
+npm run install:all
+```
 
-- **Requerit**: Abans de començar, ha d'existir una Issue de GitHub aprovada i assignada (ja sigui "Bug Report" o "Detailed Feature Proposal").
-- **Aprovació**: Les Issues, especialment les de canvis importants, han de ser revisades i aprovades pels mantenidors (especialment @hannesrudolph) _abans_ de començar a programar.
-- **Referència**: Els PRs han de referenciar explícitament aquestes Issues preaprovades a la seva descripció.
-- **Conseqüències**: No seguir aquest procés pot resultar en el tancament del PR sense revisió completa.
+3. **Depuració:** Obre amb VS Code (`F5`).
 
-##### Condicions per a PRs oberts
+### Guia per escriure codi
 
-- **Llest per merge**: Passa tots els tests de CI, s'alinea amb la fulla de ruta del projecte (si s'escau), està vinculat a una Issue aprovada i assignada, té documentació/comentaris clars, inclou imatges o vídeos d'abans i després per a canvis de UI
-- **Per tancar**: Falla en tests de CI, conflictes de merge importants, desalineació amb els objectius del projecte o inactivitat prolongada (>30 dies sense actualitzacions després de feedback)
+- Un PR centrat per funcionalitat o correcció.
+- Segueix les millors pràctiques d'ESLint i TypeScript.
+- Escriu missatges de commit clars i descriptius que facin referència a issues (ex: `Fixes #123`).
+- Proporciona proves completes (`npm test`).
+- Rebaseja a la branca `main` més recent abans d'enviar.
 
-##### Procediment
+### Enviar un Pull Request
 
-1.  **Qualificació i assignació d'Issues**: @hannesrudolph (o altres mantenidors) revisen i assignen Issues noves i existents.
-2.  **Triage inicial de PRs (diari)**: Els mantenidors fan una revisió ràpida dels PRs entrants per filtrar urgències o problemes crítics.
-3.  **Revisió exhaustiva de PRs (setmanal)**: Els mantenidors revisen a fons els PRs per avaluar preparació, alineació amb la Issue aprovada i qualitat general.
-4.  **Feedback detallat i iteració**: Segons la revisió, els mantenidors donen feedback (Aprovar, Sol·licitar canvis o Rebutjar). S'espera que els col·laboradors responguin i millorin segons sigui necessari.
-5.  **Etapa de decisió**: Els PRs aprovats es fusionen. Els PRs amb problemes irresolubles o desalineats poden ser tancats amb una explicació clara.
-6.  **Seguiment**: Els autors de PRs tancats poden abordar el feedback i obrir-ne de nous si es resolen els problemes o canvia la direcció del projecte.
+- Comença com a **PR en esborrany** si busques feedback primerenc.
+- Descriu clarament els teus canvis seguint la Plantilla de Pull Request.
+- Proporciona captures de pantalla/vídeos per a canvis d'UI.
+- Indica si es necessiten actualitzacions de documentació.
 
-##### Responsabilitats
+### Política de Pull Request
 
-- **Qualificació d'Issues i compliment del procés (@hannesrudolph & mantenidors)**: Assegurar que totes les contribucions segueixin l'enfoc Issue-First. Guiar els col·laboradors en el procés.
-- **Mantenidors (equip de desenvolupament)**: Revisar PRs, donar feedback tècnic, prendre decisions d'aprovació/rebuig i fusionar PRs.
-- **Col·laboradors**: Assegurar que els PRs estiguin vinculats a una Issue aprovada i assignada, compleixin amb les guies de qualitat i responguin ràpidament al feedback.
+- Ha de fer referència a issues preaprovades i assignades.
+- Els PRs que no segueixen la política poden ser tancats.
+- Els PRs han de passar els tests de CI, alinear-se amb la fulla de ruta i tenir documentació clara.
 
-Aquesta política garanteix claredat i integració eficient.
+### Procés de revisió
 
-## IV. Legal
+- **Triatge diari:** Comprovacions ràpides pels mantenidors.
+- **Revisió setmanal detallada:** Avaluació exhaustiva.
+- **Itera ràpidament** en base al feedback.
 
-### Acord de contribució
+## Legal
 
-En enviar un pull request, acceptes que les teves contribucions es llicenciïn sota la [Llicència Apache 2.0](LICENSE) (o la llicència actual del projecte), igual que el projecte.
+En enviar un pull request, acceptes que les teves contribucions es llicenciïn sota la Llicència Apache 2.0, d'acord amb la llicència de Roo Code.

locales/de/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Beitrag zu Roo Code
 
-Roo Code ist ein Community-getriebenes Projekt und wir schätzen jeden Beitrag sehr. Damit alles reibungslos läuft, **arbeiten wir nach dem Prinzip "[Issue-First](#2-wichtiges-prinzip-issue-first-ansatz)".** Das heißt: Jede Arbeit muss mit einem GitHub-Issue verknüpft sein, _bevor_ ein Pull Request eingereicht wird (siehe unsere [PR-Richtlinie](#pull-request-pr-richtlinie) für Details). Lies diesen Leitfaden aufmerksam, um zu verstehen, wie du beitragen kannst.
-Dieser Leitfaden erklärt, wie du zu Roo Code beitragen kannst – egal ob du Bugs behebst, Features hinzufügst oder die Doku verbesserst.
+Roo Code ist ein Community-getriebenes Projekt, und wir schätzen jeden Beitrag sehr. Für eine reibungslose Zusammenarbeit arbeiten wir nach dem [Issue-First-Ansatz](#issue-first-ansatz), was bedeutet, dass alle [Pull Requests (PRs)](#einen-pull-request-einreichen) zuerst mit einem GitHub Issue verknüpft werden müssen. Bitte lies diesen Leitfaden sorgfältig durch.
 
 ## Inhaltsverzeichnis
 
-- [I. Bevor du beiträgst](#i-bevor-du-beiträgst)
-    - [1. Verhaltenskodex](#1-verhaltenskodex)
-    - [2. Projekt-Roadmap verstehen](#2-projekt-roadmap-verstehen)
-        - [Zuverlässigkeit an erster Stelle](#zuverlässigkeit-an-erster-stelle)
-        - [Verbesserte Benutzererfahrung](#verbesserte-benutzererfahrung)
-        - [Führend bei der Agentenleistung](#führend-bei-der-agentenleistung)
-    - [3. Werde Teil der Roo Code Community](#3-werde-teil-der-roo-code-community)
-- [II. Beitrag finden & planen](#ii-beitrag-finden--planen)
-    - [1. Beitragsarten](#1-beitragsarten)
-    - [2. Wichtiges Prinzip: Issue-First-Ansatz](#2-wichtiges-prinzip-issue-first-ansatz)
-    - [3. Was soll ich machen?](#3-was-soll-ich-machen)
-    - [4. Bugs oder Probleme melden](#4-bugs-oder-probleme-melden)
-- [III. Entwicklung & Einreichung](#iii-entwicklung--einreichung)
-    - [1. Entwicklungs-Setup](#1-entwicklungs-setup)
-    - [2. Code-Richtlinien](#2-code-richtlinien)
-    - [3. Code einreichen: Pull Request (PR) Prozess](#3-code-einreichen-pull-request-pr-prozess)
-        - [Entwurf-Pull-Requests](#entwurf-pull-requests)
-        - [Pull Request Beschreibung](#pull-request-beschreibung)
-        - [Pull Request (PR) Richtlinie](#pull-request-pr-richtlinie)
-            - [Ziel](#ziel)
-            - [Issue-First-Ansatz](#issue-first-ansatz)
-            - [Bedingungen für offene PRs](#bedingungen-für-offene-prs)
-            - [Ablauf](#ablauf)
-            - [Verantwortlichkeiten](#verantwortlichkeiten)
-- [IV. Rechtliches](#iv-rechtliches)
-    - [Beitragsvereinbarung](#beitragsvereinbarung)
-
-## I. Bevor du beiträgst
-
-Mach dich zuerst mit unseren Community-Standards und der Projekt-Richtung vertraut.
+- [Bevor du beiträgst](#bevor-du-beiträgst)
+- [Beitrag finden & planen](#beitrag-finden--planen)
+- [Entwicklung & Einreichung](#entwicklung--einreichung)
+- [Rechtliches](#rechtliches)
 
-### 1. Verhaltenskodex
-
-Alle Mitwirkenden müssen sich an unseren [Verhaltenskodex](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md) halten. Bitte lies ihn, bevor du beiträgst.
+## Bevor du beiträgst
 
-### 2. Projekt-Roadmap verstehen
+### 1. Verhaltenskodex
 
-Roo Code hat eine klare Entwicklungs-Roadmap, die unsere Prioritäten und die Zukunft vorgibt. Wenn du die Roadmap kennst, kannst du:
+Alle Mitwirkenden müssen sich an unseren [Verhaltenskodex](./CODE_OF_CONDUCT.md) halten.
 
-- Deine Beiträge an den Projektzielen ausrichten
-- Bereiche finden, in denen deine Skills besonders wertvoll sind
-- Den Kontext hinter bestimmten Design-Entscheidungen verstehen
-- Inspiration für neue Features bekommen, die unsere Vision unterstützen
+### 2. Projekt-Roadmap
 
-Wir konzentrieren uns darauf, Roo Code zur ersten Wahl für Entwickler zu machen, die mit KI-gestützten Coding-Tools arbeiten. So werden wir das erreichen:
+Unsere Roadmap gibt die Richtung des Projekts vor. Richte deine Beiträge an diesen Schlüsselzielen aus:
 
-#### Zuverlässigkeit an erster Stelle
+### Zuverlässigkeit an erster Stelle
 
 - Sicherstellen, dass Diff-Bearbeitung und Befehlsausführung durchgängig zuverlässig sind.
 - Reibungspunkte reduzieren, die von der regelmäßigen Nutzung abhalten.
 - Reibungslosen Betrieb in allen Sprachen und auf allen Plattformen garantieren.
 - Robuste Unterstützung für eine Vielzahl von KI-Anbietern und -Modellen ausbauen.
 
-#### Verbesserte Benutzererfahrung
+### Verbesserte Benutzererfahrung
 
 - Die Benutzeroberfläche für mehr Klarheit und Intuitivität optimieren.
 - Den Workflow kontinuierlich verbessern, um den hohen Erwartungen gerecht zu werden, die Entwickler an täglich genutzte Tools stellen.
 
-#### Führend bei der Agentenleistung
+### Führend bei der Agentenleistung
 
 - Umfassende Evaluierungsmaßstäbe (Evals) etablieren, um die Produktivität in der realen Welt zu messen.
 - Es für jeden einfach machen, diese Evals durchzuführen und zu interpretieren.
-- Verbesserungen für Roo Code liefern, die klare Steigerungen der Eval-Ergebnisse zeigen.
+- Verbesserungen liefern, die klare Steigerungen der Eval-Ergebnisse zeigen.
 
-Beiträge, die unsere Roadmap-Ziele voranbringen, sind besonders willkommen. Wenn du an etwas arbeitest, das zu diesen Säulen passt, erwähne das bitte in deiner PR-Beschreibung.
+Erwähne die Ausrichtung an diesen Bereichen in deinen PRs.
 
 ### 3. Werde Teil der Roo Code Community
 
-Mit der Roo Code Community in Kontakt zu kommen, ist ein super Start:
-
-- **Hauptweg**:
-    1.  Tritt der [Roo Code Discord Community](https://discord.gg/roocode) bei.
-    2.  Schreib dann eine Direktnachricht (DM) an **Hannes Rudolph** (Discord: `hrudolph`), um dein Interesse zu besprechen und Tipps zu bekommen.
-- **Alternative für Erfahrene**: Wenn du mit dem Issue-First-Ansatz vertraut bist, kannst du direkt über GitHub mitmachen, indem du das [Kanban-Board](https://github.com/orgs/RooVetGit/projects/1) nutzt und über Issues und Pull Requests kommunizierst.
-
-## II. Beitrag finden & planen
-
-Finde heraus, woran du arbeiten willst und wie du es angehst.
-
-### 1. Beitragsarten
+- **Hauptweg:** Tritt unserem [Discord](https://discord.gg/roocode) bei und schreibe eine DM an **Hannes Rudolph (`hrudolph`)**.
+- **Alternative:** Erfahrene Mitwirkende können sich direkt über [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1) beteiligen.
 
-Wir freuen uns über viele Arten von Beiträgen:
+## Beitrag finden & planen
 
-- **Bugfixes**: Fehler im Code beheben
-- **Neue Features**: Neue Funktionen hinzufügen
-- **Dokumentation**: Guides verbessern, Beispiele ergänzen oder Tippfehler korrigieren
+### Beitragsarten
 
-### 2. Wichtiges Prinzip: Issue-First-Ansatz
+- **Bugfixes:** Fehler im Code beheben.
+- **Neue Features:** Neue Funktionen hinzufügen.
+- **Dokumentation:** Anleitungen verbessern und klarer gestalten.
 
-**Jeder Beitrag muss mit einem GitHub-Issue starten.** Das ist wichtig, damit alles abgestimmt läuft und keine Arbeit umsonst ist.
+### Issue-First-Ansatz
 
-- **Issue finden oder erstellen**:
-    - Bevor du loslegst, schau bei den [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues), ob es schon ein Issue für deinen Beitrag gibt.
-    - Wenn ja und es ist nicht zugewiesen, kommentiere, dass du es übernehmen willst. Ein Maintainer weist es dir dann zu.
-    - Wenn es noch kein Issue gibt, erstelle eins mit der passenden Vorlage auf unserer [Issues-Seite](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Für Bugs: "Bug Report"-Vorlage
-        - Für neue Features: "Detailed Feature Proposal"-Vorlage. Warte auf die Freigabe eines Maintainers (vor allem @hannesrudolph), bevor du loslegst.
-        - **Hinweis**: Allgemeine Ideen oder erste Diskussionen zu Features können in [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests) starten. Wenn die Idee konkreter wird, sollte ein "Detailed Feature Proposal"-Issue erstellt werden.
-- **Claiming und Zuweisung**:
-    - Sag klar, dass du an einem Issue arbeiten willst, indem du es kommentierst.
-    - Warte, bis ein Maintainer das Issue offiziell in GitHub zuweist. So arbeiten nicht mehrere an derselben Sache.
-- **Wenn du das nicht beachtest**:
-    - Pull Requests (PRs) ohne zugehöriges, vorab genehmigtes und zugewiesenes Issue können ohne vollständige Prüfung geschlossen werden. Das ist wichtig, damit Beiträge zu den Projektzielen passen und die Zeit aller respektiert wird.
+Alle Beiträge müssen mit einem GitHub Issue beginnen.
 
-So behalten wir den Überblick, stellen sicher, dass Änderungen gewünscht sind, und koordinieren die Arbeit effektiv.
+- **Bestehende Issues prüfen**: Durchsuche die [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Issue erstellen**: Nutze die passenden Vorlagen:
+    - **Bugs:** "Bug Report"-Vorlage.
+    - **Features:** "Detailed Feature Proposal"-Vorlage. Vor dem Start ist eine Genehmigung erforderlich.
+- **Issues beanspruchen**: Kommentiere und warte auf die offizielle Zuweisung.
 
-### 3. Was soll ich machen?
+**PRs ohne genehmigte Issues können geschlossen werden.**
 
-- **Good First Issues**: Schau im Bereich "Issue [Unassigned]" auf unserem [Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) GitHub-Projekt.
-- **Dokumentation**: Während dieses `CONTRIBUTING.md` der Hauptleitfaden für Code-Beiträge ist, findest du weitere Doku (wie User-Guides oder API-Doku) im [Roo Code Docs Repository](https://github.com/RooVetGit/Roo-Code-Docs) oder frag in der Discord-Community nach.
-- **Neue Features vorschlagen**:
-    1.  **Erste Idee/Diskussion**: Für grobe oder neue Feature-Ideen starte eine Diskussion in [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Formaler Vorschlag**: Für konkrete, umsetzbare Feature-Vorschläge nutze die "Detailed Feature Proposal"-Vorlage auf unserer [Issues-Seite](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Das ist ein wichtiger Teil unseres **Issue-First-Ansatzes**.
+### Was soll ich machen?
 
-### 4. Bugs oder Probleme melden
+- Schau im [GitHub Project](https://github.com/orgs/RooVetGit/projects/1) nach nicht zugewiesenen "Good First Issues".
+- Für Dokumentation besuche das [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) Repository.
 
-Wenn du einen Bug findest:
+### Bugs melden
 
-1.  **Nach bestehenden Issues suchen**: Schau bei den [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) nach, ob es schon gemeldet wurde.
-2.  **Neues Issue erstellen**: Wenn nicht, nutze die "Bug Report"-Vorlage auf unserer [Issues-Seite](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Prüfe zuerst, ob der Bug bereits gemeldet wurde.
+- Erstelle neue Bug-Reports mit der ["Bug Report"-Vorlage](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Sicherheitslücken:** Melde diese privat über [Security Advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Sicherheitslücken**: Wenn du eine Sicherheitslücke findest, melde sie bitte privat über [GitHubs Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Erstelle kein öffentliches Issue für Sicherheitslücken.
+## Entwicklung & Einreichung
 
-## III. Entwicklung & Einreichung
+### Entwicklungs-Setup
 
-Folge diesen Schritten beim Coden und Einreichen deiner Arbeit.
+1. **Fork & Clone:**
 
-### 1. Entwicklungs-Setup
-
-1.  **Fork & Clone**:
-    - Forke das Repository auf GitHub.
-    - Klone deinen Fork lokal: `git clone https://github.com/DEIN_USERNAME/Roo-Code.git`
-2.  **Abhängigkeiten installieren**: `npm run install:all`
-3.  **Webview (Dev Mode) starten**: `npm run dev` (für Vite/React-App mit HMR)
-4.  **Extension debuggen**: Drücke `F5` in VS Code (oder **Run** → **Start Debugging**), um ein neues Extension Development Host-Fenster mit Roo Code zu öffnen.
-
-Webview-Änderungen (in `webview-ui`) erscheinen sofort dank Hot Module Replacement. Änderungen an der Core-Extension (in `src`) erfordern einen Neustart des Extension Development Host.
-
-Alternativ kannst du ein `.vsix`-Paket bauen und installieren:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/DEIN_USERNAME/Roo-Code.git
 ```
 
-(Ersetze `<version>` durch die tatsächliche Versionsnummer aus dem Build.)
-
-### 2. Code-Richtlinien
-
-- **Fokussierte PRs**: Ein Feature/Bugfix pro PR.
-- **Code-Qualität**:
-    - CI-Checks bestehen (Linting, Formatierung)
-    - ESLint-Warnungen oder Fehler beheben (`npm run lint`)
-    - Auf Feedback von automatisierten Code-Review-Tools reagieren
-    - TypeScript Best Practices einhalten und Typensicherheit wahren
-- **Tests**:
-    - Tests für neue Features hinzufügen
-    - `npm test` ausführen, damit alle Tests bestehen
-    - Bestehende Tests anpassen, falls nötig
-- **Commit-Messages**:
-    - Klare, beschreibende Commit-Messages schreiben
-    - Relevante Issues mit `#issue-number` referenzieren (z.B. `Fixes #123`)
-- **Vor dem PR-Absenden**:
-    - Branch auf den neuesten `main` vom Upstream rebasen
-    - Sicherstellen, dass der Code baut (`npm run build`)
-    - Alle Tests müssen bestehen (`npm test`)
-    - Debug-Code oder `console.log`-Statements entfernen
-
-### 3. Code einreichen: Pull Request (PR) Prozess
-
-#### Entwurf-Pull-Requests
-
-Nutze Entwurf-PRs für Arbeit, die noch nicht bereit für ein vollständiges Review ist, aber für die du:
-
-- Automatisierte Checks (CI) laufen lassen willst
-- Frühes Feedback von Maintainer:innen oder anderen Contributor:innen möchtest
-- Zeigen willst, dass die Arbeit in Arbeit ist
-
-Markiere einen PR erst als "Ready for Review", wenn alle Checks bestehen und du glaubst, dass er die Kriterien aus "Code-Richtlinien" und "Pull Request Beschreibung" erfüllt.
-
-#### Pull Request Beschreibung
-
-Deine PR-Beschreibung muss umfassend sein und der Struktur unserer [Pull Request Template](.github/pull_request_template.md) folgen. Wichtige Punkte:
-
-- Link zum genehmigten GitHub-Issue, das bearbeitet wird
-- Klare Beschreibung der Änderungen und deren Zweck
-- Detaillierte Testschritte
-- Liste aller Breaking Changes
-- **Für UI-Änderungen: Vorher-Nachher-Screenshots oder Videos**
-- **Wichtig: Gib an, ob deine PR Änderungen an User-Doku erfordert und welche Dokumente betroffen sind**
-
-#### Pull Request (PR) Richtlinie
-
-##### Ziel
-
-Einen sauberen, fokussierten und handhabbaren PR-Backlog erhalten.
+2. **Abhängigkeiten installieren:**
 
-##### Issue-First-Ansatz
+```
+npm run install:all
+```
 
-- **Pflicht**: Vor Arbeitsbeginn muss ein genehmigtes und zugewiesenes GitHub-Issue existieren (entweder "Bug Report" oder "Detailed Feature Proposal").
-- **Freigabe**: Issues, vor allem für größere Änderungen, müssen von Maintainer:innen (insbesondere @hannesrudolph) _vor_ dem Coden freigegeben werden.
-- **Referenz**: PRs müssen diese Issues explizit in der Beschreibung referenzieren.
-- **Folgen**: Wird das nicht beachtet, kann der PR ohne vollständige Prüfung geschlossen werden.
+3. **Debugging:** Öffne mit VS Code (`F5`).
 
-##### Bedingungen für offene PRs
+### Code-Richtlinien
 
-- **Merge-bereit**: Besteht alle CI-Tests, passt zur Roadmap (falls relevant), ist mit einem genehmigten und zugewiesenen Issue verknüpft, hat klare Doku/Kommentare, enthält Vorher-Nachher-Bilder/Videos bei UI-Änderungen
-- **Zu schließen**: CI-Fehler, große Merge-Konflikte, keine Übereinstimmung mit Projektzielen oder lange Inaktivität (>30 Tage ohne Updates nach Feedback)
+- Ein fokussierter PR pro Feature oder Fix.
+- Folge den ESLint und TypeScript Best Practices.
+- Schreibe klare, beschreibende Commits, die auf Issues verweisen (z.B. `Fixes #123`).
+- Liefere gründliche Tests (`npm test`).
+- Rebase auf den neuesten `main`-Branch vor dem Einreichen.
 
-##### Ablauf
+### Einen Pull Request einreichen
 
-1.  **Issue-Qualifikation & Zuweisung**: @hannesrudolph (oder andere Maintainer:innen) prüfen neue und bestehende Issues auf Passung und weisen sie zu.
-2.  **Erste PR-Triage (täglich)**: Maintainer:innen machen einen schnellen Check neuer PRs auf Dringlichkeit oder kritische Themen.
-3.  **Gründliche PR-Review (wöchentlich)**: Maintainer:innen prüfen PRs auf Bereitschaft, Passung zum Issue und Qualität.
-4.  **Detailliertes Feedback & Iteration**: Nach dem Review gibt es Feedback (Approve, Request Changes, Reject). Contributor:innen sollen darauf reagieren und nachbessern.
-5.  **Entscheidung**: Genehmigte PRs werden gemerged. PRs mit unlösbaren Problemen oder ohne Passung werden mit Begründung geschlossen.
-6.  **Follow-up**: Autor:innen geschlossener PRs können nachbessern und neue PRs öffnen, wenn Probleme gelöst sind.
+- Beginne als **Draft PR**, wenn du frühes Feedback suchst.
+- Beschreibe deine Änderungen klar und folge der Pull Request Vorlage.
+- Stelle Screenshots/Videos für UI-Änderungen bereit.
+- Gib an, ob Dokumentationsaktualisierungen notwendig sind.
 
-##### Verantwortlichkeiten
+### Pull Request Richtlinie
 
-- **Issue-Qualifikation & Prozess (@hannesrudolph & Maintainer:innen)**: Sicherstellen, dass alle Beiträge dem Issue-First-Ansatz folgen. Contributor:innen anleiten.
-- **Maintainer:innen (Dev Team)**: PRs prüfen, technisches Feedback geben, Entscheidungen treffen, PRs mergen.
-- **Contributor:innen**: PRs mit genehmigtem und zugewiesenem Issue verknüpfen, Qualitätsrichtlinien einhalten, Feedback zügig umsetzen.
+- Muss auf vorab genehmigte, zugewiesene Issues verweisen.
+- PRs ohne Einhaltung der Richtlinie können geschlossen werden.
+- PRs sollten CI-Tests bestehen, zur Roadmap passen und klare Dokumentation haben.
 
-Diese Policy sorgt für Klarheit und effiziente Integration.
+### Review-Prozess
 
-## IV. Rechtliches
+- **Tägliche Triage:** Schnelle Prüfungen durch Maintainer.
+- **Wöchentliche Tiefenprüfung:** Umfassende Bewertung.
+- **Zeitnah auf Feedback reagieren** und entsprechend iterieren.
 
-### Beitragsvereinbarung
+## Rechtliches
 
-Mit dem Einreichen eines Pull Requests erklärst du dich damit einverstanden, dass deine Beiträge unter der [Apache 2.0 Lizenz](LICENSE) (oder der aktuellen Projektlizenz) stehen – genau wie das Projekt selbst.
+Mit deinem Beitrag erklärst du dich damit einverstanden, dass deine Beiträge unter der Apache 2.0 Lizenz lizenziert werden, konsistent mit der Lizenzierung von Roo Code.

locales/es/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Contribuir a Roo Code
 
-Roo Code es un proyecto impulsado por la comunidad y valoramos mucho cada contribución. Para que todo funcione sin problemas, **trabajamos con un enfoque de "[Issue-First](#2-principio-clave-enfoque-issue-first)".** Esto significa que todo el trabajo debe estar vinculado a un Issue de GitHub _antes_ de enviar un Pull Request (consulta nuestra [Política de PR](#política-de-pull-request-pr) para más detalles). Lee esta guía con atención para entender cómo puedes contribuir.
-Esta guía explica cómo contribuir a Roo Code, ya sea corrigiendo errores, agregando funciones o mejorando la documentación.
+Roo Code es un proyecto impulsado por la comunidad, y valoramos profundamente cada contribución. Para agilizar la colaboración, operamos con un enfoque [Issue-First](#enfoque-issue-first), lo que significa que todos los [Pull Requests (PRs)](#enviar-un-pull-request) deben estar vinculados primero a un Issue de GitHub. Por favor, revisa esta guía cuidadosamente.
 
 ## Tabla de Contenidos
 
-- [I. Antes de Contribuir](#i-antes-de-contribuir)
-    - [1. Código de Conducta](#1-código-de-conducta)
-    - [2. Entender la Hoja de Ruta del Proyecto](#2-entender-la-hoja-de-ruta-del-proyecto)
-        - [Confiabilidad Primero](#confiabilidad-primero)
-        - [Experiencia de Usuario Mejorada](#experiencia-de-usuario-mejorada)
-        - [Liderazgo en Rendimiento de Agentes](#liderazgo-en-rendimiento-de-agentes)
-    - [3. Únete a la Comunidad Roo Code](#3-únete-a-la-comunidad-roo-code)
-- [II. Encontrar y Planificar tu Contribución](#ii-encontrar-y-planificar-tu-contribución)
-    - [1. Tipos de Contribuciones](#1-tipos-de-contribuciones)
-    - [2. Principio Clave: Enfoque Issue-First](#2-principio-clave-enfoque-issue-first)
-    - [3. Decidir en Qué Trabajar](#3-decidir-en-qué-trabajar)
-    - [4. Reportar Errores o Problemas](#4-reportar-errores-o-problemas)
-- [III. Proceso de Desarrollo y Envío](#iii-proceso-de-desarrollo-y-envío)
-    - [1. Configuración de Desarrollo](#1-configuración-de-desarrollo)
-    - [2. Guía para Escribir Código](#2-guía-para-escribir-código)
-    - [3. Enviar Código: Proceso de Pull Request (PR)](#3-enviar-código-proceso-de-pull-request-pr)
-        - [Pull Requests en Borrador](#pull-requests-en-borrador)
-        - [Descripción del Pull Request](#descripción-del-pull-request)
-        - [Política de Pull Request (PR)](#política-de-pull-request-pr)
-            - [Objetivo](#objetivo)
-            - [Enfoque Issue-First](#enfoque-issue-first)
-            - [Condiciones para PRs Abiertos](#condiciones-para-prs-abiertos)
-            - [Procedimiento](#procedimiento)
-            - [Responsabilidades](#responsabilidades)
-- [IV. Legal](#iv-legal)
-    - [Acuerdo de Contribución](#acuerdo-de-contribución)
-
-## I. Antes de Contribuir
-
-Primero, familiarízate con nuestros estándares comunitarios y la dirección del proyecto.
+- [Antes de Contribuir](#antes-de-contribuir)
+- [Encontrar y Planificar tu Contribución](#encontrar-y-planificar-tu-contribución)
+- [Proceso de Desarrollo y Envío](#proceso-de-desarrollo-y-envío)
+- [Legal](#legal)
 
-### 1. Código de Conducta
-
-Todos los colaboradores deben cumplir con nuestro [Código de Conducta](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Por favor, léelo antes de contribuir.
+## Antes de Contribuir
 
-### 2. Entender la Hoja de Ruta del Proyecto
+### 1. Código de Conducta
 
-Roo Code tiene una hoja de ruta clara que guía nuestras prioridades y dirección futura. Entenderla te ayuda a:
+Todos los colaboradores deben adherirse a nuestro [Código de Conducta](./CODE_OF_CONDUCT.md).
 
-- Alinear tus contribuciones con los objetivos del proyecto
-- Identificar áreas donde tu experiencia es más valiosa
-- Comprender el contexto detrás de ciertas decisiones de diseño
-- Inspirarte para nuevas funciones que apoyen nuestra visión
+### 2. Hoja de Ruta del Proyecto
 
-Nos enfocamos en hacer de Roo Code la mejor opción para desarrolladores que construyen con herramientas de codificación impulsadas por IA. Así es como lo lograremos:
+Nuestra hoja de ruta guía la dirección del proyecto. Alinea tus contribuciones con estos objetivos clave:
 
-#### Confiabilidad Primero
+### Confiabilidad Primero
 
 - Garantizar que la edición de diferencias y la ejecución de comandos sean consistentemente confiables.
 - Reducir los puntos de fricción que disuaden el uso regular.
 - Garantizar un funcionamiento fluido en todos los idiomas y plataformas.
 - Ampliar el soporte sólido para una amplia variedad de proveedores y modelos de IA.
 
-#### Experiencia de Usuario Mejorada
+### Experiencia de Usuario Mejorada
 
 - Simplificar la interfaz de usuario para mayor claridad e intuitividad.
 - Mejorar continuamente el flujo de trabajo para satisfacer las altas expectativas que los desarrolladores tienen para herramientas de uso diario.
 
-#### Liderazgo en Rendimiento de Agentes
+### Liderazgo en Rendimiento de Agentes
 
 - Establecer evaluaciones comparativas completas (evals) para medir la productividad en el mundo real.
 - Facilitar que todos puedan ejecutar e interpretar estas evaluaciones fácilmente.
-- Ofrecer mejoras a Roo Code que demuestren aumentos claros en las puntuaciones de evaluación.
+- Ofrecer mejoras que demuestren aumentos claros en las puntuaciones de evaluación.
 
-Agradecemos especialmente las contribuciones que avancen los objetivos de nuestra hoja de ruta. Si trabajas en algo alineado con estos pilares, menciónalo en la descripción de tu PR.
+Menciona la alineación con estas áreas en tus PRs.
 
 ### 3. Únete a la Comunidad Roo Code
 
-Conectarte con la comunidad Roo Code es una excelente manera de empezar:
-
-- **Método principal**:
-    1.  Únete a la [comunidad Roo Code en Discord](https://discord.gg/roocode).
-    2.  Una vez dentro, envía un mensaje directo (DM) a **Hannes Rudolph** (Discord: `hrudolph`) para comentar tu interés y recibir orientación.
-- **Alternativa para colaboradores experimentados**: Si te sientes cómodo con el enfoque issue-first, puedes participar directamente en GitHub siguiendo el [tablero Kanban](https://github.com/orgs/RooVetGit/projects/1) y comunicándote mediante issues y pull requests.
-
-## II. Encontrar y Planificar tu Contribución
-
-Identifica en qué te gustaría trabajar y cómo abordarlo.
-
-### 1. Tipos de Contribuciones
+- **Principal:** Únete a nuestro [Discord](https://discord.gg/roocode) y envía un DM a **Hannes Rudolph (`hrudolph`)**.
+- **Alternativa:** Los colaboradores experimentados pueden participar directamente a través de [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Aceptamos varios tipos de contribuciones:
+## Encontrar y Planificar tu Contribución
 
-- **Corrección de errores**: Solucionar problemas en el código existente.
-- **Nuevas funciones**: Añadir nuevas funcionalidades.
-- **Documentación**: Mejorar guías, ejemplos o corregir errores tipográficos.
+### Tipos de Contribuciones
 
-### 2. Principio Clave: Enfoque Issue-First
+- **Corrección de errores:** Solucionar problemas en el código.
+- **Nuevas funciones:** Añadir funcionalidades.
+- **Documentación:** Mejorar guías y claridad.
 
-**Todas las contribuciones deben comenzar con un Issue de GitHub.** Este paso es fundamental para asegurar la alineación y evitar esfuerzos innecesarios.
+### Enfoque Issue-First
 
-- **Buscar o crear un Issue**:
-    - Antes de empezar, busca en [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) si ya existe un issue para tu contribución.
-    - Si existe y no está asignado, comenta en el issue para expresar tu interés. Un mantenedor te lo asignará.
-    - Si no existe, crea uno nuevo usando la plantilla adecuada en nuestra [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Para errores, usa la plantilla "Bug Report".
-        - Para nuevas funciones, usa la plantilla "Detailed Feature Proposal". Espera la aprobación de un mantenedor (especialmente @hannesrudolph) antes de empezar a implementar.
-        - **Nota**: Las ideas generales o discusiones preliminares sobre funciones pueden comenzar en [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Cuando la idea sea más concreta, se debe crear un issue de "Detailed Feature Proposal".
-- **Reclamar y asignar**:
-    - Indica claramente tu intención de trabajar en un issue comentando en él.
-    - Espera a que un mantenedor te lo asigne oficialmente en GitHub. Así evitamos que varias personas trabajen en lo mismo.
-- **Consecuencias de no seguirlo**:
-    - Los Pull Requests (PRs) enviados sin un issue correspondiente, preaprobado y asignado pueden cerrarse sin revisión completa. Esta política existe para asegurar que las contribuciones estén alineadas con las prioridades del proyecto y para respetar el tiempo de todos.
+Todas las contribuciones deben comenzar con un Issue de GitHub.
 
-Este enfoque nos ayuda a rastrear el trabajo, asegurar que los cambios sean deseados y coordinar los esfuerzos de manera efectiva.
+- **Revisar issues existentes**: Busca en [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Crear un issue**: Usa las plantillas apropiadas:
+    - **Errores:** Plantilla "Bug Report".
+    - **Funciones:** Plantilla "Detailed Feature Proposal". Se requiere aprobación antes de comenzar.
+- **Reclamar issues**: Comenta y espera la asignación oficial.
 
-### 3. Decidir en Qué Trabajar
+**Los PRs sin issues aprobados pueden ser cerrados.**
 
-- **Good First Issues**: Consulta la sección "Issue [Unassigned]" de nuestro [Proyecto Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) en GitHub.
-- **Documentación**: Aunque este `CONTRIBUTING.md` es la guía principal para contribuciones de código, si te interesa contribuir a otra documentación (como guías de usuario o API), revisa el [repositorio Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) o pregunta en la comunidad de Discord.
-- **Proponer nuevas funciones**:
-    1.  **Idea inicial/discusión**: Para ideas generales o iniciales, inicia una conversación en [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Propuesta formal**: Para propuestas específicas y listas para consideración, crea un issue de "Detailed Feature Proposal" usando la plantilla en nuestra [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Esto es clave en nuestro **enfoque Issue-First**.
+### Decidir en Qué Trabajar
 
-### 4. Reportar Errores o Problemas
+- Revisa el [Proyecto GitHub](https://github.com/orgs/RooVetGit/projects/1) para "Good First Issues" no asignados.
+- Para documentación, visita [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Si encuentras un error:
+### Reportar Errores
 
-1.  **Buscar issues existentes**: Revisa [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) para ver si ya está reportado.
-2.  **Crear un nuevo issue**: Si es único, usa la plantilla "Bug Report" en nuestra [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Primero verifica si ya existen reportes.
+- Crea nuevos reportes de errores usando la [plantilla "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Problemas de seguridad**: Reporta de forma privada a través de [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Vulnerabilidades de seguridad**: Si descubres una vulnerabilidad de seguridad, repórtala de forma privada usando la [herramienta de avisos de seguridad de GitHub](https://github.com/RooVetGit/Roo-Code/security/advisories/new). No crees un issue público para vulnerabilidades de seguridad.
+## Proceso de Desarrollo y Envío
 
-## III. Proceso de Desarrollo y Envío
+### Configuración de Desarrollo
 
-Sigue estos pasos para programar y enviar tu trabajo.
+1. **Fork & Clona:**
 
-### 1. Configuración de Desarrollo
-
-1.  **Fork & Clona**:
-    - Haz un fork del repositorio en GitHub.
-    - Clona tu fork localmente: `git clone https://github.com/TU_USUARIO/Roo-Code.git`
-2.  **Instala dependencias**: `npm run install:all`
-3.  **Ejecuta Webview (modo dev)**: `npm run dev` (para la app Vite/React con HMR)
-4.  **Depura la extensión**: Pulsa `F5` en VS Code (o **Run** → **Start Debugging**) para abrir una nueva ventana Extension Development Host con Roo Code cargado.
-
-Los cambios en webview (`webview-ui`) aparecerán inmediatamente gracias a Hot Module Replacement. Los cambios en la extensión principal (`src`) requerirán reiniciar el Extension Development Host.
-
-Alternativamente, para construir e instalar un paquete `.vsix`:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/TU_USUARIO/Roo-Code.git
 ```
 
-(Reemplaza `<version>` por el número de versión real del archivo generado).
-
-### 2. Guía para Escribir Código
-
-- **PRs enfocados**: Un feature/fix por PR.
-- **Calidad de código**:
-    - Pasar los checks de CI (lint, formato)
-    - Corregir advertencias o errores de ESLint (`npm run lint`)
-    - Responder a feedback de herramientas automáticas de revisión de código
-    - Seguir buenas prácticas de TypeScript y mantener la seguridad de tipos
-- **Pruebas**:
-    - Añadir tests para nuevas funciones
-    - Ejecutar `npm test` para asegurar que todo pasa
-    - Actualizar tests existentes si tu cambio los afecta
-- **Mensajes de commit**:
-    - Escribir mensajes claros y descriptivos
-    - Referenciar issues relevantes usando `#número-issue` (ej: `Fixes #123`)
-- **Checklist antes de enviar PR**:
-    - Rebasear tu rama sobre el último `main` del upstream
-    - Asegurarte de que el código compila (`npm run build`)
-    - Verificar que todos los tests pasan (`npm test`)
-    - Eliminar cualquier código de depuración o `console.log`
-
-### 3. Enviar Código: Proceso de Pull Request (PR)
-
-#### Pull Requests en Borrador
-
-Usa PRs en borrador para trabajo que aún no está listo para revisión completa pero para el que quieres:
-
-- Ejecutar checks automáticos (CI)
-- Recibir feedback temprano de mantenedores u otros colaboradores
-- Señalar que el trabajo está en progreso
-
-Marca un PR como "Listo para revisión" solo cuando todos los checks pasen y creas que cumple con los criterios de "Guía para Escribir Código" y "Descripción del Pull Request".
-
-#### Descripción del Pull Request
-
-La descripción de tu PR debe ser completa y seguir la estructura de nuestra [Plantilla de Pull Request](.github/pull_request_template.md). Elementos clave:
-
-- Un enlace al Issue de GitHub aprobado que aborda
-- Descripción clara de los cambios realizados y su propósito
-- Pasos detallados para probar los cambios
-- Lista de cualquier cambio importante (breaking changes)
-- **Para cambios de UI, proporciona capturas de pantalla o videos del antes y después**
-- **Indica si tu PR requiere actualizar documentación de usuario y cuáles documentos o secciones se ven afectados**
-
-#### Política de Pull Request (PR)
-
-##### Objetivo
-
-Mantener un backlog de PRs limpio, enfocado y manejable.
+2. **Instalar Dependencias:**
 
-##### Enfoque Issue-First
+```
+npm run install:all
+```
 
-- **Requerido**: Antes de empezar, debe existir un Issue de GitHub aprobado y asignado (ya sea "Bug Report" o "Detailed Feature Proposal").
-- **Aprobación**: Los Issues, especialmente los de cambios importantes, deben ser revisados y aprobados por los mantenedores (especialmente @hannesrudolph) _antes_ de comenzar a programar.
-- **Referencia**: Los PRs deben referenciar explícitamente estos Issues preaprobados en su descripción.
-- **Consecuencias**: No seguir este proceso puede resultar en el cierre del PR sin revisión completa.
+3. **Depuración:** Abre con VS Code (`F5`).
 
-##### Condiciones para PRs Abiertos
+### Guía para Escribir Código
 
-- **Listo para merge**: Pasa todos los tests de CI, se alinea con la hoja de ruta del proyecto (si aplica), está vinculado a un Issue aprobado y asignado, tiene documentación/comentarios claros, incluye imágenes o videos de antes y después para cambios de UI
-- **Para cerrar**: Falla en tests de CI, conflictos de merge importantes, desalineación con los objetivos del proyecto o inactividad prolongada (>30 días sin actualizaciones tras feedback)
+- Un PR enfocado por función o corrección.
+- Sigue las mejores prácticas de ESLint y TypeScript.
+- Escribe commits claros y descriptivos que referencien issues (ej., `Fixes #123`).
+- Proporciona pruebas exhaustivas (`npm test`).
+- Rebase sobre la última rama `main` antes de enviar.
 
-##### Procedimiento
+### Enviar un Pull Request
 
-1.  **Calificación y asignación de Issues**: @hannesrudolph (u otros mantenedores) revisan y asignan Issues nuevos y existentes.
-2.  **Triage inicial de PRs (diario)**: Los mantenedores hacen una revisión rápida de los PRs entrantes para filtrar urgencias o problemas críticos.
-3.  **Revisión exhaustiva de PRs (semanal)**: Los mantenedores revisan a fondo los PRs para evaluar preparación, alineación con el Issue aprobado y calidad general.
-4.  **Feedback detallado e iteración**: Según la revisión, los mantenedores dan feedback (Aprobar, Solicitar cambios o Rechazar). Se espera que los colaboradores respondan y mejoren según sea necesario.
-5.  **Etapa de decisión**: Los PRs aprobados se fusionan. Los PRs con problemas irresolubles o desalineados pueden cerrarse con una explicación clara.
-6.  **Seguimiento**: Los autores de PRs cerrados pueden abordar el feedback y abrir nuevos si se resuelven los problemas o cambia la dirección del proyecto.
+- Comienza como **PR en Borrador** si buscas feedback temprano.
+- Describe claramente tus cambios siguiendo la Plantilla de Pull Request.
+- Proporciona capturas de pantalla/videos para cambios en la UI.
+- Indica si son necesarias actualizaciones de documentación.
 
-##### Responsabilidades
+### Política de Pull Request
 
-- **Calificación de Issues y cumplimiento del proceso (@hannesrudolph & mantenedores)**: Asegurar que todas las contribuciones sigan el enfoque Issue-First. Guiar a los colaboradores en el proceso.
-- **Mantenedores (equipo de desarrollo)**: Revisar PRs, dar feedback técnico, tomar decisiones de aprobación/rechazo y fusionar PRs.
-- **Colaboradores**: Asegurar que los PRs estén vinculados a un Issue aprobado y asignado, cumplan con las guías de calidad y respondan rápidamente al feedback.
+- Debe referenciar issues preaprobados y asignados.
+- Los PRs que no cumplan con la política pueden ser cerrados.
+- Los PRs deben pasar las pruebas de CI, alinearse con la hoja de ruta y tener documentación clara.
 
-Esta política asegura claridad e integración eficiente.
+### Proceso de Revisión
 
-## IV. Legal
+- **Triage Diario:** Revisiones rápidas por parte de los mantenedores.
+- **Revisión Semanal en Profundidad:** Evaluación integral.
+- **Itera rápidamente** basándote en el feedback.
 
-### Acuerdo de Contribución
+## Legal
 
-Al enviar un pull request, aceptas que tus contribuciones se licenciarán bajo la [Licencia Apache 2.0](LICENSE) (o la licencia actual del proyecto), igual que el proyecto.
+Al contribuir, aceptas que tus contribuciones serán licenciadas bajo la Licencia Apache 2.0, consistente con la licencia de Roo Code.

locales/fr/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Contribuer à Roo Code
 
-Roo Code est un projet porté par la communauté et chaque contribution compte beaucoup pour nous. Pour garantir un processus fluide et efficace, **nous fonctionnons selon le principe "[Issue-First](#2-principe-clé-approche-issue-first)".** Cela signifie que tout travail doit être lié à un ticket GitHub _avant_ de soumettre une Pull Request (voir notre [Politique PR](#politique-de-pull-request-pr) pour plus de détails). Lis attentivement ce guide pour comprendre comment contribuer.
-Ce guide explique comment contribuer à Roo Code, que ce soit pour corriger des bugs, ajouter des fonctionnalités ou améliorer la documentation.
+Roo Code est un projet porté par la communauté, et chaque contribution compte beaucoup pour nous. Pour fluidifier la collaboration, nous fonctionnons selon une [approche Issue-First](#approche-issue-first), ce qui signifie que toutes les [Pull Requests (PRs)](#soumettre-une-pull-request) doivent d'abord être liées à un ticket GitHub. Lis attentivement ce guide.
 
 ## Table des matières
 
-- [I. Avant de contribuer](#i-avant-de-contribuer)
-    - [1. Code de conduite](#1-code-de-conduite)
-    - [2. Comprendre la feuille de route du projet](#2-comprendre-la-feuille-de-route-du-projet)
-        - [Fiabilité avant tout](#fiabilité-avant-tout)
-        - [Expérience utilisateur améliorée](#expérience-utilisateur-améliorée)
-        - [Leadership en performance des agents](#leadership-en-performance-des-agents)
-    - [3. Rejoindre la communauté Roo Code](#3-rejoindre-la-communauté-roo-code)
-- [II. Trouver et planifier ta contribution](#ii-trouver-et-planifier-ta-contribution)
-    - [1. Types de contributions](#1-types-de-contributions)
-    - [2. Principe clé : Approche Issue-First](#2-principe-clé--approche-issue-first)
-    - [3. Décider sur quoi travailler](#3-décider-sur-quoi-travailler)
-    - [4. Signaler des bugs ou des problèmes](#4-signaler-des-bugs-ou-des-problèmes)
-- [III. Processus de développement et de soumission](#iii-processus-de-développement-et-de-soumission)
-    - [1. Configuration du développement](#1-configuration-du-développement)
-    - [2. Guide d’écriture du code](#2-guide-décriture-du-code)
-    - [3. Soumettre du code : Processus de Pull Request (PR)](#3-soumettre-du-code--processus-de-pull-request-pr)
-        - [Pull Requests en brouillon](#pull-requests-en-brouillon)
-        - [Description de la Pull Request](#description-de-la-pull-request)
-        - [Politique de Pull Request (PR)](#politique-de-pull-request-pr)
-            - [Objectif](#objectif)
-            - [Approche Issue-First](#approche-issue-first)
-            - [Conditions pour les PR ouvertes](#conditions-pour-les-pr-ouvertes)
-            - [Procédure](#procédure)
-            - [Responsabilités](#responsabilités)
-- [IV. Légal](#iv-légal)
-    - [Accord de contribution](#accord-de-contribution)
-
-## I. Avant de contribuer
-
-Commence par te familiariser avec nos standards communautaires et la direction du projet.
+- [Avant de contribuer](#avant-de-contribuer)
+- [Trouver et planifier ta contribution](#trouver-et-planifier-ta-contribution)
+- [Processus de développement et de soumission](#processus-de-développement-et-de-soumission)
+- [Légal](#légal)
 
-### 1. Code de conduite
-
-Tous les contributeurs doivent respecter notre [Code de conduite](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Merci de le lire avant de contribuer.
+## Avant de contribuer
 
-### 2. Comprendre la feuille de route du projet
+### 1. Code de conduite
 
-Roo Code a une feuille de route claire qui guide nos priorités et notre direction future. La comprendre t’aide à :
+Tous les contributeurs doivent respecter notre [Code de conduite](./CODE_OF_CONDUCT.md).
 
-- Aligner tes contributions avec les objectifs du projet
-- Identifier les domaines où tes compétences sont les plus utiles
-- Comprendre le contexte de certaines décisions de conception
-- Trouver l’inspiration pour de nouvelles fonctionnalités qui soutiennent notre vision
+### 2. Feuille de route du projet
 
-Nous nous concentrons sur l'objectif de faire de Roo Code le meilleur choix pour les développeurs utilisant des outils de codage basés sur l'IA. Voici comment nous comptons y parvenir :
+Notre feuille de route guide la direction du projet. Aligne tes contributions avec ces objectifs clés :
 
-#### Fiabilité avant tout
+### Fiabilité avant tout
 
-- Garantir que l'édition des différences et l'exécution des commandes soient toujours fiables
-- Réduire les points de friction qui découragent l'utilisation régulière
-- Assurer un fonctionnement fluide dans toutes les langues et sur toutes les plateformes
-- Étendre le support robuste pour une grande variété de fournisseurs et de modèles d'IA
+- Garantir que l'édition des différences et l'exécution des commandes soient toujours fiables.
+- Réduire les points de friction qui découragent l'utilisation régulière.
+- Assurer un fonctionnement fluide dans toutes les langues et sur toutes les plateformes.
+- Étendre le support robuste pour une grande variété de fournisseurs et de modèles d'IA.
 
-#### Expérience utilisateur améliorée
+### Expérience utilisateur améliorée
 
-- Simplifier l'interface utilisateur pour plus de clarté et d'intuitivité
-- Améliorer continuellement le flux de travail pour répondre aux attentes élevées des développeurs concernant les outils d'usage quotidien
+- Simplifier l'interface utilisateur pour plus de clarté et d'intuitivité.
+- Améliorer continuellement le flux de travail pour répondre aux attentes élevées des développeurs.
 
-#### Leadership en performance des agents
+### Leadership en performance des agents
 
-- Établir des référentiels d'évaluation (evals) complets pour mesurer la productivité réelle
-- Permettre à chacun d'exécuter et d'interpréter facilement ces évaluations
-- Fournir des améliorations à Roo Code qui démontrent des augmentations claires dans les scores d'évaluation
+- Établir des référentiels d'évaluation (evals) complets pour mesurer la productivité réelle.
+- Permettre à chacun d'exécuter et d'interpréter facilement ces évaluations.
+- Fournir des améliorations qui démontrent des augmentations claires dans les scores d'évaluation.
 
-Nous accueillons particulièrement les contributions qui font avancer les objectifs de notre feuille de route. Si tu travailles sur quelque chose qui s’aligne avec ces piliers, mentionne-le dans la description de ta PR.
+Mentionne l'alignement avec ces domaines dans tes PRs.
 
 ### 3. Rejoindre la communauté Roo Code
 
-Se connecter à la communauté Roo Code est un excellent moyen de commencer :
-
-- **Méthode principale** :
-    1.  Rejoins la [communauté Roo Code sur Discord](https://discord.gg/roocode).
-    2.  Une fois inscrit, envoie un message privé (DM) à **Hannes Rudolph** (Discord : `hrudolph`) pour discuter de ton intérêt et obtenir des conseils.
-- **Alternative pour les contributeurs expérimentés** : Si tu es à l’aise avec l’approche issue-first, tu peux participer directement sur GitHub en suivant le [tableau Kanban](https://github.com/orgs/RooVetGit/projects/1) et en communiquant via issues et pull requests.
-
-## II. Trouver et planifier ta contribution
-
-Identifie ce sur quoi tu veux travailler et comment t’y prendre.
-
-### 1. Types de contributions
+- **Principal :** Rejoins notre [Discord](https://discord.gg/roocode) et envoie un DM à **Hannes Rudolph (`hrudolph`)**.
+- **Alternative :** Les contributeurs expérimentés peuvent participer directement via [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Nous acceptons différents types de contributions :
+## Trouver et planifier ta contribution
 
-- **Corrections de bugs** : Résoudre des problèmes dans le code existant.
-- **Nouvelles fonctionnalités** : Ajouter de nouvelles fonctions.
-- **Documentation** : Améliorer les guides, exemples ou corriger des fautes de frappe.
+### Types de contributions
 
-### 2. Principe clé : Approche Issue-First
+- **Corrections de bugs :** Résoudre des problèmes dans le code.
+- **Nouvelles fonctionnalités :** Ajouter de nouvelles fonctions.
+- **Documentation :** Améliorer les guides et la clarté.
 
-**Toutes les contributions doivent commencer par un ticket GitHub.** C’est essentiel pour garantir l’alignement et éviter les efforts inutiles.
+### Approche Issue-First
 
-- **Trouver ou créer un ticket** :
-    - Avant de commencer, cherche dans les [Issues GitHub](https://github.com/RooVetGit/Roo-Code/issues) si un ticket existe déjà pour ta contribution.
-    - S’il existe et n’est pas assigné, commente pour exprimer ton intérêt. Un mainteneur te l’assignera.
-    - S’il n’existe pas, crée-en un nouveau avec le bon modèle sur notre [page d’issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose) :
-        - Pour les bugs, utilise le modèle "Bug Report".
-        - Pour les nouvelles fonctionnalités, utilise le modèle "Detailed Feature Proposal". Attends l’approbation d’un mainteneur (surtout @hannesrudolph) avant de commencer à coder.
-        - **Note** : Les idées générales ou discussions préliminaires peuvent commencer dans [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Une fois l’idée plus concrète, crée un ticket "Detailed Feature Proposal".
-- **Réclamer et assigner** :
-    - Indique clairement ton intention de travailler sur un ticket en commentant dessus.
-    - Attends qu’un mainteneur te l’assigne officiellement sur GitHub. Cela évite que plusieurs personnes travaillent sur la même chose.
-- **Conséquences si tu ne respectes pas** :
-    - Les Pull Requests (PR) soumises sans ticket correspondant, pré-approuvé et assigné peuvent être fermées sans examen complet. Cette politique vise à garantir l’alignement des contributions avec les priorités du projet et à respecter le temps de chacun.
+Toutes les contributions doivent commencer par un ticket GitHub.
 
-Cette approche nous aide à suivre le travail, à garantir que les changements sont souhaités et à coordonner efficacement les efforts.
+- **Vérifier les tickets existants :** Cherche dans les [Issues GitHub](https://github.com/RooVetGit/Roo-Code/issues).
+- **Créer un ticket :** Utilise les modèles appropriés :
+    - **Bugs :** Modèle "Bug Report".
+    - **Fonctionnalités :** Modèle "Detailed Feature Proposal". Approbation requise avant de commencer.
+- **Réclamer des tickets :** Commente et attends l'assignation officielle.
 
-### 3. Décider sur quoi travailler
+**Les PRs sans tickets approuvés peuvent être fermées.**
 
-- **Good First Issues** : Consulte la section "Issue [Unassigned]" de notre [projet Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) sur GitHub.
-- **Documentation** : Bien que ce `CONTRIBUTING.md` soit le guide principal pour les contributions de code, si tu veux contribuer à d’autres docs (guides utilisateurs ou API), consulte le [repo Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) ou demande sur Discord.
-- **Proposer de nouvelles fonctionnalités** :
-    1.  **Idée/discussion initiale** : Pour des idées larges ou nouvelles, commence une discussion dans [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Proposition formelle** : Pour des propositions spécifiques et prêtes à être examinées, crée un ticket "Detailed Feature Proposal" avec le modèle sur notre [page d’issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). C’est une étape clé de notre **approche Issue-First**.
+### Décider sur quoi travailler
 
-### 4. Signaler des bugs ou des problèmes
+- Consulte le [Projet GitHub](https://github.com/orgs/RooVetGit/projects/1) pour les "Good First Issues" non assignés.
+- Pour la documentation, visite [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Si tu trouves un bug :
+### Signaler des bugs
 
-1.  **Cherche des tickets existants** : Consulte les [Issues GitHub](https://github.com/RooVetGit/Roo-Code/issues) pour voir si le problème a déjà été signalé.
-2.  **Crée un nouveau ticket** : Si c’est unique, utilise le modèle "Bug Report" sur notre [page d’issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Vérifie d'abord les rapports existants.
+- Crée de nouveaux rapports de bugs avec le [modèle "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Failles de sécurité :** Signale-les en privé via [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Vulnérabilités de sécurité** : Si tu découvres une faille de sécurité, signale-la en privé via l’[outil d’avis de sécurité GitHub](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Ne crée pas de ticket public pour les failles de sécurité.
+## Processus de développement et de soumission
 
-## III. Processus de développement et de soumission
+### Configuration du développement
 
-Suis ces étapes pour coder et soumettre ton travail.
+1. **Fork & Clone :**
 
-### 1. Configuration du développement
-
-1.  **Fork & Clone** :
-    - Forke le repo sur GitHub.
-    - Clone ton fork localement : `git clone https://github.com/TON_UTILISATEUR/Roo-Code.git`
-2.  **Installe les dépendances** : `npm run install:all`
-3.  **Lance le Webview (mode dev)** : `npm run dev` (pour l’app Vite/React avec HMR)
-4.  **Débugge l’extension** : Appuie sur `F5` dans VS Code (ou **Run** → **Start Debugging**) pour ouvrir une nouvelle fenêtre Extension Development Host avec Roo Code chargé.
-
-Les changements dans le webview (`webview-ui`) apparaîtront immédiatement grâce au Hot Module Replacement. Les changements dans l’extension principale (`src`) nécessitent de redémarrer l’Extension Development Host.
-
-Tu peux aussi construire et installer un paquet `.vsix` :
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/TON_UTILISATEUR/Roo-Code.git
 ```
 
-(Remplace `<version>` par le numéro de version réel du fichier généré).
-
-### 2. Guide d’écriture du code
-
-- **PRs ciblées** : Une fonctionnalité/correction par PR.
-- **Qualité du code** :
-    - Passer les checks CI (lint, formatage)
-    - Corriger les avertissements ou erreurs ESLint (`npm run lint`)
-    - Répondre au feedback des outils automatiques de revue de code
-    - Suivre les bonnes pratiques TypeScript et maintenir la sécurité des types
-- **Tests** :
-    - Ajouter des tests pour les nouvelles fonctionnalités
-    - Lancer `npm test` pour s’assurer que tout passe
-    - Mettre à jour les tests existants si besoin
-- **Messages de commit** :
-    - Rédiger des messages clairs et descriptifs
-    - Référencer les tickets concernés avec `#numéro-issue` (ex : `Fixes #123`)
-- **Checklist avant de soumettre une PR** :
-    - Rebaser ta branche sur le dernier `main` de l’upstream
-    - Vérifier que le code compile (`npm run build`)
-    - S’assurer que tous les tests passent (`npm test`)
-    - Supprimer tout code de debug ou `console.log`
-
-### 3. Soumettre du code : Processus de Pull Request (PR)
-
-#### Pull Requests en brouillon
-
-Utilise les PRs en brouillon pour du travail pas encore prêt pour une revue complète mais pour lequel tu veux :
-
-- Lancer les checks automatiques (CI)
-- Obtenir un feedback précoce des mainteneurs ou d’autres contributeurs
-- Signaler que le travail est en cours
-
-Marque une PR comme "Prête pour revue" seulement quand tous les checks passent et que tu penses qu’elle respecte les critères du "Guide d’écriture du code" et de la "Description de la Pull Request".
-
-#### Description de la Pull Request
-
-La description de ta PR doit être complète et suivre la structure de notre [Modèle de Pull Request](.github/pull_request_template.md). Points clés :
-
-- Un lien vers le ticket GitHub approuvé concerné
-- Une description claire des changements et de leur but
-- Des étapes détaillées pour tester les changements
-- Une liste de tout changement majeur (breaking change)
-- **Pour les changements UI, fournis des captures d’écran ou vidéos avant/après**
-- **Indique si ta PR nécessite une mise à jour de la doc utilisateur et quels documents/sections sont concernés**
-
-#### Politique de Pull Request (PR)
-
-##### Objectif
-
-Maintenir un backlog de PR propre, ciblé et gérable.
+2. **Installer les dépendances :**
 
-##### Approche Issue-First
+```
+npm run install:all
+```
 
-- **Obligatoire** : Avant de commencer, il doit exister un ticket GitHub approuvé et assigné (soit "Bug Report" soit "Detailed Feature Proposal").
-- **Approbation** : Les tickets, surtout pour les changements importants, doivent être revus et approuvés par les mainteneurs (notamment @hannesrudolph) _avant_ de commencer à coder.
-- **Référence** : Les PRs doivent référencer explicitement ces tickets pré-approuvés dans leur description.
-- **Conséquences** : Ne pas suivre ce processus peut entraîner la fermeture de la PR sans revue complète.
+3. **Débogage :** Ouvre avec VS Code (`F5`).
 
-##### Conditions pour les PR ouvertes
+### Guide d'écriture du code
 
-- **Prête à merger** : Passe tous les tests CI, s’aligne avec la feuille de route (si applicable), est liée à un ticket approuvé et assigné, a une doc/commentaires clairs, inclut des images/vidéos avant/après pour les changements UI
-- **À fermer** : Échecs CI, conflits de merge importants, désalignement avec les objectifs du projet ou inactivité prolongée (>30 jours sans mise à jour après feedback)
+- Une PR ciblée par fonctionnalité ou correction.
+- Suis les bonnes pratiques ESLint et TypeScript.
+- Écris des commits clairs et descriptifs référençant les tickets (ex : `Fixes #123`).
+- Fournis des tests complets (`npm test`).
+- Rebase sur la dernière branche `main` avant de soumettre.
 
-##### Procédure
+### Soumettre une Pull Request
 
-1.  **Qualification & assignation des tickets** : @hannesrudolph (ou d’autres mainteneurs) examinent et assignent les nouveaux tickets.
-2.  **Triage initial des PRs (quotidien)** : Les mainteneurs font un premier tri rapide des PRs entrantes pour filtrer les urgences ou problèmes critiques.
-3.  **Revue approfondie des PRs (hebdo)** : Les mainteneurs examinent en détail les PRs pour évaluer leur préparation, leur alignement avec le ticket approuvé et leur qualité globale.
-4.  **Feedback détaillé & itération** : Selon la revue, les mainteneurs donnent un feedback (Approuver, Demander des changements, Rejeter). Les contributeurs doivent répondre et améliorer si besoin.
-5.  **Décision** : Les PRs approuvées sont mergées. Les PRs avec des problèmes non résolus ou désalignées peuvent être fermées avec explication.
-6.  **Suivi** : Les auteurs de PRs fermées peuvent corriger et ouvrir de nouvelles PRs si les problèmes sont résolus ou si la direction du projet change.
+- Commence par un **brouillon de PR** si tu cherches un feedback précoce.
+- Décris clairement tes changements en suivant le modèle de Pull Request.
+- Fournis des captures d'écran/vidéos pour les changements d'interface.
+- Indique si des mises à jour de documentation sont nécessaires.
 
-##### Responsabilités
+### Politique de Pull Request
 
-- **Qualification des tickets & respect du process (@hannesrudolph & mainteneurs)** : S’assurer que toutes les contributions suivent l’approche Issue-First. Guider les contributeurs.
-- **Mainteneurs (équipe dev)** : Revoir les PRs, donner un feedback technique, prendre les décisions d’approbation/rejet, merger les PRs.
-- **Contributeurs** : S’assurer que les PRs sont liées à un ticket approuvé et assigné, respectent les guidelines de qualité et répondent rapidement au feedback.
+- Doit référencer des tickets pré-approuvés et assignés.
+- Les PRs ne respectant pas cette politique peuvent être fermées.
+- Les PRs doivent passer les tests CI, s'aligner avec la feuille de route et avoir une documentation claire.
 
-Cette politique garantit clarté et intégration efficace.
+### Processus de revue
 
-## IV. Légal
+- **Triage quotidien :** Vérifications rapides par les mainteneurs.
+- **Revue hebdomadaire approfondie :** Évaluation complète.
+- **Itère rapidement** sur la base du feedback.
 
-### Accord de contribution
+## Légal
 
-En soumettant une pull request, tu acceptes que tes contributions soient sous licence [Apache 2.0](LICENSE) (ou la licence actuelle du projet), comme le projet.
+En contribuant, tu acceptes que tes contributions soient sous licence Apache 2.0, conformément à la licence de Roo Code.

locales/hi/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Roo Code में योगदान करें
 
-Roo Code एक समुदाय-आधारित प्रोजेक्ट है और हम हर योगदान को बहुत महत्व देते हैं। सभी के लिए प्रक्रिया को आसान और प्रभावी बनाने के लिए, **हम "[Issue-First](#2-मुख्य-सिद्धांत-issue-first-एप्रोच)" पद्धति अपनाते हैं।** इसका मतलब है कि हर काम को Pull Request सबमिट करने से _पहले_ एक GitHub Issue से जोड़ा जाना चाहिए (विस्तार से जानने के लिए हमारी [PR नीति](#pull-request-pr-नीति) देखें)। कृपया इस गाइड को ध्यान से पढ़ें ताकि आप समझ सकें कि कैसे योगदान करें।
-यह गाइड बताता है कि Roo Code में कैसे योगदान करें, चाहे आप बग फिक्स कर रहे हों, फीचर जोड़ रहे हों या डाक्यूमेंटेशन सुधार रहे हों।
+Roo Code एक समुदाय-आधारित प्रोजेक्ट है और हम हर योगदान को बहुत महत्व देते हैं। सहयोग को सरल बनाने के लिए, हम [Issue-First](#issue-first-एप्रोच) पद्धति अपनाते हैं, जिसका अर्थ है कि सभी [Pull Requests (PRs)](#pull-request-सबमिट-करना) को पहले GitHub Issue से जोड़ना आवश्यक है। कृपया इस गाइड को ध्यान से पढ़ें।
 
 ## विषय सूची
 
-- [I. योगदान करने से पहले](#i-योगदान-करने-से-पहले)
-    - [1. आचार संहिता](#1-आचार-संहिता)
-    - [2. प्रोजेक्ट रोडमैप समझें](#2-प्रोजेक्ट-रोडमैप-समझें)
-        - [विश्वसनीयता पहले](#विश्वसनीयता-पहले)
-        - [बेहतर उपयोगकर्ता अनुभव](#बेहतर-उपयोगकर्ता-अनुभव)
-        - [एजेंट प्रदर्शन में अग्रणी](#एजेंट-प्रदर्शन-में-अग्रणी)
-    - [3. Roo Code कम्युनिटी से जुड़ें](#3-roo-code-कम्युनिटी-से-जुड़ें)
-- [II. अपना योगदान ढूंढना और योजना बनाना](#ii-अपना-योगदान-ढूंढना-और-योजना-बनाना)
-    - [1. योगदान के प्रकार](#1-योगदान-के-प्रकार)
-    - [2. मुख्य सिद्धांत: Issue-First एप्रोच](#2-मुख्य-सिद्धांत-issue-first-एप्रोच)
-    - [3. क्या काम करें चुनना](#3-क्या-काम-करें-चुनना)
-    - [4. बग या समस्या रिपोर्ट करना](#4-बग-या-समस्या-रिपोर्ट-करना)
-- [III. विकास और सबमिशन प्रक्रिया](#iii-विकास-और-सबमिशन-प्रक्रिया)
-    - [1. विकास सेटअप](#1-विकास-सेटअप)
-    - [2. कोड लिखने के दिशा-निर्देश](#2-कोड-लिखने-के-दिशा-निर्देश)
-    - [3. कोड सबमिट करना: Pull Request (PR) प्रक्रिया](#3-कोड-सबमिट-करना-pull-request-pr-प्रक्रिया)
-        - [ड्राफ्ट Pull Requests](#ड्राफ्ट-pull-requests)
-        - [Pull Request विवरण](#pull-request-विवरण)
-        - [Pull Request (PR) नीति](#pull-request-pr-नीति)
-            - [उद्देश्य](#उद्देश्य)
-            - [Issue-First एप्रोच](#issue-first-एप्रोच)
-            - [ओपन PR के लिए शर्तें](#ओपन-pr-के-लिए-शर्तें)
-            - [प्रक्रिया](#प्रक्रिया)
-            - [जिम्मेदारियां](#जिम्मेदारियां)
-- [IV. कानूनी](#iv-कानूनी)
-    - [योगदान समझौता](#योगदान-समझौता)
-
-## I. योगदान करने से पहले
-
-सबसे पहले, हमारे समुदाय मानकों और प्रोजेक्ट की दिशा को समझें।
+- [योगदान करने से पहले](#योगदान-करने-से-पहले)
+- [अपना योगदान ढूंढना और योजना बनाना](#अपना-योगदान-ढूंढना-और-योजना-बनाना)
+- [विकास और सबमिशन प्रक्रिया](#विकास-और-सबमिशन-प्रक्रिया)
+- [कानूनी](#कानूनी)
 
-### 1. आचार संहिता
-
-सभी योगदानकर्ताओं को हमारे [आचार संहिता](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md) का पालन करना चाहिए। कृपया योगदान करने से पहले इसे पढ़ें।
+## योगदान करने से पहले
 
-### 2. प्रोजेक्ट रोडमैप समझें
+### 1. आचार संहिता
 
-Roo Code के पास एक स्पष्ट विकास रोडमैप है जो हमारी प्राथमिकताओं और भविष्य की दिशा को दर्शाता है। इसे समझने से आपको मदद मिलेगी:
+सभी योगदानकर्ताओं को हमारी [आचार संहिता](./CODE_OF_CONDUCT.md) का पालन करना चाहिए।
 
-- अपने योगदान को प्रोजेक्ट के लक्ष्यों के साथ संरेखित करने में
-- उन क्षेत्रों की पहचान करने में जहां आपकी विशेषज्ञता सबसे अधिक उपयोगी हो सकती है
-- कुछ डिज़ाइन निर्णयों के पीछे का संदर्भ समझने में
-- नई विशेषताओं के लिए प्रेरणा पाने में जो हमारे विजन को सपोर्ट करती हैं
+### 2. प्रोजेक्ट रोडमैप
 
-हम Roo Code को AI-संचालित कोडिंग टूल्स के साथ काम करने वाले डेवलपर्स के लिए पहली पसंद बनाने पर ध्यान केंद्रित कर रहे हैं। यहां बताया गया है कि हम इसे कैसे हासिल करेंगे:
+हमारा रोडमैप प्रोजेक्ट की दिशा तय करता है। अपने योगदान को इन प्रमुख लक्ष्यों के साथ संरेखित करें:
 
-#### विश्वसनीयता पहले
+### विश्वसनीयता पहले
 
 - सुनिश्चित करें कि diff एडिटिंग और कमांड एक्जीक्यूशन लगातार विश्वसनीय हों
 - नियमित उपयोग को हतोत्साहित करने वाले फ्रिक्शन पॉइंट्स को कम करें
 - सभी भाषाओं और प्लेटफॉर्म्स पर सुचारू संचालन की गारंटी दें
 - विभिन्न AI प्रदाताओं और मॉडल्स के लिए मजबूत समर्थन का विस्तार करें
 
-#### बेहतर उपयोगकर्ता अनुभव
+### बेहतर उपयोगकर्ता अनुभव
 
 - स्पष्टता और सहजता के लिए UI/UX को सरल बनाएं
-- डेवलपर्स द्वारा दैनिक उपयोग के टूल्स के लिए अपेक्षित उच्च मानकों को पूरा करने के लिए वर्कफ़्लो में निरंतर सुधार करें
+- डेवलपर्स के उच्च अपेक्षाओं को पूरा करने के लिए वर्कफ़्लो में निरंतर सुधार करें
 
-#### एजेंट प्रदर्शन में अग्रणी
+### एजेंट प्रदर्शन में अग्रणी
 
 - वास्तविक दुनिया की उत्पादकता को मापने के लिए व्यापक मूल्यांकन बेंचमार्क (evals) स्थापित करें
 - हर किसी के लिए इन मूल्यांकनों को आसानी से चलाना और समझना संभव बनाएं
-- Roo Code में ऐसे सुधार लाएं जो मूल्यांकन स्कोर में स्पष्ट वृद्धि दिखाएं
+- ऐसे सुधार लाएं जो मूल्यांकन स्कोर में स्पष्ट वृद्धि दिखाएं
 
-हम उन योगदानों का विशेष स्वागत करते हैं जो हमारे रोडमैप लक्ष्यों को आगे बढ़ाते हैं। यदि आप किसी ऐसे काम पर हैं जो इन स्तंभों से मेल खाता है, तो कृपया इसे अपने PR विवरण में उल्लेख करें।
+अपने PR में इन क्षेत्रों से संबंधित कार्य का उल्लेख करें।
 
 ### 3. Roo Code कम्युनिटी से जुड़ें
 
-Roo Code कम्युनिटी से जुड़ना शुरू करने का एक शानदार तरीका है:
-
-- **मुख्य तरीका**:
-    1.  [Roo Code Discord कम्युनिटी](https://discord.gg/roocode) से जुड़ें।
-    2.  जुड़ने के बाद, **Hannes Rudolph** (Discord: `hrudolph`) को डायरेक्ट मैसेज (DM) भेजें, अपनी रुचि बताएं और मार्गदर्शन पाएं।
-- **अनुभवी योगदानकर्ताओं के लिए विकल्प**: यदि आप Issue-First एप्रोच में सहज हैं, तो सीधे GitHub पर [Kanban बोर्ड](https://github.com/orgs/RooVetGit/projects/1) फॉलो करें और Issues व Pull Requests के जरिए संवाद करें।
-
-## II. अपना योगदान ढूंढना और योजना बनाना
-
-यह तय करें कि आप क्या करना चाहते हैं और कैसे करेंगे।
-
-### 1. योगदान के प्रकार
+- **मुख्य तरीका:** हमारे [Discord](https://discord.gg/roocode) से जुड़ें और **Hannes Rudolph (`hrudolph`)** को DM भेजें।
+- **विकल्प:** अनुभवी योगदानकर्ता [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1) के माध्यम से सीधे भाग ले सकते हैं।
 
-हम कई तरह के योगदान का स्वागत करते हैं:
+## अपना योगदान ढूंढना और योजना बनाना
 
-- **बग फिक्स**: मौजूदा कोड में समस्याओं को ठीक करना
-- **नई विशेषताएं**: नई कार्यक्षमता जोड़ना
-- **डाक्यूमेंटेशन**: गाइड्स सुधारना, उदाहरण जोड़ना या टाइपो ठीक करना
+### योगदान के प्रकार
 
-### 2. मुख्य सिद्धांत: Issue-First एप्रोच
+- **बग फिक्स:** कोड की समस्याओं को हल करना।
+- **नई विशेषताएं:** नई कार्यक्षमता जोड़ना।
+- **डॉक्युमेंटेशन:** गाइड सुधारना और स्पष्टता बढ़ाना।
 
-**हर योगदान GitHub Issue से शुरू होना चाहिए।** यह कदम संरेखण सुनिश्चित करने और बेकार मेहनत से बचने के लिए जरूरी है।
+### Issue-First एप्रोच
 
-- **Issue खोजें या बनाएं**:
-    - शुरू करने से पहले, [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) में देखें कि आपके योगदान के लिए कोई Issue पहले से है या नहीं।
-    - अगर है और असाइन नहीं है, तो उस पर कमेंट करें कि आप इसे लेना चाहते हैं। एक मेंटेनर आपको असाइन करेगा।
-    - अगर नहीं है, तो हमारी [Issues पेज](https://github.com/RooVetGit/Roo-Code/issues/new/choose) पर उपयुक्त टेम्पलेट से नया Issue बनाएं:
-        - बग के लिए "Bug Report" टेम्पलेट
-        - नई विशेषता के लिए "Detailed Feature Proposal" टेम्पलेट। कार्य शुरू करने से पहले मेंटेनर (खासकर @hannesrudolph) की मंजूरी का इंतजार करें।
-        - **नोट**: फीचर के लिए सामान्य विचार या शुरुआती चर्चा [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests) में शुरू हो सकती है। जब विचार ठोस हो जाए, तो "Detailed Feature Proposal" Issue बनाएं।
-- **क्लेम और असाइनमेंट**:
-    - किसी Issue पर काम करने की इच्छा स्पष्ट रूप से कमेंट करके बताएं।
-    - मेंटेनर के GitHub में Issue को औपचारिक रूप से असाइन करने का इंतजार करें। इससे एक ही काम पर कई लोग नहीं लगते।
-- **नहीं मानने के परिणाम**:
-    - बिना संबंधित, पूर्व-अनुमोदित और असाइन किए गए Issue के सबमिट किए गए Pull Requests (PRs) बिना पूरी समीक्षा के बंद किए जा सकते हैं। यह नीति यह सुनिश्चित करने के लिए है कि योगदान प्रोजेक्ट की प्राथमिकताओं के अनुरूप हों और सभी का समय सम्मानित हो।
+हर योगदान GitHub Issue से शुरू होना चाहिए।
 
-यह तरीका हमें काम ट्रैक करने, बदलावों की जरूरत सुनिश्चित करने और प्रयासों का समन्वय करने में मदद करता है।
+- **मौजूदा Issues देखें:** [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) में खोजें।
+- **Issue बनाएं:** उपयुक्त टेम्पलेट का उपयोग करें:
+    - **बग:** "Bug Report" टेम्पलेट।
+    - **फीचर्स:** "Detailed Feature Proposal" टेम्पलेट। शुरू करने से पहले अनुमोदन आवश्यक है।
+- **Issue क्लेम करें:** कमेंट करें और आधिकारिक असाइनमेंट का इंतजार करें।
 
-### 3. क्या काम करें चुनना
+**अनुमोदित Issue के बिना PR बंद किए जा सकते हैं।**
 
-- **Good First Issues**: हमारे [Roo Code Issues प्रोजेक्ट](https://github.com/orgs/RooVetGit/projects/1) के "Issue [Unassigned]" सेक्शन को देखें।
-- **डाक्यूमेंटेशन**: यह `CONTRIBUTING.md` कोड योगदान के लिए मुख्य गाइड है, लेकिन अगर आप अन्य डाक्यूमेंटेशन (जैसे यूजर गाइड या API डाक्यूमेंटेशन) में योगदान करना चाहते हैं, तो [Roo Code Docs रिपॉजिटरी](https://github.com/RooVetGit/Roo-Code-Docs) देखें या Discord कम्युनिटी में पूछें।
-- **नई विशेषताएं प्रस्तावित करना**:
-    1.  **प्रारंभिक विचार/चर्चा**: सामान्य या शुरुआती फीचर विचारों के लिए [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests) में चर्चा शुरू करें।
-    2.  **औपचारिक प्रस्ताव**: ठोस, लागू करने योग्य फीचर प्रस्तावों के लिए हमारी [Issues पेज](https://github.com/RooVetGit/Roo-Code/issues/new/choose) पर "Detailed Feature Proposal" टेम्पलेट से Issue बनाएं। यह हमारे **Issue-First एप्रोच** का मुख्य हिस्सा है।
+### क्या काम करें चुनना
 
-### 4. बग या समस्या रिपोर्ट करना
+- [GitHub प्रोजेक्ट](https://github.com/orgs/RooVetGit/projects/1) में असाइन न किए गए "Good First Issues" देखें।
+- डॉक्युमेंटेशन के लिए, [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) देखें।
 
-अगर आपको कोई बग मिले:
+### बग या समस्या रिपोर्ट करना
 
-1.  **मौजूदा Issues खोजें**: [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) में देखें कि क्या पहले से रिपोर्ट है।
-2.  **नया Issue बनाएं**: अगर यूनिक है, तो हमारी [Issues पेज](https://github.com/RooVetGit/Roo-Code/issues/new/choose) पर "Bug Report" टेम्पलेट का उपयोग करें।
+- पहले मौजूदा रिपोर्ट देखें।
+- ["Bug Report" टेम्पलेट](https://github.com/RooVetGit/Roo-Code/issues/new/choose) का उपयोग करके नए बग रिपोर्ट बनाएं।
+- **सुरक्षा कमजोरियां:** [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new) के माध्यम से निजी तौर पर रिपोर्ट करें।
 
-> 🔐 **सुरक्षा कमजोरियां**: अगर आप कोई सुरक्षा कमजोरी पाते हैं, तो कृपया [GitHub की Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new) से निजी तौर पर रिपोर्ट करें। सुरक्षा कमजोरियों के लिए सार्वजनिक Issue न बनाएं।
+## विकास और सबमिशन प्रक्रिया
 
-## III. विकास और सबमिशन प्रक्रिया
+### विकास सेटअप
 
-कोडिंग और सबमिट करने के लिए इन स्टेप्स को फॉलो करें।
+1. **Fork & Clone:**
 
-### 1. विकास सेटअप
-
-1.  **Fork & Clone**:
-    - GitHub पर रिपॉजिटरी को फोर्क करें।
-    - अपने फोर्क को लोकली क्लोन करें: `git clone https://github.com/आपका_यूज़रनेम/Roo-Code.git`
-2.  **डिपेंडेंसी इंस्टॉल करें**: `npm run install:all`
-3.  **Webview (Dev Mode) चलाएं**: `npm run dev` (Vite/React ऐप के लिए HMR के साथ)
-4.  **एक्सटेंशन डिबग करें**: VS Code में `F5` दबाएं (या **Run** → **Start Debugging**) ताकि Roo Code के साथ नया Extension Development Host विंडो खुले।
-
-Webview (`webview-ui`) में बदलाव तुरंत Hot Module Replacement के साथ दिखेंगे। कोर एक्सटेंशन (`src`) में बदलाव के लिए Extension Development Host को रीस्टार्ट करना होगा।
-
-वैकल्पिक रूप से, `.vsix` पैकेज बनाने और इंस्टॉल करने के लिए:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/आपका_यूज़रनेम/Roo-Code.git
 ```
 
-(`<version>` को बिल्ट फाइल के असली वर्शन नंबर से बदलें।)
-
-### 2. कोड लिखने के दिशा-निर्देश
-
-- **फोकस्ड PRs**: एक फीचर/बग फिक्स प्रति PR।
-- **कोड क्वालिटी**:
-    - CI चेक्स पास करें (लिंटिंग, फॉर्मेटिंग)
-    - ESLint वार्निंग्स या एरर ठीक करें (`npm run lint`)
-    - ऑटोमेटेड कोड रिव्यू टूल्स के फीडबैक का जवाब दें
-    - TypeScript बेस्ट प्रैक्टिस फॉलो करें और टाइप सेफ्टी बनाए रखें
-- **टेस्टिंग**:
-    - नए फीचर्स के लिए टेस्ट जोड़ें
-    - `npm test` चलाएं ताकि सभी टेस्ट पास हों
-    - अगर आपके बदलाव से मौजूदा टेस्ट प्रभावित होते हैं तो उन्हें अपडेट करें
-- **कमिट मैसेज**:
-    - स्पष्ट, वर्णनात्मक कमिट मैसेज लिखें
-    - संबंधित Issues को `#issue-number` (जैसे `Fixes #123`) से रेफर करें
-- **PR सबमिट करने से पहले चेकलिस्ट**:
-    - अपनी ब्रांच को अपस्ट्रीम के लेटेस्ट `main` पर रीबेस करें
-    - सुनिश्चित करें कि कोड बिल्ड होता है (`npm run build`)
-    - सभी टेस्ट पास हों (`npm test`)
-    - कोई भी डिबगिंग कोड या `console.log` हटा दें
-
-### 3. कोड सबमिट करना: Pull Request (PR) प्रक्रिया
-
-#### ड्राफ्ट Pull Requests
-
-ऐसे काम के लिए ड्राफ्ट PRs का उपयोग करें जो अभी पूरी तरह से रिव्यू के लिए तैयार नहीं है, लेकिन जिसके लिए आप:
-
-- ऑटोमेटेड चेक्स (CI) चलाना चाहते हैं
-- मेंटेनर्स या अन्य योगदानकर्ताओं से जल्दी फीडबैक पाना चाहते हैं
-- दिखाना चाहते हैं कि काम प्रगति पर है
-
-PR को "Ready for Review" तभी मार्क करें जब सभी चेक्स पास हों और आपको लगे कि यह "कोड लिखने के दिशा-निर्देश" और "Pull Request विवरण" के मानदंडों को पूरा करता है।
-
-#### Pull Request विवरण
-
-आपके PR का विवरण पूरा होना चाहिए और हमारी [Pull Request टेम्पलेट](.github/pull_request_template.md) की संरचना का पालन करना चाहिए। मुख्य बिंदु:
-
-- संबद्ध GitHub Issue का लिंक
-- किए गए बदलावों और उनके उद्देश्य का स्पष्ट विवरण
-- बदलावों को टेस्ट करने के लिए विस्तृत स्टेप्स
-- किसी भी ब्रेकिंग चेंज की सूची
-- **UI बदलावों के लिए, पहले और बाद के स्क्रीनशॉट या वीडियो दें**
-- **जरूरी: बताएं कि क्या आपके PR से यूजर डाक्यूमेंटेशन अपडेट करना जरूरी है और कौन से डॉक्यूमेंट्स या सेक्शन प्रभावित हैं**
-
-#### Pull Request (PR) नीति
-
-##### उद्देश्य
-
-PR बैकलॉग को साफ, केंद्रित और प्रबंधनीय बनाए रखना।
+2. **डिपेंडेंसी इंस्टॉल करें:**
 
-##### Issue-First एप्रोच
+```
+npm run install:all
+```
 
-- **आवश्यक**: काम शुरू करने से पहले एक मौजूदा, अनुमोदित और असाइन किया गया GitHub Issue होना चाहिए ("Bug Report" या "Detailed Feature Proposal")।
-- **अनुमोदन**: Issues, खासकर बड़े बदलावों के लिए, मेंटेनर्स (खासकर @hannesrudolph) द्वारा _कोडिंग शुरू करने से पहले_ रिव्यू और अप्रूव होना चाहिए।
-- **संदर्भ**: PRs को इन पूर्व-अनुमोदित Issues को अपनी विवरण में स्पष्ट रूप से संदर्भित करना चाहिए।
-- **परिणाम**: इस प्रक्रिया का पालन न करने पर PR बिना पूरी समीक्षा के बंद किया जा सकता है।
+3. **डिबगिंग:** VS Code में `F5` दबाएं।
 
-##### ओपन PR के लिए शर्तें
+### कोड लिखने के दिशा-निर्देश
 
-- **मर्ज के लिए तैयार**: सभी CI टेस्ट पास करता है, रोडमैप से मेल खाता है (अगर लागू हो), अनुमोदित और असाइन किए गए Issue से जुड़ा है, स्पष्ट डाक्यूमेंटेशन/कमेंट्स हैं, UI बदलावों के लिए पहले/बाद की इमेज/वीडियो शामिल हैं
-- **बंद करने के लिए**: CI टेस्ट फेल, बड़े मर्ज कॉन्फ्लिक्ट, प्रोजेक्ट लक्ष्यों से मेल न खाना, या लंबे समय (>30 दिन) तक फीडबैक के बाद कोई अपडेट न होना
+- प्रति फीचर या फिक्स एक फोकस्ड PR।
+- ESLint और TypeScript बेस्ट प्रैक्टिस का पालन करें।
+- स्पष्ट, वर्णनात्मक कमिट मैसेज लिखें जो Issues को रेफर करें (जैसे `Fixes #123`)।
+- पूर्ण टेस्टिंग प्रदान करें (`npm test`)।
+- सबमिट करने से पहले अपनी ब्रांच को नवीनतम `main` पर रीबेस करें।
 
-##### प्रक्रिया
+### Pull Request सबमिट करना
 
-1.  **Issue क्वालिफिकेशन और असाइनमेंट**: @hannesrudolph (या अन्य मेंटेनर्स) नए और मौजूदा Issues की समीक्षा करते हैं और उन्हें असाइन करते हैं।
-2.  **प्रारंभिक PR ट्रायज (रोजाना)**: मेंटेनर्स नए PRs की जल्दी समीक्षा करते हैं ताकि जरूरी या गंभीर मुद्दों को छांटा जा सके।
-3.  **विस्तृत PR रिव्यू (साप्ताहिक)**: मेंटेनर्स PRs की गहराई से समीक्षा करते हैं ताकि उनकी तैयारी, अनुमोदित Issue से मेल और गुणवत्ता का आकलन किया जा सके।
-4.  **विस्तृत फीडबैक और पुनरावृत्ति**: रिव्यू के आधार पर मेंटेनर्स फीडबैक देते हैं (Approve, Request Changes, या Reject)। योगदानकर्ताओं से अपेक्षा है कि वे फीडबैक का जवाब दें और जरूरत के अनुसार सुधार करें।
-5.  **निर्णय चरण**: अनुमोदित PRs मर्ज किए जाते हैं। जिन PRs में अनसुलझी समस्याएं हैं या जो मेल नहीं खाते, उन्हें स्पष्ट कारण के साथ बंद किया जा सकता है।
-6.  **फॉलो-अप**: बंद किए गए PRs के लेखक फीडबैक के अनुसार सुधार कर सकते हैं और अगर समस्याएं हल हो जाएं या प्रोजेक्ट की दिशा बदल जाए तो नए PRs खोल सकते हैं।
+- अगर आप शुरुआती फीडबैक चाहते हैं तो **ड्राफ्ट PR** से शुरू करें।
+- Pull Request टेम्पलेट का पालन करते हुए अपने परिवर्तनों का स्पष्ट वर्णन करें।
+- UI परिवर्तनों के लिए स्क्रीनशॉट/वीडियो प्रदान करें।
+- बताएं कि क्या डॉक्युमेंटेशन अपडेट आवश्यक हैं।
 
-##### जिम्मेदारियां
+### Pull Request नीति
 
-- **Issue क्वालिफिकेशन और प्रक्रिया अनुपालन (@hannesrudolph & मेंटेनर्स)**: सुनिश्चित करें कि सभी योगदान Issue-First एप्रोच का पालन करें। योगदानकर्ताओं को प्रक्रिया में मार्गदर्शन दें।
-- **मेंटेनर्स (डेव टीम)**: PRs की समीक्षा करें, तकनीकी फीडबैक दें, अप्रूवल/रिजेक्शन के फैसले लें, PRs मर्ज करें।
-- **योगदानकर्ता**: PRs को अनुमोदित और असाइन किए गए Issue से लिंक करें, गुणवत्ता दिशानिर्देशों का पालन करें, फीडबैक का तुरंत जवाब दें।
+- पूर्व-अनुमोदित और असाइन किए गए Issues का संदर्भ देना चाहिए।
+- नीति का पालन न करने वाले PR बंद किए जा सकते हैं।
+- PR को CI टेस्ट पास करना चाहिए, रोडमैप से मेल खाना चाहिए, और स्पष्ट डॉक्युमेंटेशन होनी चाहिए।
 
-यह नीति स्पष्टता और कुशल एकीकरण सुनिश्चित करती है।
+### समीक्षा प्रक्रिया
 
-## IV. कानूनी
+- **दैनिक ट्रायज:** मेंटेनर्स द्वारा त्वरित जांच।
+- **साप्ताहिक गहन समीक्षा:** व्यापक मूल्यांकन।
+- **फीडबैक के आधार पर तेजी से सुधार** करें।
 
-### योगदान समझौता
+## कानूनी
 
-Pull Request सबमिट करके, आप सहमत होते हैं कि आपके योगदान [Apache 2.0 लाइसेंस](LICENSE) (या प्रोजेक्ट की मौजूदा लाइसेंस) के तहत होंगे, जैसे कि प्रोजेक्ट है।
+Pull Request सबमिट करके, आप सहमत होते हैं कि आपके योगदान Roo Code के लाइसेंसिंग के अनुरूप Apache 2.0 लाइसेंस के तहत लाइसेंस किए जाएंगे।

locales/it/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Contribuire a Roo Code
 
-Roo Code è un progetto guidato dalla community e apprezziamo molto ogni contributo. Per garantire un processo fluido ed efficace per tutti, **operiamo secondo un approccio "[Issue-First](#2-principio-chiave-approccio-issue-first)".** Questo significa che ogni lavoro deve essere collegato a una Issue GitHub _prima_ di inviare una Pull Request (vedi la nostra [Politica PR](#politica-di-pull-request-pr) per i dettagli). Leggi attentamente questa guida per capire come contribuire.
-Questa guida spiega come contribuire a Roo Code, che tu stia correggendo bug, aggiungendo funzionalità o migliorando la documentazione.
+Roo Code è un progetto guidato dalla community e apprezziamo molto ogni contributo. Per semplificare la collaborazione, operiamo secondo un approccio [Issue-First](#approccio-issue-first), il che significa che tutte le [Pull Request (PR)](#inviare-una-pull-request) devono prima essere collegate a una Issue GitHub. Ti preghiamo di leggere attentamente questa guida.
 
 ## Indice
 
-- [I. Prima di contribuire](#i-prima-di-contribuire)
-    - [1. Codice di condotta](#1-codice-di-condotta)
-    - [2. Comprendere la roadmap del progetto](#2-comprendere-la-roadmap-del-progetto)
-        - [Affidabilità prima di tutto](#affidabilità-prima-di-tutto)
-        - [Esperienza utente migliorata](#esperienza-utente-migliorata)
-        - [Leadership nelle prestazioni degli agenti](#leadership-nelle-prestazioni-degli-agenti)
-    - [3. Unisciti alla community Roo Code](#3-unisciti-alla-community-roo-code)
-- [II. Trovare e pianificare il tuo contributo](#ii-trovare-e-pianificare-il-tuo-contributo)
-    - [1. Tipi di contributi](#1-tipi-di-contributi)
-    - [2. Principio chiave: Approccio Issue-First](#2-principio-chiave-approccio-issue-first)
-    - [3. Decidere su cosa lavorare](#3-decidere-su-cosa-lavorare)
-    - [4. Segnalare bug o problemi](#4-segnalare-bug-o-problemi)
-- [III. Processo di sviluppo e invio](#iii-processo-di-sviluppo-e-invio)
-    - [1. Configurazione dello sviluppo](#1-configurazione-dello-sviluppo)
-    - [2. Linee guida per scrivere codice](#2-linee-guida-per-scrivere-codice)
-    - [3. Inviare codice: Processo di Pull Request (PR)](#3-inviare-codice-processo-di-pull-request-pr)
-        - [Pull Request in bozza](#pull-request-in-bozza)
-        - [Descrizione della Pull Request](#descrizione-della-pull-request)
-        - [Politica di Pull Request (PR)](#politica-di-pull-request-pr)
-            - [Obiettivo](#obiettivo)
-            - [Approccio Issue-First](#approccio-issue-first)
-            - [Condizioni per PR aperte](#condizioni-per-pr-aperte)
-            - [Procedura](#procedura)
-            - [Responsabilità](#responsabilità)
-- [IV. Legale](#iv-legale)
-    - [Accordo di contributo](#accordo-di-contributo)
-
-## I. Prima di contribuire
-
-Per prima cosa, familiarizza con i nostri standard di community e la direzione del progetto.
+- [Prima di contribuire](#prima-di-contribuire)
+- [Trovare e pianificare il tuo contributo](#trovare-e-pianificare-il-tuo-contributo)
+- [Processo di sviluppo e invio](#processo-di-sviluppo-e-invio)
+- [Legale](#legale)
 
-### 1. Codice di condotta
-
-Tutti i collaboratori devono rispettare il nostro [Codice di condotta](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Leggilo prima di contribuire.
+## Prima di contribuire
 
-### 2. Comprendere la roadmap del progetto
+### 1. Codice di condotta
 
-Roo Code ha una roadmap di sviluppo chiara che guida le nostre priorità e la direzione futura. Comprenderla ti aiuta a:
+Tutti i collaboratori devono rispettare il nostro [Codice di condotta](./CODE_OF_CONDUCT.md).
 
-- Allineare i tuoi contributi agli obiettivi del progetto
-- Individuare le aree dove la tua esperienza è più preziosa
-- Capire il contesto dietro alcune decisioni di design
-- Trovare ispirazione per nuove funzionalità che supportano la nostra visione
+### 2. Roadmap del progetto
 
-Ci concentriamo nel rendere Roo Code la scelta migliore per gli sviluppatori che lavorano con strumenti di codifica basati sull'IA. Ecco come lo faremo:
+La nostra roadmap guida la direzione del progetto. Allinea i tuoi contributi con questi obiettivi chiave:
 
-#### Affidabilità prima di tutto
+### Affidabilità prima di tutto
 
 - Garantire che l'editing delle differenze e l'esecuzione dei comandi siano costantemente affidabili
 - Ridurre i punti di attrito che scoraggiano l'uso regolare
 - Garantire un funzionamento fluido in tutte le lingue e su tutte le piattaforme
 - Ampliare il supporto robusto per una vasta gamma di provider e modelli di IA
 
-#### Esperienza utente migliorata
+### Esperienza utente migliorata
 
 - Semplificare l'interfaccia utente per maggiore chiarezza e intuitività
-- Migliorare continuamente il flusso di lavoro per soddisfare le elevate aspettative che gli sviluppatori hanno per gli strumenti di uso quotidiano
+- Migliorare continuamente il flusso di lavoro per soddisfare le elevate aspettative degli sviluppatori
 
-#### Leadership nelle prestazioni degli agenti
+### Leadership nelle prestazioni degli agenti
 
 - Stabilire parametri di valutazione completi (evals) per misurare la produttività nel mondo reale
 - Rendere facile per tutti eseguire e interpretare queste valutazioni
-- Fornire miglioramenti a Roo Code che dimostrino chiari aumenti nei punteggi di valutazione
+- Fornire miglioramenti che dimostrino chiari aumenti nei punteggi di valutazione
 
-Accogliamo con particolare favore i contributi che fanno avanzare gli obiettivi della nostra roadmap. Se stai lavorando su qualcosa che si allinea con questi pilastri, menzionalo nella descrizione della tua PR.
+Menziona l'allineamento con queste aree nelle tue PR.
 
 ### 3. Unisciti alla community Roo Code
 
-Entrare in contatto con la community Roo Code è un ottimo modo per iniziare:
-
-- **Metodo principale**:
-    1.  Unisciti alla [community Roo Code su Discord](https://discord.gg/roocode).
-    2.  Una volta dentro, invia un messaggio diretto (DM) a **Hannes Rudolph** (Discord: `hrudolph`) per discutere il tuo interesse e ricevere consigli.
-- **Alternativa per collaboratori esperti**: Se ti senti a tuo agio con l'approccio issue-first, puoi partecipare direttamente tramite GitHub seguendo la [Kanban board](https://github.com/orgs/RooVetGit/projects/1) e comunicando tramite issues e pull request.
-
-## II. Trovare e pianificare il tuo contributo
-
-Individua su cosa vuoi lavorare e come affrontarlo.
-
-### 1. Tipi di contributi
+- **Principale:** Unisciti al nostro [Discord](https://discord.gg/roocode) e invia un DM a **Hannes Rudolph (`hrudolph`)**.
+- **Alternativa:** I collaboratori esperti possono partecipare direttamente tramite [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Accettiamo vari tipi di contributi:
+## Trovare e pianificare il tuo contributo
 
-- **Correzione bug**: Risolvere problemi nel codice esistente.
-- **Nuove funzionalità**: Aggiungere nuove funzionalità.
-- **Documentazione**: Migliorare guide, esempi o correggere errori di battitura.
+### Tipi di contributi
 
-### 2. Principio chiave: Approccio Issue-First
+- **Correzione bug:** Risolvere problemi nel codice.
+- **Nuove funzionalità:** Aggiungere nuove funzionalità.
+- **Documentazione:** Migliorare guide e chiarezza.
 
-**Tutti i contributi devono iniziare con una Issue GitHub.** Questo è fondamentale per garantire l'allineamento ed evitare sforzi inutili.
+### Approccio Issue-First
 
-- **Cerca o crea una Issue**:
-    - Prima di iniziare, cerca su [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) se esiste già una issue per il tuo contributo.
-    - Se esiste e non è assegnata, commenta per esprimere il tuo interesse. Un maintainer te la assegnerà.
-    - Se non esiste, creane una nuova usando il template appropriato sulla nostra [pagina delle issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Per i bug, usa il template "Bug Report".
-        - Per nuove funzionalità, usa il template "Detailed Feature Proposal". Attendi l'approvazione di un maintainer (soprattutto @hannesrudolph) prima di iniziare a implementare.
-        - **Nota**: Idee generali o discussioni preliminari sulle funzionalità possono iniziare su [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Quando l'idea è più concreta, crea una issue "Detailed Feature Proposal".
-- **Claim e assegnazione**:
-    - Indica chiaramente la tua intenzione di lavorare su una issue commentando.
-    - Attendi che un maintainer te la assegni ufficialmente su GitHub. Così evitiamo che più persone lavorino sulla stessa cosa.
-- **Conseguenze del mancato rispetto**:
-    - Le Pull Request (PR) inviate senza una issue corrispondente, pre-approvata e assegnata possono essere chiuse senza revisione completa. Questa politica serve a garantire che i contributi siano allineati con le priorità del progetto e a rispettare il tempo di tutti.
+Tutti i contributi devono iniziare con una Issue GitHub.
 
-Questo approccio ci aiuta a tracciare il lavoro, garantire che i cambiamenti siano desiderati e coordinare efficacemente gli sforzi.
+- **Verificare le issue esistenti:** Cerca su [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Creare una issue:** Usa i template appropriati:
+    - **Bug:** Template "Bug Report".
+    - **Funzionalità:** Template "Detailed Feature Proposal". Approvazione richiesta prima di iniziare.
+- **Reclamare issue:** Commenta e attendi l'assegnazione ufficiale.
 
-### 3. Decidere su cosa lavorare
+**Le PR senza issue approvate potrebbero essere chiuse.**
 
-- **Good First Issues**: Consulta la sezione "Issue [Unassigned]" del nostro [progetto Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) su GitHub.
-- **Documentazione**: Anche se questo `CONTRIBUTING.md` è la guida principale per i contributi al codice, se vuoi contribuire ad altra documentazione (come guide utente o API), consulta il [repo Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) o chiedi nella community Discord.
-- **Proporre nuove funzionalità**:
-    1.  **Idea/discussione iniziale**: Per idee generali o iniziali, avvia una discussione su [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Proposta formale**: Per proposte specifiche e pronte per la valutazione, crea una issue "Detailed Feature Proposal" usando il template sulla nostra [pagina delle issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Questo è fondamentale nel nostro **approccio Issue-First**.
+### Decidere su cosa lavorare
 
-### 4. Segnalare bug o problemi
+- Controlla il [Progetto GitHub](https://github.com/orgs/RooVetGit/projects/1) per "Good First Issues" non assegnate.
+- Per la documentazione, visita [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Se trovi un bug:
+### Segnalare bug
 
-1.  **Cerca issues esistenti**: Controlla su [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) se è già stato segnalato.
-2.  **Crea una nuova issue**: Se è unico, usa il template "Bug Report" sulla nostra [pagina delle issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Controlla prima i report esistenti.
+- Crea nuovi report di bug usando il [template "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Problemi di sicurezza:** Segnala privatamente tramite [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Vulnerabilità di sicurezza**: Se scopri una vulnerabilità di sicurezza, segnalala privatamente tramite lo [strumento di avviso di sicurezza di GitHub](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Non creare una issue pubblica per vulnerabilità di sicurezza.
+## Processo di sviluppo e invio
 
-## III. Processo di sviluppo e invio
+### Configurazione dello sviluppo
 
-Segui questi passaggi per programmare e inviare il tuo lavoro.
+1. **Fork & Clona:**
 
-### 1. Configurazione dello sviluppo
-
-1.  **Fork & Clona**:
-    - Fai il fork del repository su GitHub.
-    - Clona il tuo fork localmente: `git clone https://github.com/TUO_USERNAME/Roo-Code.git`
-2.  **Installa le dipendenze**: `npm run install:all`
-3.  **Esegui Webview (Dev Mode)**: `npm run dev` (per l'app Vite/React con HMR)
-4.  **Debugga l'estensione**: Premi `F5` in VS Code (o **Run** → **Start Debugging**) per aprire una nuova finestra Extension Development Host con Roo Code caricato.
-
-Le modifiche al webview (`webview-ui`) appariranno immediatamente grazie all'Hot Module Replacement. Le modifiche all'estensione principale (`src`) richiederanno il riavvio dell'Extension Development Host.
-
-In alternativa, per costruire e installare un pacchetto `.vsix`:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/TUO_USERNAME/Roo-Code.git
 ```
 
-(Sostituisci `<version>` con il numero di versione reale del file generato).
-
-### 2. Linee guida per scrivere codice
-
-- **PR focalizzate**: Una funzionalità/fix per PR.
-- **Qualità del codice**:
-    - Superare i check CI (lint, formattazione)
-    - Correggere avvisi o errori ESLint (`npm run lint`)
-    - Rispondere al feedback degli strumenti automatici di code review
-    - Seguire le best practice TypeScript e mantenere la sicurezza dei tipi
-- **Testing**:
-    - Aggiungere test per nuove funzionalità
-    - Eseguire `npm test` per assicurarsi che tutto passi
-    - Aggiornare i test esistenti se il tuo cambiamento li influenza
-- **Messaggi di commit**:
-    - Scrivere messaggi chiari e descrittivi
-    - Fare riferimento alle issues rilevanti usando `#numero-issue` (es: `Fixes #123`)
-- **Checklist prima di inviare PR**:
-    - Rebase della tua branch sull'ultimo `main` dell'upstream
-    - Assicurati che il codice compili (`npm run build`)
-    - Verifica che tutti i test passino (`npm test`)
-    - Rimuovi qualsiasi codice di debug o `console.log`
-
-### 3. Inviare codice: Processo di Pull Request (PR)
-
-#### Pull Request in bozza
-
-Usa PR in bozza per lavori non ancora pronti per una revisione completa ma per cui vuoi:
-
-- Eseguire i check automatici (CI)
-- Ricevere feedback precoce dai maintainer o altri collaboratori
-- Segnalare che il lavoro è in corso
-
-Segna una PR come "Pronta per la revisione" solo quando tutti i check sono superati e pensi che soddisfi i criteri delle "Linee guida per scrivere codice" e della "Descrizione della Pull Request".
-
-#### Descrizione della Pull Request
-
-La descrizione della tua PR deve essere completa e seguire la struttura del nostro [Template di Pull Request](.github/pull_request_template.md). Punti chiave:
-
-- Un link alla Issue GitHub approvata che affronta
-- Descrizione chiara delle modifiche apportate e del loro scopo
-- Passaggi dettagliati per testare le modifiche
-- Elenco di eventuali breaking changes
-- **Per modifiche UI, fornisci screenshot o video prima/dopo**
-- **Indica se la tua PR richiede aggiornamenti alla documentazione utente e quali documenti/sezioni sono interessati**
-
-#### Politica di Pull Request (PR)
-
-##### Obiettivo
-
-Mantenere un backlog di PR pulito, focalizzato e gestibile.
+2. **Installa le dipendenze:**
 
-##### Approccio Issue-First
+```
+npm run install:all
+```
 
-- **Richiesto**: Prima di iniziare, deve esistere una Issue GitHub approvata e assegnata (sia "Bug Report" che "Detailed Feature Proposal").
-- **Approvazione**: Le Issues, soprattutto per cambiamenti importanti, devono essere riviste e approvate dai maintainer (in particolare @hannesrudolph) _prima_ di iniziare a programmare.
-- **Riferimento**: Le PR devono fare riferimento esplicito a queste Issues pre-approvate nella descrizione.
-- **Conseguenze**: Il mancato rispetto di questo processo può comportare la chiusura della PR senza revisione completa.
+3. **Debug:** Apri con VS Code (`F5`).
 
-##### Condizioni per PR aperte
+### Linee guida per scrivere codice
 
-- **Pronta per il merge**: Supera tutti i test CI, è allineata con la roadmap (se applicabile), è collegata a una Issue approvata e assegnata, ha documentazione/commenti chiari, include immagini/video prima/dopo per modifiche UI
-- **Da chiudere**: Fallimenti CI, conflitti di merge importanti, disallineamento con gli obiettivi del progetto o inattività prolungata (>30 giorni senza aggiornamenti dopo feedback)
+- Una PR focalizzata per funzionalità o correzione.
+- Segui le best practice di ESLint e TypeScript.
+- Scrivi commit chiari e descrittivi che fanno riferimento alle issue (es. `Fixes #123`).
+- Fornisci test approfonditi (`npm test`).
+- Fai rebase sul branch `main` più recente prima dell'invio.
 
-##### Procedura
+### Inviare una Pull Request
 
-1.  **Qualificazione e assegnazione Issue**: @hannesrudolph (o altri maintainer) esaminano e assegnano le nuove ed esistenti Issues.
-2.  **Triage iniziale PR (giornaliero)**: I maintainer fanno una rapida revisione dei nuovi PR per filtrare urgenze o problemi critici.
-3.  **Revisione approfondita PR (settimanale)**: I maintainer esaminano a fondo i PR per valutarne la prontezza, l'allineamento con la Issue approvata e la qualità generale.
-4.  **Feedback dettagliato e iterazione**: In base alla revisione, i maintainer forniscono feedback (Approve, Request Changes, Reject). I collaboratori sono tenuti a rispondere e migliorare se necessario.
-5.  **Fase decisionale**: I PR approvati vengono uniti. I PR con problemi irrisolvibili o non allineati possono essere chiusi con spiegazione.
-6.  **Follow-up**: Gli autori dei PR chiusi possono risolvere i problemi e aprirne di nuovi se necessario.
+- Inizia come **PR in bozza** se cerchi feedback anticipato.
+- Descrivi chiaramente le tue modifiche seguendo il Template di Pull Request.
+- Fornisci screenshot/video per modifiche UI.
+- Indica se sono necessari aggiornamenti alla documentazione.
 
-##### Responsabilità
+### Politica di Pull Request
 
-- **Qualificazione Issue & rispetto del processo (@hannesrudolph & maintainer)**: Assicurarsi che tutti i contributi seguano l'approccio Issue-First. Guidare i collaboratori nel processo.
-- **Maintainer (Dev Team)**: Revisionare i PR, fornire feedback tecnico, prendere decisioni di approvazione/rifiuto, unire i PR.
-- **Collaboratori**: Assicurarsi che i PR siano collegati a una Issue approvata e assegnata, rispettino le linee guida di qualità e rispondano prontamente al feedback.
+- Deve fare riferimento a issue pre-approvate e assegnate.
+- Le PR che non rispettano la politica potrebbero essere chiuse.
+- Le PR dovrebbero superare i test CI, allinearsi con la roadmap e avere documentazione chiara.
 
-Questa politica garantisce chiarezza e integrazione efficiente.
+### Processo di revisione
 
-## IV. Legale
+- **Triage quotidiano:** Controlli rapidi da parte dei maintainer.
+- **Revisione settimanale approfondita:** Valutazione completa.
+- **Itera rapidamente** in base al feedback.
 
-### Accordo di contributo
+## Legale
 
-Inviando una pull request, accetti che i tuoi contributi siano concessi in licenza sotto la [Licenza Apache 2.0](LICENSE) (o la licenza attuale del progetto), come il progetto.
+Inviando una pull request, accetti che i tuoi contributi siano concessi in licenza sotto la Licenza Apache 2.0, in linea con la licenza di Roo Code.

locales/ja/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Roo Code への貢献
 
-Roo Code はコミュニティ主導のプロジェクトであり、すべての貢献を大切にしています。みんながスムーズかつ効果的に参加できるように、**「[Issue-First](#2-重要な原則-issue-firstアプローチ)」方式で運営しています。** つまり、すべての作業は Pull Request を出す _前に_ GitHub Issue に紐付ける必要があります（詳細は[PRポリシー](#pull-request-pr-ポリシー)を参照）。このガイドをよく読んで、貢献方法を理解してください。
-このガイドは、バグ修正、新機能追加、ドキュメント改善など、Roo Code への貢献方法を説明します。
+Roo Code はコミュニティ主導のプロジェクトであり、すべての貢献を大切にしています。協力をスムーズにするため、[Issue-First](#issue-first-アプローチ)方式を採用しています。これはすべての[Pull Request (PR)](#pull-request-の提出)がまずGitHub Issueに紐付けられる必要があることを意味します。このガイドをよく読んでください。
 
 ## 目次
 
-- [I. 貢献する前に](#i-貢献する前に)
-    - [1. 行動規範](#1-行動規範)
-    - [2. プロジェクトロードマップの理解](#2-プロジェクトロードマップの理解)
-        - [信頼性優先](#信頼性優先)
-        - [ユーザー体験の強化](#ユーザー体験の強化)
-        - [エージェントパフォーマンスの先導](#エージェントパフォーマンスの先導)
-    - [3. Roo Code コミュニティに参加する](#3-roo-code-コミュニティに参加する)
-- [II. 貢献内容の発見と計画](#ii-貢献内容の発見と計画)
-    - [1. 貢献の種類](#1-貢献の種類)
-    - [2. 重要な原則: Issue-First アプローチ](#2-重要な原則-issue-first-アプローチ)
-    - [3. 何に取り組むか決める](#3-何に取り組むか決める)
-    - [4. バグや問題の報告](#4-バグや問題の報告)
-- [III. 開発と提出のプロセス](#iii-開発と提出のプロセス)
-    - [1. 開発環境のセットアップ](#1-開発環境のセットアップ)
-    - [2. コーディングガイドライン](#2-コーディングガイドライン)
-    - [3. コード提出: Pull Request (PR) プロセス](#3-コード提出-pull-request-pr-プロセス)
-        - [ドラフト Pull Request](#ドラフト-pull-request)
-        - [Pull Request の説明](#pull-request-の説明)
-        - [Pull Request (PR) ポリシー](#pull-request-pr-ポリシー)
-            - [目的](#目的)
-            - [Issue-First アプローチ](#issue-first-アプローチ)
-            - [オープンPRの条件](#オープンprの条件)
-            - [手順](#手順)
-            - [責任](#責任)
-- [IV. 法的事項](#iv-法的事項)
-    - [貢献契約](#貢献契約)
-
-## I. 貢献する前に
-
-まず、コミュニティの基準やプロジェクトの方向性を理解しましょう。
+- [貢献する前に](#貢献する前に)
+- [貢献内容の発見と計画](#貢献内容の発見と計画)
+- [開発と提出のプロセス](#開発と提出のプロセス)
+- [法的事項](#法的事項)
 
-### 1. 行動規範
-
-すべてのコントリビューターは[行動規範](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md)を守る必要があります。貢献前に必ず読んでください。
+## 貢献する前に
 
-### 2. プロジェクトロードマップの理解
+### 1. 行動規範
 
-Roo Code には明確な開発ロードマップがあり、優先順位や今後の方向性を示しています。ロードマップを理解することで、以下のことができます：
+すべてのコントリビューターは[行動規範](./CODE_OF_CONDUCT.md)を守る必要があります。
 
-- 貢献をプロジェクトの目標に合わせられる
-- 自分のスキルが最も活かせる分野を見つけられる
-- 特定の設計判断の背景を理解できる
-- ビジョンに沿った新機能のアイデアを得られる
+### 2. プロジェクトロードマップ
 
-私たちはRoo CodeをAI駆動のコーディングツールを構築する開発者にとって最高の選択肢にすることに集中しています。以下がその実現方法です：
+ロードマップはプロジェクトの方向性を示します。貢献をこれらの主要目標に沿わせてください：
 
-#### 信頼性優先
+### 信頼性優先
 
 - diff編集とコマンド実行が常に信頼できることを保証
 - 定期的な使用を妨げる摩擦ポイントの削減
 - すべての言語環境とプラットフォームでのスムーズな動作を保証
 - 様々なAIプロバイダーとモデルへの堅牢なサポートを拡大
 
-#### ユーザー体験の強化
+### ユーザー体験の強化
 
 - 明確さと直感性のためのUI/UXの合理化
 - 開発者が日常的に使用するツールに求める高い期待に応えるためのワークフローの継続的改善
 
-#### エージェントパフォーマンスの先導
+### エージェントパフォーマンスの先導
 
 - 実際の生産性を測定する包括的な評価基準（evals）の確立
 - 誰もが簡単にこれらの評価を実行して解釈できるようにする
-- 評価スコアの明確な向上を示すRoo Codeの改善を提供
+- 評価スコアの明確な向上を示す改善を提供
 
-ロードマップの目標を推進する貢献は特に歓迎します。これらの柱に沿った作業をしている場合は、PRの説明でぜひ言及してください。
+PRでこれらの領域との関連性に言及してください。
 
 ### 3. Roo Code コミュニティに参加する
 
-Roo Code コミュニティとつながるのは、始めるのに最適な方法です：
-
-- **メインの方法**：
-    1.  [Roo Code Discord コミュニティ](https://discord.gg/roocode)に参加する。
-    2.  参加後、**Hannes Rudolph**（Discord: `hrudolph`）にDMを送り、興味を伝えてアドバイスをもらう。
-- **経験者向けの代替案**：Issue-First アプローチに慣れている場合は、[Kanbanボード](https://github.com/orgs/RooVetGit/projects/1)を使い、GitHub上でIssueやPull Requestを通じて直接参加できます。
-
-## II. 貢献内容の発見と計画
-
-何に取り組むか、どう進めるかを決めましょう。
-
-### 1. 貢献の種類
+- **主な方法：** [Discord](https://discord.gg/roocode)に参加し、**Hannes Rudolph (`hrudolph`)**にDMを送る。
+- **代替手段：** 経験豊富なコントリビューターは[GitHub Projects](https://github.com/orgs/RooVetGit/projects/1)を通じて直接参加できます。
 
-さまざまな貢献を歓迎します：
+## 貢献内容の発見と計画
 
-- **バグ修正**：既存コードの問題を修正
-- **新機能**：新しい機能の追加
-- **ドキュメント**：ガイドや例の改善、誤字修正
+### 貢献の種類
 
-### 2. 重要な原則: Issue-First アプローチ
+- **バグ修正：** コードの問題を解決。
+- **新機能：** 機能を追加。
+- **ドキュメント：** ガイドを改善し明確にする。
 
-**すべての貢献は GitHub Issue から始めてください。** これは方向性の統一と無駄な作業を防ぐために重要です。
+### Issue-First アプローチ
 
-- **Issue を探す/作成する**：
-    - 作業を始める前に、[GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) で既存のIssueがあるか確認してください。
-    - 既存で未割り当てなら、コメントして担当希望を伝えてください。メンテナーが割り当てます。
-    - なければ、[Issuesページ](https://github.com/RooVetGit/Roo-Code/issues/new/choose)で適切なテンプレートを使って新規作成：
-        - バグは「Bug Report」テンプレート
-        - 新機能は「Detailed Feature Proposal」テンプレート。実装前にメンテナー（特に@hannesrudolph）の承認を待ってください。
-        - **注**：機能のアイデアや初期議論は[GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests)で始められます。具体化したら「Detailed Feature Proposal」Issueを作成してください。
-- **担当表明と割り当て**：
-    - 担当したいIssueにはコメントで意思表示してください。
-    - メンテナーが正式にGitHubで割り当てるのを待ちましょう。重複作業を防げます。
-- **守らない場合の結果**：
-    - 関連Issueがない、承認・割り当てされていないPRは、完全なレビューなしでクローズされる場合があります。これはプロジェクトの優先順位を守り、みんなの時間を大切にするためです。
+すべての貢献はGitHub Issueから始めてください。
 
-このアプローチで作業の追跡、変更の必要性の確認、効果的な連携ができます。
+- **既存Issueの確認：** [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)を検索。
+- **Issueの作成：** 適切なテンプレートを使用：
+    - **バグ：** 「Bug Report」テンプレート。
+    - **機能：** 「Detailed Feature Proposal」テンプレート。開始前に承認が必要。
+- **Issue担当表明：** コメントし、正式な割り当てを待つ。
 
-### 3. 何に取り組むか決める
+**承認されたIssueに紐付けられていないPRは閉じられる可能性があります。**
 
-- **Good First Issues**：GitHubの[「Issue [Unassigned]」セクション](https://github.com/orgs/RooVetGit/projects/1)をチェック
-- **ドキュメント**：この `CONTRIBUTING.md` はコード貢献の主なガイドですが、他のドキュメント（ユーザーガイドやAPIドキュメントなど）に貢献したい場合は、[Roo Code Docsリポジトリ](https://github.com/RooVetGit/Roo-Code-Docs)を参照するか、Discordコミュニティで質問してください。
-- **新機能の提案**：
-    1.  **初期アイデア/議論**：大まかなアイデアや初期の提案は[GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests)で始めてください。
-    2.  **正式な提案**：具体的で実装可能な提案は[Issuesページ](https://github.com/RooVetGit/Roo-Code/issues/new/choose)の「Detailed Feature Proposal」テンプレートでIssueを作成してください。これは**Issue-Firstアプローチ**の重要な部分です。
+### 何に取り組むか決める
 
-### 4. バグや問題の報告
+- 未割り当ての「Good First Issues」を[GitHub Project](https://github.com/orgs/RooVetGit/projects/1)でチェック。
+- ドキュメント関連は[Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs)を参照。
 
-バグを見つけた場合：
+### バグの報告
 
-1.  **既存Issueの検索**：[GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)で重複がないか確認
-2.  **新規Issueの作成**：ユニークな場合は[Issuesページ](https://github.com/RooVetGit/Roo-Code/issues/new/choose)の「Bug Report」テンプレートを使う
+- まず既存の報告がないか確認。
+- 新しいバグは[「Bug Report」テンプレート](https://github.com/RooVetGit/Roo-Code/issues/new/choose)で報告。
+- **セキュリティ問題：** [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new)を通じて非公開で報告。
 
-> 🔐 **セキュリティ脆弱性**：脆弱性を発見した場合は[GitHubのSecurity Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new)で非公開で報告してください。公開Issueは作成しないでください。
+## 開発と提出のプロセス
 
-## III. 開発と提出のプロセス
+### 開発環境のセットアップ
 
-以下の手順でコーディングと提出を進めてください。
+1. **Fork & Clone：**
 
-### 1. 開発環境のセットアップ
-
-1.  **Fork & Clone**：
-    - GitHubでリポジトリをフォーク
-    - 自分のフォークをローカルにクローン：`git clone https://github.com/あなたのユーザー名/Roo-Code.git`
-2.  **依存関係のインストール**：`npm run install:all`
-3.  **Webview（開発モード）を起動**：`npm run dev`（Vite/ReactアプリのHMR用）
-4.  **拡張機能のデバッグ**：VS Codeで `F5`（または **Run** → **Start Debugging**）を押して、Roo Codeが読み込まれた新しい Extension Development Host ウィンドウを開く
-
-webview（`webview-ui`）の変更はHot Module Replacementですぐ反映されます。コア拡張（`src`）の変更はExtension Development Hostの再起動が必要です。
-
-また、`.vsix`パッケージをビルド・インストールする場合：
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/あなたのユーザー名/Roo-Code.git
 ```
 
-（`<version>`はビルドされたファイルの実際のバージョン番号に置き換えてください）
-
-### 2. コーディングガイドライン
-
-- **フォーカスしたPR**：1つの機能/バグ修正ごとに1つのPR
-- **コード品質**：
-    - CIチェック（リント、フォーマット）を通す
-    - ESLintの警告やエラーを修正（`npm run lint`）
-    - 自動コードレビューのフィードバックに対応
-    - TypeScriptのベストプラクティスを守り、型安全を維持
-- **テスト**：
-    - 新機能にはテストを追加
-    - `npm test`で全テストが通ることを確認
-    - 既存テストに影響がある場合は更新
-- **コミットメッセージ**：
-    - 明確で説明的なコミットメッセージを書く
-    - 関連Issueを `#issue-number`（例：`Fixes #123`）で参照
-- **PR提出前のチェックリスト**：
-    - ブランチを最新のupstream `main`にリベース
-    - コードがビルドできることを確認（`npm run build`）
-    - すべてのテストが通ることを確認（`npm test`）
-    - デバッグ用コードや `console.log` を削除
-
-### 3. コード提出: Pull Request (PR) プロセス
-
-#### ドラフト Pull Request
-
-まだ完全なレビュー準備ができていない作業にはドラフトPRを使いましょう：
-
-- 自動チェック（CI）を走らせたい
-- メンテナーや他のコントリビューターから早めにフィードバックが欲しい
-- 作業中であることを示したい
-
-すべてのチェックが通り、「コーディングガイドライン」と「Pull Request の説明」の基準を満たしていると思ったら「Ready for Review」にしてください。
-
-#### Pull Request の説明
-
-PRの説明は十分に詳細で、[Pull Request テンプレート](.github/pull_request_template.md)の構成に従ってください。主なポイント：
-
-- 対応する承認済みGitHub Issueへのリンク
-- 変更内容と目的の明確な説明
-- 変更をテストするための詳細な手順
-- 重大な変更点（breaking changes）のリスト
-- **UI変更の場合はビフォーアフターのスクリーンショットや動画**
-- **PRでユーザードキュメントの更新が必要な場合は、どのドキュメント/セクションか明記**
-
-#### Pull Request (PR) ポリシー
-
-##### 目的
-
-クリーンでフォーカスされた、管理しやすいPRバックログを維持すること。
+2. **依存関係のインストール：**
 
-##### Issue-First アプローチ
+```
+npm run install:all
+```
 
-- **必須**：作業開始前に、既存で承認・割り当て済みのGitHub Issue（「Bug Report」または「Detailed Feature Proposal」）が必要
-- **承認**：特に大きな変更の場合、メンテナー（特に@hannesrudolph）による事前承認が必要
-- **参照**：PRの説明でこれらのIssueを明示的に参照すること
-- **違反時の結果**：このプロセスを守らないPRは、完全なレビューなしでクローズされる場合があります
+3. **デバッグ：** VS Codeで`F5`を押して開く。
 
-##### オープンPRの条件
+### コーディングガイドライン
 
-- **マージ準備完了**：すべてのCIテストに合格し、（該当する場合）ロードマップに沿い、承認・割り当て済みIssueに紐付けられ、明確なドキュメント/コメントがあり、UI変更にはビフォーアフター画像/動画がある
-- **クローズ対象**：CIテスト失敗、大きなマージコンフリクト、プロジェクト目標と不一致、長期間（30日超）フィードバック後に更新なし
+- 1つの機能または修正ごとに1つのPR。
+- ESLintとTypeScriptのベストプラクティスに従う。
+- 関連Issueを参照する明確なコミットメッセージを書く（例：`Fixes #123`）。
+- 十分なテストを提供（`npm test`）。
+- 提出前に最新の`main`ブランチにリベース。
 
-##### 手順
+### Pull Request の提出
 
-1.  **Issueの確認と割り当て**：@hannesrudolph（または他のメンテナー）が新規・既存Issueを確認し、割り当てる
-2.  **初期PRトリアージ（毎日）**：メンテナーが新規PRを素早くチェックし、緊急・重要なものを振り分け
-3.  **詳細なPRレビュー（週次）**：メンテナーがPRの準備状況、Issueとの整合性、全体品質を詳細に確認
-4.  **詳細なフィードバックと反復**：レビューに基づき、Approve/Request Changes/Rejectのフィードバック。コントリビューターは対応・修正
-5.  **決定段階**：承認されたPRはマージ。不適合や解決不能なPRは理由を明記してクローズ
-6.  **フォローアップ**：クローズされたPRの著者は、問題解決や方向転換後に新たなPRを提出可能
+- 早期フィードバックを求める場合は**ドラフトPR**から始める。
+- Pull Requestテンプレートに従って変更を明確に説明。
+- UI変更のスクリーンショット/動画を提供。
+- ドキュメント更新が必要かどうかを示す。
 
-##### 責任
+### Pull Request ポリシー
 
-- **Issueの確認とプロセス遵守（@hannesrudolph & メンテナー）**：すべての貢献がIssue-Firstアプローチに従うよう確認し、コントリビューターをガイド
-- **メンテナー（開発チーム）**：PRの初期・詳細レビュー、技術的フィードバック、承認/却下判断、マージ
-- **コントリビューター**：承認・割り当て済みIssueに紐付け、品質ガイドライン遵守、迅速なフィードバック対応
+- 承認・割り当て済みIssueを参照する必要がある。
+- ポリシーに従わないPRは閉じられる可能性がある。
+- PRはCIテストに合格し、ロードマップに沿い、明確なドキュメントを持つべき。
 
-このポリシーは明確さと効率的な統合を保証します。
+### レビュープロセス
 
-## IV. 法的事項
+- **日次トリアージ：** メンテナーによる迅速なチェック。
+- **週次詳細レビュー：** 包括的な評価。
+- **フィードバックに基づいて迅速に改善**。
 
-### 貢献契約
+## 法的事項
 
-Pull Request を提出することで、あなたの貢献が [Apache 2.0 ライセンス](LICENSE)（またはプロジェクトの現行ライセンス）で提供されることに同意したことになります。プロジェクトと同じです。
+Pull Requestを提出することで、あなたの貢献がRoo Codeと同じApache 2.0ライセンスの下で提供されることに同意したことになります。

locales/ko/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Roo Code 기여 가이드
 
-Roo Code는 커뮤니티 주도의 프로젝트이며, 모든 기여를 소중하게 생각합니다. 모두를 위한 원활하고 효과적인 프로세스를 위해 **"[Issue-First](#2-핵심-원칙-issue-first-접근법)" 원칙**을 따릅니다. 즉, 모든 작업은 Pull Request를 제출하기 _전에_ 반드시 GitHub Issue와 연결되어야 합니다(자세한 내용은 [PR 정책](#pull-request-pr-정책) 참고). 이 가이드를 꼼꼼히 읽고 기여 방법을 이해해 주세요.
-이 가이드는 Roo Code에 버그 수정, 기능 추가, 문서 개선 등 다양한 방식으로 기여하는 방법을 안내합니다.
+Roo Code는 커뮤니티 주도의 프로젝트이며, 모든 기여를 소중하게 생각합니다. 협업을 간소화하기 위해 [Issue-First](#issue-first-접근법) 원칙을 적용하고 있으며, 이는 모든 [Pull Request (PR)](#pull-request-제출)가 먼저 GitHub Issue와 연결되어야 함을 의미합니다. 이 가이드를 주의 깊게 검토해 주세요.
 
 ## 목차
 
-- [I. 기여 전 준비](#i-기여-전-준비)
-    - [1. 행동 강령](#1-행동-강령)
-    - [2. 프로젝트 로드맵 이해](#2-프로젝트-로드맵-이해)
-        - [신뢰성 우선](#신뢰성-우선)
-        - [향상된 사용자 경험](#향상된-사용자-경험)
-        - [에이전트 성능 선도](#에이전트-성능-선도)
-    - [3. Roo Code 커뮤니티 참여](#3-roo-code-커뮤니티-참여)
-- [II. 기여 내용 찾기 및 계획 세우기](#ii-기여-내용-찾기-및-계획-세우기)
-    - [1. 기여 유형](#1-기여-유형)
-    - [2. 핵심 원칙: Issue-First 접근법](#2-핵심-원칙-issue-first-접근법)
-    - [3. 작업 선택하기](#3-작업-선택하기)
-    - [4. 버그 및 이슈 신고](#4-버그-및-이슈-신고)
-- [III. 개발 및 제출 프로세스](#iii-개발-및-제출-프로세스)
-    - [1. 개발 환경 설정](#1-개발-환경-설정)
-    - [2. 코드 작성 가이드라인](#2-코드-작성-가이드라인)
-    - [3. 코드 제출: Pull Request (PR) 프로세스](#3-코드-제출-pull-request-pr-프로세스)
-        - [드래프트 Pull Request](#드래프트-pull-request)
-        - [Pull Request 설명](#pull-request-설명)
-        - [Pull Request (PR) 정책](#pull-request-pr-정책)
-            - [목표](#목표)
-            - [Issue-First 접근법](#issue-first-접근법)
-            - [오픈 PR 조건](#오픈-pr-조건)
-            - [절차](#절차)
-            - [책임](#책임)
-- [IV. 법적 안내](#iv-법적-안내)
-    - [기여 동의서](#기여-동의서)
-
-## I. 기여 전 준비
-
-먼저, 커뮤니티 기준과 프로젝트 방향을 숙지하세요.
+- [기여 전 준비](#기여-전-준비)
+- [기여 내용 찾기 및 계획 세우기](#기여-내용-찾기-및-계획-세우기)
+- [개발 및 제출 프로세스](#개발-및-제출-프로세스)
+- [법적 안내](#법적-안내)
 
-### 1. 행동 강령
-
-모든 기여자는 [행동 강령](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md)을 준수해야 합니다. 기여 전 반드시 읽어주세요.
+## 기여 전 준비
 
-### 2. 프로젝트 로드맵 이해
+### 1. 행동 강령
 
-Roo Code는 명확한 개발 로드맵을 가지고 있으며, 우리의 우선순위와 미래 방향을 제시합니다. 로드맵을 이해하면 다음과 같은 도움이 됩니다:
+모든 기여자는 [행동 강령](./CODE_OF_CONDUCT.md)을 준수해야 합니다.
 
-- 기여를 프로젝트 목표에 맞출 수 있음
-- 본인의 전문성이 가장 필요한 영역을 찾을 수 있음
-- 특정 설계 결정의 배경을 이해할 수 있음
-- 비전을 지원하는 새로운 기능에 대한 영감을 얻을 수 있음
+### 2. 프로젝트 로드맵
 
-우리는 Roo Code를 AI 기반 코딩 도구를 구축하는 개발자들의 최고 선택지로 만드는 데 집중하고 있습니다. 다음은 이를 달성하기 위한 방법입니다:
+로드맵은 프로젝트 방향을 안내합니다. 기여를 다음 핵심 목표에 맞추세요:
 
-#### 신뢰성 우선
+### 신뢰성 우선
 
 - diff 편집과 명령 실행의 일관된 신뢰성 보장
 - 정기적 사용을 방해하는 마찰점 감소
 - 모든 언어 환경과 플랫폼에서의 원활한 작동 보장
 - 다양한 AI 제공업체 및 모델에 대한 강력한 지원 확대
 
-#### 향상된 사용자 경험
+### 향상된 사용자 경험
 
 - 명확성과 직관성을 위한 UI/UX 간소화
 - 개발자들이 일상적으로 사용하는 도구에 기대하는 높은 기준을 충족하기 위한 지속적인 워크플로우 개선
 
-#### 에이전트 성능 선도
+### 에이전트 성능 선도
 
 - 실제 생산성을 측정하는 포괄적인 평가 기준(evals) 수립
 - 누구나 이러한 평가를 쉽게 실행하고 해석할 수 있도록 지원
-- 평가 점수의 명확한 향상을 보여주는 Roo Code 개선 제공
+- 평가 점수의 명확한 향상을 보여주는 개선 제공
 
-로드맵 목표를 앞당기는 기여는 특히 환영합니다. 위 기둥과 관련된 작업을 한다면 PR 설명에 꼭 언급해 주세요.
+PR에서 이러한 영역과의 연관성을 언급하세요.
 
 ### 3. Roo Code 커뮤니티 참여
 
-Roo Code 커뮤니티와 소통하는 것은 시작하기에 좋은 방법입니다:
-
-- **주요 방법**:
-    1.  [Roo Code Discord 커뮤니티](https://discord.gg/roocode)에 가입하세요.
-    2.  가입 후 **Hannes Rudolph**(Discord: `hrudolph`)에게 DM을 보내 관심을 알리고 안내를 받으세요.
-- **경험자용 대안**: Issue-First 접근법에 익숙하다면 [Kanban 보드](https://github.com/orgs/RooVetGit/projects/1)를 따라가며 GitHub에서 Issue 및 Pull Request로 직접 참여할 수 있습니다.
-
-## II. 기여 내용 찾기 및 계획 세우기
-
-무엇을 할지, 어떻게 할지 결정하세요.
-
-### 1. 기여 유형
+- **주요 방법:** [Discord](https://discord.gg/roocode)에 가입하고 **Hannes Rudolph (`hrudolph`)**에게 DM을 보내세요.
+- **대안:** 경험 많은 기여자는 [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1)를 통해 직접 참여할 수 있습니다.
 
-다양한 기여를 환영합니다:
+## 기여 내용 찾기 및 계획 세우기
 
-- **버그 수정**: 기존 코드의 문제 해결
-- **새 기능**: 새로운 기능 추가
-- **문서화**: 가이드, 예제 개선 또는 오타 수정
+### 기여 유형
 
-### 2. 핵심 원칙: Issue-First 접근법
+- **버그 수정:** 코드 문제 해결.
+- **새 기능:** 기능 추가.
+- **문서화:** 가이드 개선 및 명확성 향상.
 
-**모든 기여는 GitHub Issue에서 시작해야 합니다.** 이는 방향성 일치와 불필요한 노력을 방지하기 위해 중요합니다.
+### Issue-First 접근법
 
-- **Issue 찾기/생성**:
-    - 시작 전 [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)에서 관련 Issue가 있는지 확인하세요.
-    - 있다면, 할당되지 않은 경우 댓글로 참여 의사를 밝히세요. 메인테이너가 할당합니다.
-    - 없다면, [Issues 페이지](https://github.com/RooVetGit/Roo-Code/issues/new/choose)에서 적절한 템플릿으로 새 Issue를 만드세요:
-        - 버그는 "Bug Report" 템플릿
-        - 새 기능은 "Detailed Feature Proposal" 템플릿. 구현 전 메인테이너(특히 @hannesrudolph) 승인 필요
-        - **참고**: 기능 아이디어나 초기 논의는 [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests)에서 시작할 수 있습니다. 구체화되면 "Detailed Feature Proposal" Issue를 만드세요.
-- **담당 표명 및 할당**:
-    - Issue에 댓글로 작업 의사를 명확히 밝히세요.
-    - 메인테이너가 공식적으로 GitHub에서 할당할 때까지 기다리세요. 중복 작업을 방지합니다.
-- **지키지 않을 경우**:
-    - 관련 Issue가 없거나 승인·할당되지 않은 PR은 전체 리뷰 없이 닫힐 수 있습니다. 이는 프로젝트 우선순위와 모두의 시간을 존중하기 위함입니다.
+모든 기여는 GitHub Issue에서 시작해야 합니다.
 
-이 접근법은 작업 추적, 변경 필요성 확인, 효과적인 협업에 도움이 됩니다.
+- **기존 Issue 확인:** [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)를 검색하세요.
+- **Issue 생성:** 적절한 템플릿 사용:
+    - **버그:** "Bug Report" 템플릿.
+    - **기능:** "Detailed Feature Proposal" 템플릿. 시작 전 승인 필요.
+- **Issue 담당:** 댓글을 달고 공식 할당을 기다리세요.
 
-### 3. 작업 선택하기
+**승인된 Issue 없는 PR은 닫힐 수 있습니다.**
 
-- **Good First Issues**: GitHub의 [Issue [Unassigned] 섹션](https://github.com/orgs/RooVetGit/projects/1) 참고
-- **문서화**: 이 `CONTRIBUTING.md`는 코드 기여의 주요 가이드지만, 다른 문서(사용자 가이드, API 문서 등)에 기여하고 싶다면 [Roo Code Docs 저장소](https://github.com/RooVetGit/Roo-Code-Docs)를 참고하거나 Discord 커뮤니티에 문의하세요.
-- **새 기능 제안**:
-    1.  **초기 아이디어/논의**: 큰 틀의 아이디어나 초기 제안은 [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests)에서 시작하세요.
-    2.  **공식 제안**: 구체적이고 실행 가능한 제안은 [Issues 페이지](https://github.com/RooVetGit/Roo-Code/issues/new/choose)에서 "Detailed Feature Proposal" 템플릿으로 Issue를 만드세요. 이는 **Issue-First 접근법**의 핵심입니다.
+### 작업 선택하기
 
-### 4. 버그 및 이슈 신고
+- 할당되지 않은 "Good First Issues"를 [GitHub 프로젝트](https://github.com/orgs/RooVetGit/projects/1)에서 확인하세요.
+- 문서 관련은 [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs)를 참조하세요.
 
-버그를 발견했다면:
+### 버그 신고
 
-1.  **기존 Issue 검색**: [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)에서 중복 여부 확인
-2.  **새 Issue 생성**: 고유하다면 [Issues 페이지](https://github.com/RooVetGit/Roo-Code/issues/new/choose)에서 "Bug Report" 템플릿 사용
+- 먼저 기존 신고를 확인하세요.
+- ["Bug Report" 템플릿](https://github.com/RooVetGit/Roo-Code/issues/new/choose)을 사용하여 새 버그를 신고하세요.
+- **보안 문제:** [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new)를 통해 비공개로 신고하세요.
 
-> 🔐 **보안 취약점**: 보안 취약점을 발견하면 [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new)로 비공개 신고하세요. 공개 Issue는 만들지 마세요.
+## 개발 및 제출 프로세스
 
-## III. 개발 및 제출 프로세스
+### 개발 환경 설정
 
-아래 단계에 따라 코딩하고 제출하세요.
+1. **Fork & Clone:**
 
-### 1. 개발 환경 설정
-
-1.  **Fork & Clone**:
-    - GitHub에서 저장소를 포크하세요.
-    - 포크한 저장소를 로컬에 클론: `git clone https://github.com/당신의_아이디/Roo-Code.git`
-2.  **의존성 설치**: `npm run install:all`
-3.  **Webview(개발 모드) 실행**: `npm run dev` (Vite/React 앱의 HMR용)
-4.  **확장 디버깅**: VS Code에서 `F5`(또는 **Run** → **Start Debugging**)를 눌러 Roo Code가 로드된 Extension Development Host 창을 엽니다.
-
-webview(`webview-ui`) 변경은 Hot Module Replacement로 즉시 반영됩니다. 코어 확장(`src`) 변경은 Extension Development Host 재시작 필요.
-
-또는 `.vsix` 패키지 빌드 및 설치:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<version>.vsix
+```
+git clone https://github.com/당신의_아이디/Roo-Code.git
 ```
 
-(`<version>`은 빌드된 파일의 실제 버전 번호로 대체)
-
-### 2. 코드 작성 가이드라인
-
-- **집중된 PR**: 기능/버그 수정별로 하나의 PR
-- **코드 품질**:
-    - CI 체크(린트, 포맷) 통과
-    - ESLint 경고/오류 수정(`npm run lint`)
-    - 자동 코드 리뷰 도구 피드백 반영
-    - TypeScript 베스트 프랙티스 준수 및 타입 안전성 유지
-- **테스트**:
-    - 새 기능에는 테스트 추가
-    - `npm test`로 모든 테스트 통과 확인
-    - 기존 테스트에 영향이 있으면 업데이트
-- **커밋 메시지**:
-    - 명확하고 설명적인 메시지 작성
-    - 관련 Issue를 `#issue-number`(예: `Fixes #123`)로 참조
-- **PR 제출 전 체크리스트**:
-    - 브랜치를 최신 upstream `main`에 리베이스
-    - 코드 빌드 확인(`npm run build`)
-    - 모든 테스트 통과 확인(`npm test`)
-    - 디버깅 코드나 `console.log` 삭제
-
-### 3. 코드 제출: Pull Request (PR) 프로세스
-
-#### 드래프트 Pull Request
-
-아직 전체 리뷰 준비가 안 된 작업에는 드래프트 PR을 사용하세요:
-
-- 자동 체크(CI) 실행
-- 메인테이너나 다른 기여자에게 조기 피드백 요청
-- 작업 진행 중임을 표시
-
-모든 체크를 통과하고 "코드 작성 가이드라인"과 "Pull Request 설명" 기준을 충족한다고 생각되면 "Ready for Review"로 전환하세요.
-
-#### Pull Request 설명
-
-PR 설명은 충분히 상세해야 하며, [Pull Request 템플릿](.github/pull_request_template.md) 구조를 따라야 합니다. 주요 포인트:
-
-- 승인된 GitHub Issue 링크
-- 변경 내용 및 목적의 명확한 설명
-- 변경 테스트 방법의 상세 단계
-- 주요 변경점(breaking changes) 목록
-- **UI 변경 시, 전후 스크린샷 또는 동영상**
-- **PR로 사용자 문서 업데이트가 필요한 경우, 어떤 문서/섹션인지 명시**
-
-#### Pull Request (PR) 정책
-
-##### 목표
-
-깔끔하고 집중된, 관리하기 쉬운 PR 백로그 유지
+2. **의존성 설치:**
 
-##### Issue-First 접근법
+```
+npm run install:all
+```
 
-- **필수**: 작업 시작 전, 승인·할당된 GitHub Issue("Bug Report" 또는 "Detailed Feature Proposal")가 있어야 함
-- **승인**: 특히 큰 변경의 경우, 메인테이너(특히 @hannesrudolph) 사전 승인 필요
-- **참조**: PR 설명에 해당 Issue를 명확히 참조
-- **미준수 시**: 이 과정을 따르지 않으면 PR이 전체 리뷰 없이 닫힐 수 있음
+3. **디버깅:** VS Code에서 `F5`를 눌러 실행하세요.
 
-##### 오픈 PR 조건
+### 코드 작성 가이드라인
 
-- **머지 준비 완료**: 모든 CI 테스트 통과, (해당 시) 로드맵과 일치, 승인·할당된 Issue와 연결, 명확한 문서/주석, UI 변경 시 전후 이미지/동영상 포함
-- **닫힘 대상**: CI 실패, 큰 머지 충돌, 프로젝트 목표 불일치, 장기간(30일 이상) 피드백 후 미업데이트
+- 하나의 기능 또는 수정당 하나의 집중된 PR.
+- ESLint와 TypeScript 모범 사례를 따르세요.
+- Issue를 참조하는 명확한 커밋 메시지를 작성하세요(예: `Fixes #123`).
+- 철저한 테스트를 제공하세요(`npm test`).
+- 제출 전 최신 `main` 브랜치에 리베이스하세요.
 
-##### 절차
+### Pull Request 제출
 
-1.  **Issue 확인 및 할당**: @hannesrudolph(또는 다른 메인테이너)이 신규/기존 Issue를 검토·할당
-2.  **초기 PR 트리아지(매일)**: 메인테이너가 신규 PR을 빠르게 검토, 긴급/중요 이슈 분류
-3.  **상세 PR 리뷰(주간)**: 메인테이너가 PR 준비 상태, Issue 일치, 전체 품질을 상세 검토
-4.  **상세 피드백 및 반복**: 리뷰 후 Approve/Request Changes/Reject 피드백 제공, 기여자는 대응·수정
-5.  **결정 단계**: 승인된 PR은 머지, 부적합/해결불가 PR은 사유 명시 후 닫힘
-6.  **후속 조치**: 닫힌 PR 작성자는 문제 해결·방향 전환 후 새 PR 제출 가능
+- 초기 피드백을 원한다면 **드래프트 PR**로 시작하세요.
+- Pull Request 템플릿에 따라 변경 사항을 명확히 설명하세요.
+- UI 변경에 대한 스크린샷/동영상을 제공하세요.
+- 문서 업데이트가 필요한지 표시하세요.
 
-##### 책임
+### Pull Request 정책
 
-- **Issue 확인 및 프로세스 준수(@hannesrudolph & 메인테이너)**: 모든 기여가 Issue-First 접근법을 따르도록 확인, 기여자 안내
-- **메인테이너(개발팀)**: PR 초기/상세 리뷰, 기술 피드백, 승인/거부 결정, 머지
-- **기여자**: 승인·할당된 Issue와 연결, 품질 가이드라인 준수, 신속한 피드백 대응
+- 사전 승인 및 할당된 Issue를 참조해야 합니다.
+- 정책을 준수하지 않는 PR은 닫힐 수 있습니다.
+- PR은 CI 테스트를 통과하고, 로드맵에 부합하며, 명확한 문서를 갖추어야 합니다.
 
-이 정책은 명확성과 효율적 통합을 보장합니다.
+### 리뷰 프로세스
 
-## IV. 법적 안내
+- **일일 분류:** 메인테이너의 빠른 검토.
+- **주간 심층 리뷰:** 종합적인 평가.
+- **피드백에 따라 신속히 반복**하세요.
 
-### 기여 동의서
+## 법적 안내
 
-Pull Request를 제출함으로써, 귀하의 기여가 [Apache 2.0 라이선스](LICENSE)(또는 프로젝트의 현행 라이선스)로 제공됨에 동의하는 것입니다. 프로젝트와 동일하게 적용됩니다.
+기여함으로써, 귀하의 기여가 Roo Code의 라이선스와 일치하는 Apache 2.0 라이선스 하에 제공됨에 동의합니다.

locales/nl/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Bijdragen aan Roo Code
 
-Roo Code is een door de community gedreven project en we waarderen elke bijdrage enorm. Om het proces voor iedereen soepel en effectief te laten verlopen, **werken we volgens een "[Issue-First](#2-belangrijk-principe-issue-first-aanpak)" principe.** Dit betekent dat al het werk gekoppeld moet zijn aan een GitHub Issue _voordat_ er een Pull Request wordt ingediend (zie ons [PR-beleid](#pull-request-pr-beleid) voor details). Lees deze gids zorgvuldig door om te begrijpen hoe je kunt bijdragen.
-Deze gids beschrijft hoe je kunt bijdragen aan Roo Code, of je nu bugs oplost, functies toevoegt of documentatie verbetert.
+Roo Code is een door de community gedreven project en we waarderen elke bijdrage enorm. Om de samenwerking te stroomlijnen, werken we volgens een [Issue-First](#issue-first-aanpak) principe, wat betekent dat alle [Pull Requests (PR's)](#een-pull-request-indienen) eerst gekoppeld moeten worden aan een GitHub Issue. Lees deze gids zorgvuldig door.
 
 ## Inhoudsopgave
 
-- [I. Voordat je bijdraagt](#i-voordat-je-bijdraagt)
-    - [1. Gedragscode](#1-gedragscode)
-    - [2. De project-roadmap begrijpen](#2-de-project-roadmap-begrijpen)
-        - [Betrouwbaarheid eerst](#betrouwbaarheid-eerst)
-        - [Verbeterde gebruikerservaring](#verbeterde-gebruikerservaring)
-        - [Voorop lopen in agent-prestaties](#voorop-lopen-in-agent-prestaties)
-    - [3. Word lid van de Roo Code-community](#3-word-lid-van-de-roo-code-community)
-- [II. Je bijdrage vinden & plannen](#ii-je-bijdrage-vinden--plannen)
-    - [1. Soorten bijdragen](#1-soorten-bijdragen)
-    - [2. Belangrijk principe: Issue-First-aanpak](#2-belangrijk-principe-issue-first-aanpak)
-    - [3. Bepalen waar je aan werkt](#3-bepalen-waar-je-aan-werkt)
-    - [4. Bugs of problemen melden](#4-bugs-of-problemen-melden)
-- [III. Ontwikkelings- & indieningsproces](#iii-ontwikkelings--indieningsproces)
-    - [1. Ontwikkelomgeving instellen](#1-ontwikkelomgeving-instellen)
-    - [2. Richtlijnen voor het schrijven van code](#2-richtlijnen-voor-het-schrijven-van-code)
-    - [3. Code indienen: Pull Request (PR) proces](#3-code-indienen-pull-request-pr-proces)
-        - [Concept-Pull Requests](#concept-pull-requests)
-        - [Pull Request-beschrijving](#pull-request-beschrijving)
-        - [Pull Request (PR) beleid](#pull-request-pr-beleid)
-            - [Doelstelling](#doelstelling)
-            - [Issue-First-aanpak](#issue-first-aanpak)
-            - [Voorwaarden voor open PR's](#voorwaarden-voor-open-prs)
-            - [Procedure](#procedure)
-            - [Verantwoordelijkheden](#verantwoordelijkheden)
-- [IV. Juridisch](#iv-juridisch)
-    - [Bijdrageovereenkomst](#bijdrageovereenkomst)
-
-## I. Voordat je bijdraagt
-
-Maak je eerst vertrouwd met onze community-standaarden en de richting van het project.
+- [Voordat je bijdraagt](#voordat-je-bijdraagt)
+- [Je bijdrage vinden & plannen](#je-bijdrage-vinden--plannen)
+- [Ontwikkelings- & indieningsproces](#ontwikkelings--indieningsproces)
+- [Juridisch](#juridisch)
 
-### 1. Gedragscode
-
-Alle bijdragers moeten zich houden aan onze [Gedragscode](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Lees deze voordat je bijdraagt.
+## Voordat je bijdraagt
 
-### 2. De project-roadmap begrijpen
+### 1. Gedragscode
 
-Roo Code heeft een duidelijke ontwikkel-roadmap die onze prioriteiten en toekomstige richting bepaalt. Door de roadmap te begrijpen kun je:
+Alle bijdragers moeten zich houden aan onze [Gedragscode](./CODE_OF_CONDUCT.md).
 
-- Je bijdragen afstemmen op de projectdoelen
-- Gebieden vinden waar jouw expertise het meest waardevol is
-- De context achter bepaalde ontwerpbeslissingen begrijpen
-- Inspiratie opdoen voor nieuwe functies die onze visie ondersteunen
+### 2. De project-roadmap
 
-We richten ons erop om Roo Code de beste keuze te maken voor ontwikkelaars die met AI-gestuurde codeertools werken. Zo gaan we dit bereiken:
+Onze roadmap bepaalt de richting van het project. Stem je bijdragen af op deze kernpunten:
 
-#### Betrouwbaarheid eerst
+### Betrouwbaarheid eerst
 
 - Zorgen dat diff-bewerking en opdrachtuitvoering consistent betrouwbaar zijn
 - Verminderen van wrijvingspunten die regelmatig gebruik ontmoedigen
 - Garanderen van soepele werking in alle talen en op alle platforms
 - Uitbreiden van robuuste ondersteuning voor een breed scala aan AI-providers en -modellen
 
-#### Verbeterde gebruikerservaring
+### Verbeterde gebruikerservaring
 
 - Vereenvoudigen van de gebruikersinterface voor meer duidelijkheid en intuïtiviteit
-- Continu verbeteren van de workflow om te voldoen aan de hoge verwachtingen die ontwikkelaars hebben voor dagelijks gebruikte tools
+- Continu verbeteren van de workflow om te voldoen aan de hoge verwachtingen van ontwikkelaars
 
-#### Voorop lopen in agent-prestaties
+### Voorop lopen in agent-prestaties
 
 - Opstellen van uitgebreide evaluatiebenchmarks (evals) om productiviteit in de echte wereld te meten
 - Het voor iedereen gemakkelijk maken om deze evaluaties uit te voeren en te interpreteren
-- Verbeteringen aan Roo Code leveren die duidelijke stijgingen in evaluatiescores aantonen
+- Verbeteringen leveren die duidelijke stijgingen in evaluatiescores aantonen
 
-We verwelkomen vooral bijdragen die onze roadmap-doelen bevorderen. Als je werkt aan iets dat aansluit bij deze pijlers, vermeld dit dan in je PR-beschrijving.
+Vermeld de afstemming met deze gebieden in je PR's.
 
 ### 3. Word lid van de Roo Code-community
 
-Contact maken met de Roo Code-community is een geweldige manier om te beginnen:
-
-- **Hoofdmethode**:
-    1.  Word lid van de [Roo Code Discord-community](https://discord.gg/roocode).
-    2.  Stuur vervolgens een direct bericht (DM) naar **Hannes Rudolph** (Discord: `hrudolph`) om je interesse te bespreken en advies te krijgen.
-- **Alternatief voor ervaren bijdragers**: Als je vertrouwd bent met de Issue-First-aanpak, kun je direct via GitHub meedoen door het [Kanban-bord](https://github.com/orgs/RooVetGit/projects/1) te volgen en te communiceren via issues en pull requests.
-
-## II. Je bijdrage vinden & plannen
-
-Bepaal waar je aan wilt werken en hoe je dat aanpakt.
-
-### 1. Soorten bijdragen
+- **Hoofdmethode:** Word lid van onze [Discord](https://discord.gg/roocode) en stuur een DM naar **Hannes Rudolph (`hrudolph`)**.
+- **Alternatief:** Ervaren bijdragers kunnen direct meedoen via [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-We verwelkomen verschillende soorten bijdragen:
+## Je bijdrage vinden & plannen
 
-- **Bugfixes**: Problemen in bestaande code oplossen
-- **Nieuwe functies**: Nieuwe functionaliteit toevoegen
-- **Documentatie**: Handleidingen verbeteren, voorbeelden toevoegen of typefouten corrigeren
+### Soorten bijdragen
 
-### 2. Belangrijk principe: Issue-First-aanpak
+- **Bugfixes:** Problemen in code oplossen.
+- **Nieuwe functies:** Functionaliteit toevoegen.
+- **Documentatie:** Handleidingen verbeteren en verduidelijken.
 
-**Elke bijdrage moet beginnen met een GitHub Issue.** Dit is essentieel om afstemming te waarborgen en verspilde moeite te voorkomen.
+### Issue-First-aanpak
 
-- **Issue zoeken of aanmaken**:
-    - Zoek voordat je begint in [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) of er al een issue bestaat voor jouw bijdrage.
-    - Als het bestaat en niet is toegewezen, reageer dan om aan te geven dat je het wilt oppakken. Een maintainer wijst het dan toe.
-    - Als het niet bestaat, maak dan een nieuwe aan met de juiste template op onze [issues-pagina](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Voor bugs: "Bug Report"-template
-        - Voor nieuwe functies: "Detailed Feature Proposal"-template. Wacht op goedkeuring van een maintainer (vooral @hannesrudolph) voordat je begint met implementeren.
-        - **Let op**: Algemene ideeën of eerste discussies over functies kunnen starten in [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Zodra het idee concreter is, moet er een "Detailed Feature Proposal"-issue worden aangemaakt.
-- **Claimen en toewijzen**:
-    - Geef duidelijk aan dat je aan een issue wilt werken door erop te reageren.
-    - Wacht tot een maintainer het officieel aan je toewijst in GitHub. Zo voorkomen we dat meerdere mensen aan hetzelfde werken.
-- **Gevolgen van niet volgen**:
-    - Pull Requests (PR's) zonder een bijbehorend, vooraf goedgekeurd en toegewezen issue kunnen zonder volledige review worden gesloten. Dit beleid is bedoeld om ervoor te zorgen dat bijdragen aansluiten bij de projectprioriteiten en om ieders tijd te respecteren.
+Elke bijdrage moet beginnen met een GitHub Issue.
 
-Deze aanpak helpt ons om werk te volgen, te zorgen dat wijzigingen gewenst zijn en inspanningen effectief te coördineren.
+- **Bestaande issues controleren:** Zoek in [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Issue aanmaken:** Gebruik de juiste templates:
+    - **Bugs:** "Bug Report"-template.
+    - **Functies:** "Detailed Feature Proposal"-template. Goedkeuring vereist voor je begint.
+- **Issues claimen:** Reageer en wacht op officiële toewijzing.
 
-### 3. Bepalen waar je aan werkt
+**PR's zonder goedgekeurde issues kunnen worden gesloten.**
 
-- **Good First Issues**: Bekijk de sectie "Issue [Unassigned]" van ons [Roo Code Issues-project](https://github.com/orgs/RooVetGit/projects/1) op GitHub.
-- **Documentatie**: Hoewel deze `CONTRIBUTING.md` de hoofdgids is voor codebijdragen, als je wilt bijdragen aan andere documentatie (zoals gebruikershandleidingen of API-documentatie), bekijk dan de [Roo Code Docs-repository](https://github.com/RooVetGit/Roo-Code-Docs) of vraag het in de Discord-community.
-- **Nieuwe functies voorstellen**:
-    1.  **Eerste idee/discussie**: Voor brede of eerste ideeën, start een gesprek in [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Formeel voorstel**: Voor specifieke, uitvoerbare voorstellen, maak een "Detailed Feature Proposal"-issue aan met de template op onze [issues-pagina](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Dit is een belangrijk onderdeel van onze **Issue-First-aanpak**.
+### Bepalen waar je aan werkt
 
-### 4. Bugs of problemen melden
+- Bekijk het [GitHub Project](https://github.com/orgs/RooVetGit/projects/1) voor niet-toegewezen "Good First Issues".
+- Voor documentatie, bezoek [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Als je een bug vindt:
+### Bugs of problemen melden
 
-1.  **Bestaande issues zoeken**: Controleer [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) op duplicaten.
-2.  **Nieuw issue aanmaken**: Als het uniek is, gebruik dan de "Bug Report"-template op onze [issues-pagina](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Controleer eerst of er al meldingen zijn.
+- Maak nieuwe bugmeldingen met de ["Bug Report"-template](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Beveiligingsproblemen:** Meld privé via [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Beveiligingsproblemen**: Als je een beveiligingsprobleem ontdekt, meld dit dan privé via de [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Maak geen openbaar issue voor beveiligingsproblemen.
+## Ontwikkelings- & indieningsproces
 
-## III. Ontwikkelings- & indieningsproces
+### Ontwikkelomgeving instellen
 
-Volg deze stappen voor het coderen en indienen van je werk.
+1. **Fork & Clone:**
 
-### 1. Ontwikkelomgeving instellen
-
-1.  **Fork & Clone**:
-    - Fork de repository op GitHub.
-    - Clone je fork lokaal: `git clone https://github.com/JOUW_GEBRUIKERSNAAM/Roo-Code.git`
-2.  **Installeer afhankelijkheden**: `npm run install:all`
-3.  **Start Webview (Dev Mode)**: `npm run dev` (voor de Vite/React-app met HMR)
-4.  **Debug de extensie**: Druk op `F5` in VS Code (of **Run** → **Start Debugging**) om een nieuw Extension Development Host-venster met Roo Code te openen.
-
-Wijzigingen in webview (`webview-ui`) verschijnen direct dankzij Hot Module Replacement. Wijzigingen aan de core-extensie (`src`) vereisen een herstart van de Extension Development Host.
-
-Je kunt ook een `.vsix`-pakket bouwen en installeren:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<versie>.vsix
+```
+git clone https://github.com/JOUW_GEBRUIKERSNAAM/Roo-Code.git
 ```
 
-(Vervang `<versie>` door het daadwerkelijke versienummer van het gegenereerde bestand.)
-
-### 2. Richtlijnen voor het schrijven van code
-
-- **Gerichte PR's**: Eén feature/bugfix per PR.
-- **Codekwaliteit**:
-    - CI-checks doorstaan (linten, formatteren)
-    - ESLint-waarschuwingen of fouten oplossen (`npm run lint`)
-    - Reageren op feedback van automatische code review-tools
-    - TypeScript best practices volgen en typeveiligheid behouden
-- **Testen**:
-    - Tests toevoegen voor nieuwe features
-    - `npm test` uitvoeren om te zorgen dat alles slaagt
-    - Bestaande tests bijwerken als je wijzigingen ze beïnvloeden
-- **Commitberichten**:
-    - Duidelijke, beschrijvende commitberichten schrijven
-    - Relevante issues refereren met `#issue-nummer` (bijv. `Fixes #123`)
-- **Checklist voor het indienen van een PR**:
-    - Je branch rebasen op de laatste `main` van upstream
-    - Controleren of je code bouwt (`npm run build`)
-    - Alle tests moeten slagen (`npm test`)
-    - Debugcode of `console.log`-statements verwijderen
-
-### 3. Code indienen: Pull Request (PR) proces
-
-#### Concept-Pull Requests
-
-Gebruik concept-PR's voor werk dat nog niet klaar is voor volledige review, maar waarvoor je:
-
-- Geautomatiseerde checks (CI) wilt uitvoeren
-- Vroeg feedback wilt van maintainers of andere bijdragers
-- Wilt aangeven dat het werk in uitvoering is
-
-Markeer een PR pas als "Ready for Review" als alle checks slagen en je denkt dat deze voldoet aan de criteria van "Richtlijnen voor het schrijven van code" en "Pull Request-beschrijving".
-
-#### Pull Request-beschrijving
-
-De beschrijving van je PR moet volledig zijn en de structuur van onze [Pull Request Template](.github/pull_request_template.md) volgen. Belangrijke punten:
-
-- Een link naar het goedgekeurde GitHub Issue dat wordt aangepakt
-- Een duidelijke beschrijving van de gemaakte wijzigingen en het doel ervan
-- Gedetailleerde stappen om de wijzigingen te testen
-- Een lijst van eventuele breaking changes
-- **Voor UI-wijzigingen: voor-en-na screenshots of video's**
-- **Geef aan of je PR gebruikersdocumentatie moet bijwerken en welke documenten/secties worden beïnvloed**
-
-#### Pull Request (PR) beleid
-
-##### Doelstelling
-
-Een schone, gerichte en beheersbare PR-backlog behouden.
+2. **Installeer afhankelijkheden:**
 
-##### Issue-First-aanpak
+```
+npm run install:all
+```
 
-- **Vereist**: Voordat je begint, moet er een bestaand, goedgekeurd en toegewezen GitHub Issue zijn ("Bug Report" of "Detailed Feature Proposal").
-- **Goedkeuring**: Issues, vooral voor grote wijzigingen, moeten vooraf worden beoordeeld en goedgekeurd door maintainers (vooral @hannesrudolph).
-- **Referentie**: PR's moeten deze vooraf goedgekeurde issues expliciet in hun beschrijving vermelden.
-- **Gevolgen**: Niet volgen van dit proces kan ertoe leiden dat je PR zonder volledige review wordt gesloten.
+3. **Debuggen:** Open met VS Code (`F5`).
 
-##### Voorwaarden voor open PR's
+### Richtlijnen voor het schrijven van code
 
-- **Klaar om te mergen**: Slaagt voor alle CI-tests, sluit aan bij de roadmap (indien van toepassing), is gekoppeld aan een goedgekeurd en toegewezen issue, heeft duidelijke documentatie/commentaar, bevat voor-en-na beelden/video's voor UI-wijzigingen
-- **Te sluiten**: CI-testfouten, grote mergeconflicten, geen aansluiting bij projectdoelen of langdurige inactiviteit (>30 dagen zonder updates na feedback)
+- Eén gerichte PR per functie of fix.
+- Volg ESLint en TypeScript best practices.
+- Schrijf duidelijke, beschrijvende commits die verwijzen naar issues (bijv. `Fixes #123`).
+- Zorg voor grondige tests (`npm test`).
+- Rebase op de nieuwste `main`-branch vóór indiening.
 
-##### Procedure
+### Een Pull Request indienen
 
-1.  **Issue-kwalificatie & toewijzing**: @hannesrudolph (of andere maintainers) beoordelen en wijzen nieuwe en bestaande issues toe.
-2.  **Eerste PR-triage (dagelijks)**: Maintainers doen een snelle check van nieuwe PR's op urgentie of kritieke zaken.
-3.  **Grondige PR-review (wekelijks)**: Maintainers beoordelen PR's op gereedheid, aansluiting bij het goedgekeurde issue en algemene kwaliteit.
-4.  **Gedetailleerde feedback & iteratie**: Op basis van de review geven maintainers feedback (Approve, Request Changes, Reject). Van bijdragers wordt verwacht dat ze reageren en waar nodig verbeteren.
-5.  **Beslissingsfase**: Goedgekeurde PR's worden gemerged. PR's met onoplosbare problemen of die niet aansluiten kunnen met uitleg worden gesloten.
-6.  **Follow-up**: Auteurs van gesloten PR's kunnen feedback verwerken en nieuwe PR's openen als problemen zijn opgelost of de projectrichting verandert.
+- Begin als **concept-PR** als je vroege feedback zoekt.
+- Beschrijf je wijzigingen duidelijk volgens de Pull Request Template.
+- Voeg screenshots/video's toe voor UI-wijzigingen.
+- Geef aan of documentatie-updates nodig zijn.
 
-##### Verantwoordelijkheden
+### Pull Request beleid
 
-- **Issue-kwalificatie & procesbewaking (@hannesrudolph & maintainers)**: Zorgen dat alle bijdragen de Issue-First-aanpak volgen. Bijdragers begeleiden in het proces.
-- **Maintainers (Dev Team)**: PR's beoordelen, technisch feedback geven, goedkeuren/afwijzen, PR's mergen.
-- **Bijdragers**: PR's koppelen aan een goedgekeurd en toegewezen issue, voldoen aan kwaliteitsrichtlijnen en snel reageren op feedback.
+- Moet verwijzen naar vooraf goedgekeurde en toegewezen issues.
+- PR's die niet aan het beleid voldoen, kunnen worden gesloten.
+- PR's moeten CI-tests doorstaan, aansluiten bij de roadmap en duidelijke documentatie hebben.
 
-Dit beleid zorgt voor duidelijkheid en efficiënte integratie.
+### Reviewproces
 
-## IV. Juridisch
+- **Dagelijkse triage:** Snelle controles door maintainers.
+- **Wekelijkse diepgaande review:** Uitgebreide beoordeling.
+- **Snel itereren** op basis van feedback.
 
-### Bijdrageovereenkomst
+## Juridisch
 
-Door een pull request in te dienen, ga je ermee akkoord dat je bijdragen worden gelicenseerd onder de [Apache 2.0-licentie](LICENSE) (of de huidige licentie van het project), net als het project.
+Door een pull request in te dienen, ga je ermee akkoord dat je bijdragen worden gelicenseerd onder de Apache 2.0-licentie, in overeenstemming met de licentie van Roo Code.

locales/pl/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Współtworzenie Roo Code
 
-Roo Code to projekt napędzany przez społeczność i bardzo cenimy każdy wkład. Aby zapewnić płynny i skuteczny proces dla wszystkich, **działamy według zasady "[Issue-First](#2-kluczowa-zasada-podejście-issue-first)".** Oznacza to, że każda praca powinna być powiązana z GitHub Issue _przed_ zgłoszeniem Pull Requesta (szczegóły w naszej [Polityce PR](#polityka-pull-request-pr)). Przeczytaj ten przewodnik uważnie, aby dowiedzieć się, jak możesz współtworzyć.
-Ten przewodnik opisuje, jak współtworzyć Roo Code – czy to naprawiając błędy, dodając funkcje, czy ulepszając dokumentację.
+Roo Code to projekt napędzany przez społeczność i bardzo cenimy każdy wkład. Aby usprawnić współpracę, działamy według zasady [Issue-First](#podejście-issue-first), co oznacza, że wszystkie [Pull Requesty (PR)](#zgłaszanie-pull-requesta) muszą najpierw być powiązane z GitHub Issue. Prosimy o uważne zapoznanie się z tym przewodnikiem.
 
 ## Spis treści
 
-- [I. Zanim zaczniesz współtworzyć](#i-zanim-zaczniesz-współtworzyć)
-    - [1. Kodeks postępowania](#1-kodeks-postępowania)
-    - [2. Zrozumienie roadmapy projektu](#2-zrozumienie-roadmapy-projektu)
-        - [Niezawodność przede wszystkim](#niezawodność-przede-wszystkim)
-        - [Ulepszone doświadczenie użytkownika](#ulepszone-doświadczenie-użytkownika)
-        - [Wiodąca pozycja w wydajności agentów](#wiodąca-pozycja-w-wydajności-agentów)
-    - [3. Dołącz do społeczności Roo Code](#3-dołącz-do-społeczności-roo-code)
-- [II. Znajdowanie i planowanie swojego wkładu](#ii-znajdowanie-i-planowanie-swojego-wkładu)
-    - [1. Typy wkładów](#1-typy-wkładów)
-    - [2. Kluczowa zasada: podejście Issue-First](#2-kluczowa-zasada-podejście-issue-first)
-    - [3. Decydowanie, nad czym pracować](#3-decydowanie-nad-czym-pracować)
-    - [4. Zgłaszanie błędów lub problemów](#4-zgłaszanie-błędów-lub-problemów)
-- [III. Proces rozwoju i zgłaszania](#iii-proces-rozwoju-i-zgłaszania)
-    - [1. Konfiguracja środowiska](#1-konfiguracja-środowiska)
-    - [2. Wytyczne dotyczące pisania kodu](#2-wytyczne-dotyczące-pisania-kodu)
-    - [3. Zgłaszanie kodu: proces Pull Request (PR)](#3-zgłaszanie-kodu-proces-pull-request-pr)
-        - [Pull Requesty w wersji roboczej](#pull-requesty-w-wersji-roboczej)
-        - [Opis Pull Requesta](#opis-pull-requesta)
-        - [Polityka Pull Request (PR)](#polityka-pull-request-pr)
-            - [Cel](#cel)
-            - [Podejście Issue-First](#podejście-issue-first)
-            - [Warunki dla otwartych PR](#warunki-dla-otwartych-pr)
-            - [Procedura](#procedura)
-            - [Odpowiedzialności](#odpowiedzialności)
-- [IV. Prawne](#iv-prawne)
-    - [Umowa współtwórcy](#umowa-współtwórcy)
-
-## I. Zanim zaczniesz współtworzyć
-
-Najpierw zapoznaj się ze standardami społeczności i kierunkiem projektu.
+- [Zanim zaczniesz współtworzyć](#zanim-zaczniesz-współtworzyć)
+- [Znajdowanie i planowanie swojego wkładu](#znajdowanie-i-planowanie-swojego-wkładu)
+- [Proces rozwoju i zgłaszania](#proces-rozwoju-i-zgłaszania)
+- [Prawne](#prawne)
 
-### 1. Kodeks postępowania
-
-Wszyscy współtwórcy muszą przestrzegać naszego [Kodeksu postępowania](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Przeczytaj go przed rozpoczęciem współtworzenia.
+## Zanim zaczniesz współtworzyć
 
-### 2. Zrozumienie roadmapy projektu
+### 1. Kodeks postępowania
 
-Roo Code ma jasną roadmapę rozwoju, która wyznacza nasze priorytety i przyszły kierunek. Zrozumienie roadmapy pomoże ci:
+Wszyscy współtwórcy muszą przestrzegać naszego [Kodeksu postępowania](./CODE_OF_CONDUCT.md).
 
-- Dopasować swój wkład do celów projektu
-- Znaleźć obszary, w których twoja wiedza będzie najbardziej wartościowa
-- Zrozumieć kontekst niektórych decyzji projektowych
-- Zainspirować się do nowych funkcji wspierających naszą wizję
+### 2. Roadmapa projektu
 
-Skupiamy się na tym, aby Roo Code stało się najlepszym wyborem dla programistów pracujących z narzędziami programistycznymi opartymi na AI. Oto jak to osiągniemy:
+Nasza roadmapa wyznacza kierunek projektu. Dostosuj swój wkład do tych kluczowych celów:
 
-#### Niezawodność przede wszystkim
+### Niezawodność przede wszystkim
 
 - Zapewnienie, że edycja różnic i wykonywanie poleceń są konsekwentnie niezawodne
 - Zmniejszenie punktów tarcia, które zniechęcają do regularnego użytkowania
 - Gwarancja płynnego działania we wszystkich językach i na wszystkich platformach
 - Rozszerzenie solidnego wsparcia dla szerokiej gamy dostawców i modeli AI
 
-#### Ulepszone doświadczenie użytkownika
+### Ulepszone doświadczenie użytkownika
 
 - Uproszczenie interfejsu użytkownika dla większej przejrzystości i intuicyjności
-- Ciągłe doskonalenie przepływu pracy, aby spełnić wysokie oczekiwania, jakie programiści mają wobec codziennie używanych narzędzi
+- Ciągłe doskonalenie przepływu pracy, aby spełnić wysokie oczekiwania programistów
 
-#### Wiodąca pozycja w wydajności agentów
+### Wiodąca pozycja w wydajności agentów
 
 - Ustanowienie kompleksowych punktów odniesienia (evals) do mierzenia produktywności w rzeczywistym świecie
 - Ułatwienie wszystkim łatwego uruchamiania i interpretowania tych ocen
-- Dostarczanie ulepszeń Roo Code, które wykazują wyraźny wzrost wyników ocen
+- Dostarczanie ulepszeń, które wykazują wyraźny wzrost wyników ocen
 
-Szczególnie mile widziane są wkłady, które realizują cele roadmapy. Jeśli pracujesz nad czymś zgodnym z tymi filarami, wspomnij o tym w opisie PR.
+Wspomnij o powiązaniu z tymi obszarami w swoich PR.
 
 ### 3. Dołącz do społeczności Roo Code
 
-Nawiązanie kontaktu ze społecznością Roo Code to świetny sposób na rozpoczęcie:
-
-- **Główna metoda**:
-    1.  Dołącz do [społeczności Roo Code na Discordzie](https://discord.gg/roocode).
-    2.  Po dołączeniu wyślij wiadomość prywatną (DM) do **Hannes Rudolph** (Discord: `hrudolph`), aby omówić swoje zainteresowanie i uzyskać wskazówki.
-- **Alternatywa dla doświadczonych współtwórców**: Jeśli dobrze znasz podejście Issue-First, możesz działać bezpośrednio przez GitHub, śledząc [tablicę Kanban](https://github.com/orgs/RooVetGit/projects/1) i komunikując się przez issues i pull requesty.
-
-## II. Znajdowanie i planowanie swojego wkładu
-
-Zdecyduj, nad czym chcesz pracować i jak się za to zabierzesz.
-
-### 1. Typy wkładów
+- **Główna metoda:** Dołącz do naszego [Discorda](https://discord.gg/roocode) i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)**.
+- **Alternatywa:** Doświadczeni współtwórcy mogą angażować się bezpośrednio przez [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Witamy różne typy wkładów:
+## Znajdowanie i planowanie swojego wkładu
 
-- **Poprawki błędów**: Naprawianie problemów w istniejącym kodzie
-- **Nowe funkcje**: Dodawanie nowych funkcjonalności
-- **Dokumentacja**: Ulepszanie przewodników, dodawanie przykładów lub poprawianie literówek
+### Typy wkładów
 
-### 2. Kluczowa zasada: podejście Issue-First
+- **Poprawki błędów:** Naprawianie problemów w kodzie.
+- **Nowe funkcje:** Dodawanie nowych funkcjonalności.
+- **Dokumentacja:** Ulepszanie przewodników i zwiększanie przejrzystości.
 
-**Każdy wkład musi zaczynać się od GitHub Issue.** To kluczowe, by zapewnić zgodność i uniknąć niepotrzebnej pracy.
+### Podejście Issue-First
 
-- **Znajdź lub utwórz Issue**:
-    - Przed rozpoczęciem sprawdź w [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues), czy już istnieje issue dla twojego wkładu.
-    - Jeśli istnieje i nie jest przypisane, skomentuj, że chcesz się tym zająć. Maintainer ci je przypisze.
-    - Jeśli nie istnieje, utwórz nowe, korzystając z odpowiedniego szablonu na naszej [stronie issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Dla błędów: szablon "Bug Report"
-        - Dla nowych funkcji: szablon "Detailed Feature Proposal". Poczekaj na zatwierdzenie przez maintainerów (szczególnie @hannesrudolph) przed rozpoczęciem implementacji.
-        - **Uwaga**: Ogólne pomysły lub wstępne dyskusje o funkcjach mogą zacząć się w [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Gdy pomysł się sprecyzuje, należy utworzyć issue "Detailed Feature Proposal".
-- **Zgłaszanie i przypisywanie**:
-    - Wyraźnie zaznacz chęć pracy nad issue, komentując je.
-    - Poczekaj, aż maintainer oficjalnie ci je przypisze na GitHubie. Dzięki temu unikniemy dublowania pracy.
-- **Konsekwencje nieprzestrzegania**:
-    - Pull Requesty (PR) bez powiązanego, zatwierdzonego i przypisanego issue mogą zostać zamknięte bez pełnej recenzji. Ta polityka zapewnia zgodność wkładów z celami projektu i szanuje czas wszystkich.
+Każdy wkład musi zaczynać się od GitHub Issue.
 
-To podejście pomaga nam śledzić pracę, upewnić się, że zmiany są pożądane, i skutecznie koordynować wysiłki.
+- **Sprawdź istniejące issues:** Przeszukaj [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Utwórz issue:** Używaj odpowiednich szablonów:
+    - **Błędy:** Szablon "Bug Report".
+    - **Funkcje:** Szablon "Detailed Feature Proposal". Wymagane zatwierdzenie przed rozpoczęciem.
+- **Zgłoś chęć pracy:** Skomentuj i poczekaj na oficjalne przypisanie.
 
-### 3. Decydowanie, nad czym pracować
+**PR bez zatwierdzonego issue może zostać zamknięty.**
 
-- **Good First Issues**: Sprawdź sekcję "Issue [Unassigned]" w naszym [projekcie Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) na GitHubie.
-- **Dokumentacja**: Choć ten `CONTRIBUTING.md` to główny przewodnik dla wkładów kodowych, jeśli chcesz współtworzyć inną dokumentację (np. przewodniki użytkownika lub API), sprawdź [repozytorium Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) lub zapytaj na Discordzie.
-- **Proponowanie nowych funkcji**:
-    1.  **Wstępny pomysł/dyskusja**: Ogólne lub początkowe pomysły omawiaj w [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Formalna propozycja**: Dla konkretnych, gotowych do rozważenia propozycji utwórz issue "Detailed Feature Proposal" z szablonu na naszej [stronie issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). To kluczowy element naszego **podejścia Issue-First**.
+### Decydowanie, nad czym pracować
 
-### 4. Zgłaszanie błędów lub problemów
+- Sprawdź [Projekt GitHub](https://github.com/orgs/RooVetGit/projects/1) w poszukiwaniu nieprzypisanych "Good First Issues".
+- W kwestii dokumentacji odwiedź [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Jeśli znajdziesz błąd:
+### Zgłaszanie błędów
 
-1.  **Szukaj istniejących issues**: Sprawdź [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues), czy nie ma już zgłoszenia.
-2.  **Utwórz nowe issue**: Jeśli to unikalny problem, użyj szablonu "Bug Report" na naszej [stronie issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Najpierw sprawdź istniejące zgłoszenia.
+- Twórz nowe zgłoszenia błędów używając [szablonu "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Luki bezpieczeństwa:** Zgłaszaj prywatnie przez [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Luki bezpieczeństwa**: Jeśli odkryjesz lukę bezpieczeństwa, zgłoś ją prywatnie przez [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Nie twórz publicznego issue dla luk bezpieczeństwa.
+## Proces rozwoju i zgłaszania
 
-## III. Proces rozwoju i zgłaszania
+### Konfiguracja środowiska
 
-Postępuj według tych kroków, aby kodować i zgłaszać swój wkład.
+1. **Fork & Clone:**
 
-### 1. Konfiguracja środowiska
-
-1.  **Fork & Clone**:
-    - Zrób fork repozytorium na GitHubie.
-    - Sklonuj swojego forka lokalnie: `git clone https://github.com/TWÓJ_UŻYTKOWNIK/Roo-Code.git`
-2.  **Zainstaluj zależności**: `npm run install:all`
-3.  **Uruchom Webview (Dev Mode)**: `npm run dev` (dla aplikacji Vite/React z HMR)
-4.  **Debuguj rozszerzenie**: Wciśnij `F5` w VS Code (lub **Run** → **Start Debugging**), aby otworzyć nowe okno Extension Development Host z Roo Code.
-
-Zmiany w webview (`webview-ui`) pojawią się natychmiast dzięki Hot Module Replacement. Zmiany w głównym rozszerzeniu (`src`) wymagają ponownego uruchomienia Extension Development Host.
-
-Możesz też zbudować i zainstalować paczkę `.vsix`:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<wersja>.vsix
+```
+git clone https://github.com/TWÓJ_UŻYTKOWNIK/Roo-Code.git
 ```
 
-(Zamień `<wersja>` na faktyczny numer wersji wygenerowanego pliku).
-
-### 2. Wytyczne dotyczące pisania kodu
-
-- **Skoncentrowane PRy**: Jedna funkcja/poprawka na PR.
-- **Jakość kodu**:
-    - Przejdź przez CI (lint, formatowanie)
-    - Napraw ostrzeżenia lub błędy ESLint (`npm run lint`)
-    - Odpowiadaj na feedback z narzędzi automatycznej recenzji kodu
-    - Stosuj dobre praktyki TypeScript i dbaj o bezpieczeństwo typów
-- **Testowanie**:
-    - Dodaj testy dla nowych funkcji
-    - Uruchom `npm test`, by upewnić się, że wszystko przechodzi
-    - Zaktualizuj istniejące testy, jeśli twoje zmiany je dotyczą
-- **Wiadomości commitów**:
-    - Pisz jasne, opisowe wiadomości commitów
-    - Odnoś się do odpowiednich issues przez `#numer-issue` (np. `Fixes #123`)
-- **Checklist przed zgłoszeniem PR**:
-    - Zrebase'uj swoją gałąź na najnowszym `main` z upstream
-    - Upewnij się, że kod się buduje (`npm run build`)
-    - Wszystkie testy muszą przechodzić (`npm test`)
-    - Usuń kod debugowania lub `console.log`
-
-### 3. Zgłaszanie kodu: proces Pull Request (PR)
-
-#### Pull Requesty w wersji roboczej
-
-Używaj PRów w wersji roboczej dla pracy, która nie jest jeszcze gotowa do pełnej recenzji, ale dla której chcesz:
-
-- Uruchomić automatyczne sprawdzenia (CI)
-- Otrzymać wczesny feedback od maintainerów lub innych współtwórców
-- Zasygnalizować, że praca jest w toku
-
-Oznacz PR jako "Ready for Review" dopiero, gdy wszystkie sprawdzenia przejdą i uważasz, że spełnia kryteria "Wytycznych dotyczących pisania kodu" i "Opisu Pull Requesta".
-
-#### Opis Pull Requesta
-
-Opis PRa musi być kompletny i zgodny ze strukturą naszej [Pull Request Template](.github/pull_request_template.md). Kluczowe elementy:
-
-- Link do zatwierdzonego GitHub Issue, którego dotyczy
-- Jasny opis wprowadzonych zmian i ich celu
-- Szczegółowe kroki testowania zmian
-- Lista wszelkich breaking changes
-- **Dla zmian w UI: zrzuty ekranu lub wideo przed/po**
-- **Wskaż, czy PR wymaga aktualizacji dokumentacji użytkownika i które dokumenty/sekcje są dotknięte**
-
-#### Polityka Pull Request (PR)
-
-##### Cel
-
-Utrzymanie czystego, skoncentrowanego i zarządzalnego backlogu PRów.
+2. **Instalacja zależności:**
 
-##### Podejście Issue-First
+```
+npm run install:all
+```
 
-- **Wymagane**: Przed rozpoczęciem pracy musi istnieć zatwierdzone i przypisane GitHub Issue ("Bug Report" lub "Detailed Feature Proposal").
-- **Zatwierdzenie**: Issues, zwłaszcza dotyczące większych zmian, muszą być zatwierdzone przez maintainerów (szczególnie @hannesrudolph) _przed_ rozpoczęciem kodowania.
-- **Odniesienie**: PRy muszą wyraźnie odnosić się do tych zatwierdzonych issues w opisie.
-- **Konsekwencje**: Nieprzestrzeganie tego procesu może skutkować zamknięciem PRa bez pełnej recenzji.
+3. **Debugowanie:** Otwórz w VS Code (`F5`).
 
-##### Warunki dla otwartych PR
+### Wytyczne dotyczące pisania kodu
 
-- **Gotowe do merge**: Przechodzi wszystkie testy CI, jest zgodny z roadmapą (jeśli dotyczy), powiązany z zatwierdzonym i przypisanym Issue, ma jasną dokumentację/komentarze, zawiera zrzuty ekranu/wideo dla zmian w UI
-- **Do zamknięcia**: Błędy CI, poważne konflikty merge, brak zgodności z celami projektu lub długotrwała bezczynność (>30 dni bez aktualizacji po feedbacku)
+- Jeden skoncentrowany PR na funkcję lub poprawkę.
+- Przestrzegaj dobrych praktyk ESLint i TypeScript.
+- Pisz jasne, opisowe commity odnoszące się do issues (np. `Fixes #123`).
+- Zapewnij dokładne testy (`npm test`).
+- Zrebase'uj na najnowszą gałąź `main` przed zgłoszeniem.
 
-##### Procedura
+### Zgłaszanie Pull Requesta
 
-1.  **Kwalifikacja i przypisanie Issue**: @hannesrudolph (lub inni maintainerzy) przeglądają i przypisują nowe i istniejące issues.
-2.  **Wstępna triage PRów (codziennie)**: Maintainerzy szybko przeglądają nowe PRy pod kątem pilności lub krytycznych problemów.
-3.  **Szczegółowa recenzja PRów (tygodniowo)**: Maintainerzy dokładnie oceniają PRy pod kątem gotowości, zgodności z zatwierdzonym Issue i ogólnej jakości.
-4.  **Szczegółowy feedback i iteracja**: Na podstawie recenzji maintainerzy udzielają feedbacku (Approve, Request Changes, Reject). Oczekuje się, że współtwórcy odpowiedzą i poprawią PR.
-5.  **Etap decyzji**: Zatwierdzone PRy są mergowane. PRy z nierozwiązywalnymi problemami lub niezgodne mogą być zamknięte z wyjaśnieniem.
-6.  **Follow-up**: Autorzy zamkniętych PRów mogą poprawić je według feedbacku i otworzyć nowe, jeśli problemy zostaną rozwiązane lub zmieni się kierunek projektu.
+- Zacznij od **wersji roboczej PR**, jeśli szukasz wczesnego feedbacku.
+- Jasno opisz swoje zmiany, zgodnie z szablonem Pull Request.
+- Dostarcz zrzuty ekranu/wideo dla zmian UI.
+- Wskaż, czy potrzebne są aktualizacje dokumentacji.
 
-##### Odpowiedzialności
+### Polityka Pull Request
 
-- **Kwalifikacja Issue i przestrzeganie procesu (@hannesrudolph & maintainerzy)**: Zapewnienie, że wszystkie wkłady stosują podejście Issue-First. Wskazówki dla współtwórców.
-- **Maintainerzy (zespół deweloperski)**: Przegląd PRów, udzielanie feedbacku technicznego, podejmowanie decyzji o zatwierdzeniu/odrzuceniu, mergowanie PRów.
-- **Współtwórcy**: Powiązanie PRów z zatwierdzonym i przypisanym Issue, przestrzeganie wytycznych jakości, szybka reakcja na feedback.
+- Musi odnosić się do wcześniej zatwierdzonych i przypisanych issues.
+- PR niezgodne z polityką mogą zostać zamknięte.
+- PR powinny przechodzić testy CI, być zgodne z roadmapą i mieć jasną dokumentację.
 
-Ta polityka zapewnia przejrzystość i efektywną integrację.
+### Proces recenzji
 
-## IV. Prawne
+- **Codzienna selekcja:** Szybkie sprawdzenia przez maintainerów.
+- **Cotygodniowy dokładny przegląd:** Kompleksowa ocena.
+- **Szybko iteruj** na podstawie feedbacku.
 
-### Umowa współtwórcy
+## Prawne
 
-Zgłaszając pull request, zgadzasz się, że twój wkład będzie licencjonowany na [licencji Apache 2.0](LICENSE) (lub aktualnej licencji projektu), tak jak cały projekt.
+Zgłaszając pull request, zgadzasz się, że twój wkład będzie licencjonowany na licencji Apache 2.0, zgodnie z licencją Roo Code.

locales/pt-BR/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Contribuindo para o Roo Code
 
-O Roo Code é um projeto impulsionado pela comunidade e valorizamos muito cada contribuição. Para garantir um processo tranquilo e eficaz para todos, **operamos com uma abordagem "[Issue-First](#2-princípio-chave-abordagem-issue-first)".** Isso significa que todo o trabalho deve estar vinculado a uma Issue do GitHub _antes_ de enviar um Pull Request (veja nossa [Política de PR](#política-de-pull-request-pr) para detalhes). Leia este guia com atenção para entender como contribuir.
-Este guia explica como contribuir para o Roo Code, seja corrigindo bugs, adicionando recursos ou melhorando a documentação.
+O Roo Code é um projeto impulsionado pela comunidade e valorizamos muito cada contribuição. Para simplificar a colaboração, operamos com uma abordagem [Issue-First](#abordagem-issue-first), o que significa que todos os [Pull Requests (PRs)](#enviando-um-pull-request) devem primeiro estar vinculados a uma Issue do GitHub. Por favor, leia este guia com atenção.
 
 ## Índice
 
-- [I. Antes de Contribuir](#i-antes-de-contribuir)
-    - [1. Código de Conduta](#1-código-de-conduta)
-    - [2. Entenda o Roadmap do Projeto](#2-entenda-o-roadmap-do-projeto)
-        - [Confiabilidade em Primeiro Lugar](#confiabilidade-em-primeiro-lugar)
-        - [Experiência de Usuário Aprimorada](#experiência-de-usuário-aprimorada)
-        - [Liderança em Desempenho de Agentes](#liderança-em-desempenho-de-agentes)
-    - [3. Junte-se à Comunidade Roo Code](#3-junte-se-à-comunidade-roo-code)
-- [II. Encontrando & Planejando sua Contribuição](#ii-encontrando--planejando-sua-contribuição)
-    - [1. Tipos de Contribuição](#1-tipos-de-contribuição)
-    - [2. Princípio-chave: Abordagem Issue-First](#2-princípio-chave-abordagem-issue-first)
-    - [3. Decidindo no que Trabalhar](#3-decidindo-no-que-trabalhar)
-    - [4. Relatando Bugs ou Problemas](#4-relatando-bugs-ou-problemas)
-- [III. Processo de Desenvolvimento & Submissão](#iii-processo-de-desenvolvimento--submissão)
-    - [1. Configuração de Desenvolvimento](#1-configuração-de-desenvolvimento)
-    - [2. Diretrizes para Escrever Código](#2-diretrizes-para-escrever-código)
-    - [3. Enviando Código: Processo de Pull Request (PR)](#3-enviando-código-processo-de-pull-request-pr)
-        - [Pull Requests em Rascunho](#pull-requests-em-rascunho)
-        - [Descrição do Pull Request](#descrição-do-pull-request)
-        - [Política de Pull Request (PR)](#política-de-pull-request-pr)
-            - [Objetivo](#objetivo)
-            - [Abordagem Issue-First](#abordagem-issue-first)
-            - [Condições para PRs Abertos](#condições-para-prs-abertos)
-            - [Procedimento](#procedimento)
-            - [Responsabilidades](#responsabilidades)
-- [IV. Legal](#iv-legal)
-    - [Acordo de Contribuição](#acordo-de-contribuição)
-
-## I. Antes de Contribuir
-
-Primeiro, familiarize-se com nossos padrões de comunidade e a direção do projeto.
+- [Antes de Contribuir](#antes-de-contribuir)
+- [Encontrando & Planejando sua Contribuição](#encontrando--planejando-sua-contribuição)
+- [Processo de Desenvolvimento & Submissão](#processo-de-desenvolvimento--submissão)
+- [Legal](#legal)
 
-### 1. Código de Conduta
-
-Todos os colaboradores devem seguir nosso [Código de Conduta](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Por favor, leia antes de contribuir.
+## Antes de Contribuir
 
-### 2. Entenda o Roadmap do Projeto
+### 1. Código de Conduta
 
-O Roo Code possui um roadmap de desenvolvimento claro que orienta nossas prioridades e direção futura. Entender o roadmap pode te ajudar a:
+Todos os colaboradores devem seguir nosso [Código de Conduta](./CODE_OF_CONDUCT.md).
 
-- Alinhar suas contribuições com os objetivos do projeto
-- Identificar áreas onde sua experiência será mais valiosa
-- Compreender o contexto por trás de certas decisões de design
-- Se inspirar para novos recursos que apoiem nossa visão
+### 2. Roadmap do Projeto
 
-Estamos focados em tornar o Roo Code a principal escolha para desenvolvedores que trabalham com ferramentas de codificação baseadas em IA. Veja como faremos isso:
+Nosso roadmap orienta a direção do projeto. Alinhe suas contribuições com estes objetivos principais:
 
-#### Confiabilidade em Primeiro Lugar
+### Confiabilidade em Primeiro Lugar
 
 - Garantir que a edição de diferenças e a execução de comandos sejam consistentemente confiáveis
 - Reduzir pontos de atrito que desencorajam o uso regular
 - Garantir operação suave em todos os idiomas e plataformas
 - Expandir o suporte robusto para uma ampla variedade de provedores e modelos de IA
 
-#### Experiência de Usuário Aprimorada
+### Experiência de Usuário Aprimorada
 
 - Simplificar a interface do usuário para maior clareza e intuitividade
-- Melhorar continuamente o fluxo de trabalho para atender às altas expectativas que os desenvolvedores têm para ferramentas de uso diário
+- Melhorar continuamente o fluxo de trabalho para atender às altas expectativas dos desenvolvedores
 
-#### Liderança em Desempenho de Agentes
+### Liderança em Desempenho de Agentes
 
 - Estabelecer benchmarks de avaliação abrangentes (evals) para medir a produtividade no mundo real
 - Facilitar para que todos possam executar e interpretar essas avaliações
-- Fornecer melhorias ao Roo Code que demonstrem aumentos claros nas pontuações de avaliação
+- Fornecer melhorias que demonstrem aumentos claros nas pontuações de avaliação
 
-Contribuições que avançam os objetivos do nosso roadmap são especialmente bem-vindas. Se você estiver trabalhando em algo alinhado com esses pilares, mencione isso na descrição do seu PR.
+Mencione o alinhamento com estas áreas em seus PRs.
 
 ### 3. Junte-se à Comunidade Roo Code
 
-Conectar-se com a comunidade Roo Code é uma ótima maneira de começar:
-
-- **Método principal**:
-    1.  Junte-se à [comunidade Roo Code no Discord](https://discord.gg/roocode).
-    2.  Depois, envie uma mensagem direta (DM) para **Hannes Rudolph** (Discord: `hrudolph`) para discutir seu interesse e receber orientações.
-- **Alternativa para colaboradores experientes**: Se você está confortável com a abordagem issue-first, pode participar diretamente pelo GitHub acompanhando o [quadro Kanban](https://github.com/orgs/RooVetGit/projects/1) e se comunicando via issues e pull requests.
-
-## II. Encontrando & Planejando sua Contribuição
-
-Identifique no que gostaria de trabalhar e como abordar.
-
-### 1. Tipos de Contribuição
+- **Principal:** Junte-se ao nosso [Discord](https://discord.gg/roocode) e envie um DM para **Hannes Rudolph (`hrudolph`)**.
+- **Alternativa:** Colaboradores experientes podem participar diretamente via [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Aceitamos vários tipos de contribuição:
+## Encontrando & Planejando sua Contribuição
 
-- **Correção de bugs**: Corrigir problemas no código existente.
-- **Novos recursos**: Adicionar novas funcionalidades.
-- **Documentação**: Melhorar guias, exemplos ou corrigir erros de digitação.
+### Tipos de Contribuição
 
-### 2. Princípio-chave: Abordagem Issue-First
+- **Correção de bugs:** Corrigir problemas no código.
+- **Novos recursos:** Adicionar novas funcionalidades.
+- **Documentação:** Melhorar guias e clareza.
 
-**Todas as contribuições devem começar com uma Issue do GitHub.** Este é um passo fundamental para garantir alinhamento e evitar esforços desperdiçados.
+### Abordagem Issue-First
 
-- **Encontrar ou criar uma Issue**:
-    - Antes de começar, procure em [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) se já existe uma issue para sua contribuição.
-    - Se existir e não estiver atribuída, comente na issue para expressar seu interesse. Um mantenedor irá atribuí-la a você.
-    - Se não existir, crie uma nova usando o template apropriado em nossa [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Para bugs, use o template "Bug Report".
-        - Para novos recursos, use o template "Detailed Feature Proposal". Aguarde a aprovação de um mantenedor (especialmente @hannesrudolph) antes de começar a implementar.
-        - **Nota**: Ideias gerais ou discussões preliminares sobre recursos podem começar em [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Quando a ideia estiver mais concreta, uma issue "Detailed Feature Proposal" deve ser criada.
-- **Reivindicação e atribuição**:
-    - Indique claramente sua intenção de trabalhar em uma issue comentando nela.
-    - Aguarde um mantenedor atribuí-la oficialmente a você no GitHub. Isso evita que várias pessoas trabalhem na mesma coisa.
-- **Consequências de não seguir**:
-    - Pull Requests (PRs) enviados sem uma issue correspondente, pré-aprovada e atribuída podem ser fechados sem revisão completa. Esta política existe para garantir que as contribuições estejam alinhadas com as prioridades do projeto e para respeitar o tempo de todos.
+Todas as contribuições devem começar com uma Issue do GitHub.
 
-Essa abordagem nos ajuda a rastrear o trabalho, garantir que as mudanças sejam desejadas e coordenar esforços de forma eficaz.
+- **Verificar issues existentes:** Procure em [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Criar uma issue:** Use os templates apropriados:
+    - **Bugs:** Template "Bug Report".
+    - **Recursos:** Template "Detailed Feature Proposal". Aprovação necessária antes de começar.
+- **Reivindicar issues:** Comente e aguarde atribuição oficial.
 
-### 3. Decidindo no que Trabalhar
+**PRs sem issues aprovadas podem ser fechados.**
 
-- **Good First Issues**: Confira a seção "Issue [Unassigned]" do nosso [Projeto Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) no GitHub.
-- **Documentação**: Embora este `CONTRIBUTING.md` seja o guia principal para contribuições de código, se você quiser contribuir para outra documentação (como guias de usuário ou API), confira o [repositório Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) ou pergunte na comunidade do Discord.
-- **Propondo novos recursos**:
-    1.  **Ideia/discussão inicial**: Para ideias gerais ou iniciais, inicie uma conversa em [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Proposta formal**: Para propostas específicas e prontas para consideração, crie uma issue "Detailed Feature Proposal" usando o template em nossa [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Isso é fundamental em nossa **abordagem Issue-First**.
+### Decidindo no que Trabalhar
 
-### 4. Relatando Bugs ou Problemas
+- Confira o [Projeto GitHub](https://github.com/orgs/RooVetGit/projects/1) para "Good First Issues" não atribuídas.
+- Para documentação, visite [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Se encontrar um bug:
+### Relatando Bugs
 
-1.  **Procure issues existentes**: Verifique [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) para ver se já foi relatado.
-2.  **Crie uma nova issue**: Se for único, use o template "Bug Report" em nossa [página de issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Verifique primeiro se já existem relatórios.
+- Crie novos relatórios de bugs usando o [template "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Vulnerabilidades de segurança:** Relate de forma privada via [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Vulnerabilidades de segurança**: Se você descobrir uma vulnerabilidade de segurança, relate-a de forma privada usando a [ferramenta de avisos de segurança do GitHub](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Não crie uma issue pública para vulnerabilidades de segurança.
+## Processo de Desenvolvimento & Submissão
 
-## III. Processo de Desenvolvimento & Submissão
+### Configuração de Desenvolvimento
 
-Siga estes passos para programar e enviar seu trabalho.
+1. **Fork & Clone:**
 
-### 1. Configuração de Desenvolvimento
-
-1.  **Fork & Clone**:
-    - Faça um fork do repositório no GitHub.
-    - Clone seu fork localmente: `git clone https://github.com/SEU_USUÁRIO/Roo-Code.git`
-2.  **Instale as dependências**: `npm run install:all`
-3.  **Execute o Webview (modo dev)**: `npm run dev` (para o app Vite/React com HMR)
-4.  **Debugue a extensão**: Pressione `F5` no VS Code (ou **Run** → **Start Debugging**) para abrir uma nova janela Extension Development Host com o Roo Code carregado.
-
-As alterações no webview (`webview-ui`) aparecerão imediatamente graças ao Hot Module Replacement. Alterações na extensão principal (`src`) exigirão reiniciar o Extension Development Host.
-
-Alternativamente, para construir e instalar um pacote `.vsix`:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<versão>.vsix
+```
+git clone https://github.com/SEU_USUÁRIO/Roo-Code.git
 ```
 
-(Substitua `<versão>` pelo número real da versão do arquivo gerado).
-
-### 2. Diretrizes para Escrever Código
-
-- **PRs focados**: Um recurso/correção por PR.
-- **Qualidade do código**:
-    - Passar nos checks de CI (lint, formatação)
-    - Corrigir avisos ou erros do ESLint (`npm run lint`)
-    - Responder ao feedback de ferramentas automáticas de revisão de código
-    - Seguir boas práticas de TypeScript e manter a segurança de tipos
-- **Testes**:
-    - Adicionar testes para novos recursos
-    - Executar `npm test` para garantir que tudo passa
-    - Atualizar testes existentes se suas alterações os afetarem
-- **Mensagens de commit**:
-    - Escrever mensagens claras e descritivas
-    - Referenciar issues relevantes usando `#número-issue` (ex: `Fixes #123`)
-- **Checklist antes de enviar PR**:
-    - Rebasear sua branch no último `main` do upstream
-    - Garantir que o código compila (`npm run build`)
-    - Todos os testes devem passar (`npm test`)
-    - Remover qualquer código de depuração ou `console.log`
-
-### 3. Enviando Código: Processo de Pull Request (PR)
-
-#### Pull Requests em Rascunho
-
-Use PRs em rascunho para trabalhos que ainda não estão prontos para revisão completa, mas para os quais você deseja:
-
-- Rodar checks automáticos (CI)
-- Receber feedback antecipado de mantenedores ou outros colaboradores
-- Sinalizar que o trabalho está em andamento
-
-Marque um PR como "Pronto para Revisão" apenas quando todos os checks passarem e você acreditar que ele atende aos critérios de "Diretrizes para Escrever Código" e "Descrição do Pull Request".
-
-#### Descrição do Pull Request
-
-A descrição do seu PR deve ser completa e seguir a estrutura do nosso [Template de Pull Request](.github/pull_request_template.md). Pontos principais:
-
-- Um link para a Issue do GitHub aprovada que ele resolve
-- Descrição clara das alterações feitas e seu propósito
-- Passos detalhados para testar as alterações
-- Lista de quaisquer breaking changes
-- **Para mudanças de UI, forneça capturas de tela ou vídeos de antes e depois**
-- **Indique se seu PR exige atualização da documentação do usuário e quais documentos/seções são afetados**
-
-#### Política de Pull Request (PR)
-
-##### Objetivo
-
-Manter um backlog de PRs limpo, focado e gerenciável.
+2. **Instalar dependências:**
 
-##### Abordagem Issue-First
+```
+npm run install:all
+```
 
-- **Obrigatório**: Antes de começar, deve existir uma Issue do GitHub aprovada e atribuída (seja "Bug Report" ou "Detailed Feature Proposal").
-- **Aprovação**: Issues, especialmente para mudanças grandes, devem ser revisadas e aprovadas por mantenedores (especialmente @hannesrudolph) _antes_ de começar a programar.
-- **Referência**: PRs devem referenciar explicitamente essas issues pré-aprovadas na descrição.
-- **Consequências**: Não seguir esse processo pode resultar no fechamento do PR sem revisão completa.
+3. **Depuração:** Abra com VS Code (`F5`).
 
-##### Condições para PRs Abertos
+### Diretrizes para Escrever Código
 
-- **Pronto para merge**: Passa todos os testes de CI, está alinhado com o roadmap (se aplicável), está vinculado a uma Issue aprovada e atribuída, tem documentação/comentários claros, inclui imagens/vídeos de antes e depois para mudanças de UI
-- **Para fechar**: Falha nos testes de CI, grandes conflitos de merge, desalinhamento com os objetivos do projeto ou inatividade prolongada (>30 dias sem atualizações após feedback)
+- Um PR focado por recurso ou correção.
+- Siga as melhores práticas de ESLint e TypeScript.
+- Escreva commits claros e descritivos referenciando issues (ex: `Fixes #123`).
+- Forneça testes completos (`npm test`).
+- Rebase na branch `main` mais recente antes do envio.
 
-##### Procedimento
+### Enviando um Pull Request
 
-1.  **Qualificação & atribuição de Issues**: @hannesrudolph (ou outros mantenedores) revisam e atribuem novas e existentes Issues.
-2.  **Triagem inicial de PRs (diária)**: Mantenedores fazem uma revisão rápida dos PRs recebidos para filtrar urgências ou problemas críticos.
-3.  **Revisão detalhada de PRs (semanal)**: Mantenedores revisam a fundo os PRs para avaliar prontidão, alinhamento com a Issue aprovada e qualidade geral.
-4.  **Feedback detalhado & iteração**: Com base na revisão, mantenedores fornecem feedback (Aprovar, Solicitar Mudanças, Rejeitar). Espera-se que os colaboradores respondam e melhorem conforme necessário.
-5.  **Fase de decisão**: PRs aprovados são mesclados. PRs com problemas insolúveis ou desalinhados podem ser fechados com explicação clara.
-6.  **Follow-up**: Autores de PRs fechados podem abordar o feedback e abrir novos se os problemas forem resolvidos ou a direção do projeto mudar.
+- Comece como **PR em rascunho** se buscar feedback antecipado.
+- Descreva claramente suas alterações seguindo o Template de Pull Request.
+- Forneça capturas de tela/vídeos para alterações de UI.
+- Indique se atualizações de documentação são necessárias.
 
-##### Responsabilidades
+### Política de Pull Request
 
-- **Qualificação de Issues & cumprimento do processo (@hannesrudolph & mantenedores)**: Garantir que todas as contribuições sigam a abordagem Issue-First. Orientar colaboradores no processo.
-- **Mantenedores (Dev Team)**: Revisar PRs, fornecer feedback técnico, tomar decisões de aprovação/rejeição, mesclar PRs.
-- **Colaboradores**: Garantir que os PRs estejam vinculados a uma Issue aprovada e atribuída, sigam as diretrizes de qualidade e respondam rapidamente ao feedback.
+- Deve referenciar issues pré-aprovadas e atribuídas.
+- PRs que não seguem a política podem ser fechados.
+- PRs devem passar nos testes de CI, alinhar-se ao roadmap e ter documentação clara.
 
-Esta política garante clareza e integração eficiente.
+### Processo de Revisão
 
-## IV. Legal
+- **Triagem diária:** Verificações rápidas pelos mantenedores.
+- **Revisão semanal detalhada:** Avaliação abrangente.
+- **Itere rapidamente** com base no feedback.
 
-### Acordo de Contribuição
+## Legal
 
-Ao enviar um pull request, você concorda que suas contribuições serão licenciadas sob a [Licença Apache 2.0](LICENSE) (ou a licença atual do projeto), assim como o projeto.
+Ao enviar um pull request, você concorda que suas contribuições serão licenciadas sob a Licença Apache 2.0, consistente com o licenciamento do Roo Code.

locales/ru/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Вклад в Roo Code
 
-Roo Code — это проект, управляемый сообществом, и мы очень ценим каждый вклад. Чтобы процесс был максимально простым и эффективным для всех, **мы работаем по принципу "[Issue-First](#2-ключевой-принцип-подход-issue-first)".** Это значит, что вся работа должна быть связана с GitHub Issue _до_ отправки Pull Request (подробности см. в нашей [PR-политике](#политика-pull-request-pr)). Пожалуйста, внимательно прочитай это руководство, чтобы понять, как внести свой вклад.
-Это руководство объясняет, как внести вклад в Roo Code — будь то исправление ошибок, добавление новых функций или улучшение документации.
+Roo Code — проект, управляемый сообществом, и мы высоко ценим каждый вклад. Для упрощения сотрудничества мы работаем по принципу [Issue-First](#подход-issue-first), что означает, что все [Pull Request (PR)](#отправка-pull-request) должны сначала быть связаны с GitHub Issue. Пожалуйста, внимательно ознакомься с этим руководством.
 
 ## Содержание
 
-- [I. Перед тем как внести вклад](#i-перед-тем-как-внести-вклад)
-    - [1. Кодекс поведения](#1-кодекс-поведения)
-    - [2. Понимание дорожной карты проекта](#2-понимание-дорожной-карты-проекта)
-        - [Надежность в первую очередь](#надежность-в-первую-очередь)
-        - [Улучшенный пользовательский опыт](#улучшенный-пользовательский-опыт)
-        - [Лидерство в производительности агентов](#лидерство-в-производительности-агентов)
-    - [3. Присоединяйся к сообществу Roo Code](#3-присоединяйся-к-сообществу-roo-code)
-- [II. Поиск и планирование вклада](#ii-поиск-и-планирование-вклада)
-    - [1. Виды вклада](#1-виды-вклада)
-    - [2. Ключевой принцип: подход Issue-First](#2-ключевой-принцип-подход-issue-first)
-    - [3. Решение, над чем работать](#3-решение-над-чем-работать)
-    - [4. Сообщение об ошибках или проблемах](#4-сообщение-об-ошибках-или-проблемах)
-- [III. Процесс разработки и отправки](#iii-процесс-разработки-и-отправки)
-    - [1. Настройка среды разработки](#1-настройка-среды-разработки)
-    - [2. Руководство по написанию кода](#2-руководство-по-написанию-кода)
-    - [3. Отправка кода: процесс Pull Request (PR)](#3-отправка-кода-процесс-pull-request-pr)
-        - [Черновики Pull Request](#черновики-pull-request)
-        - [Описание Pull Request](#описание-pull-request)
-        - [Политика Pull Request (PR)](#политика-pull-request-pr)
-            - [Цель](#цель)
-            - [Подход Issue-First](#подход-issue-first)
-            - [Условия для открытых PR](#условия-для-открытых-pr)
-            - [Процедура](#процедура)
-            - [Ответственности](#ответственности)
-- [IV. Юридическая информация](#iv-юридическая-информация)
-    - [Соглашение о вкладе](#соглашение-о-вкладе)
-
-## I. Перед тем как внести вклад
-
-Сначала ознакомься с нашими стандартами сообщества и направлением проекта.
+- [Перед тем как внести вклад](#перед-тем-как-внести-вклад)
+- [Поиск и планирование вклада](#поиск-и-планирование-вклада)
+- [Процесс разработки и отправки](#процесс-разработки-и-отправки)
+- [Юридическая информация](#юридическая-информация)
 
-### 1. Кодекс поведения
-
-Все участники должны соблюдать наш [Кодекс поведения](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md). Пожалуйста, прочитай его перед тем, как вносить вклад.
+## Перед тем как внести вклад
 
-### 2. Понимание дорожной карты проекта
+### 1. Кодекс поведения
 
-У Roo Code есть четкая дорожная карта развития, определяющая наши приоритеты и будущее направление. Понимание дорожной карты поможет тебе:
+Все участники должны соблюдать наш [Кодекс поведения](./CODE_OF_CONDUCT.md).
 
-- Согласовать свой вклад с целями проекта
-- Найти области, где твой опыт будет наиболее ценен
-- Понять контекст некоторых проектных решений
-- Вдохновиться на новые функции, поддерживающие наше видение
+### 2. Дорожная карта проекта
 
-Мы стремимся сделать Roo Code лучшим выбором для разработчиков, создающих приложения с инструментами программирования на основе ИИ. Вот как мы это реализуем:
+Наша дорожная карта определяет направление проекта. Согласуй свой вклад с этими ключевыми целями:
 
-#### Надежность в первую очередь
+### Надежность в первую очередь
 
-- Обеспечение стабильной и надежной работы редактирования различий и выполнения команд
-- Сокращение точек трения, которые препятствуют регулярному использованию
+- Обеспечение стабильной работы редактирования различий и выполнения команд
+- Сокращение точек трения, препятствующих регулярному использованию
 - Гарантия бесперебойной работы на всех языках и платформах
 - Расширение надежной поддержки для широкого спектра ИИ-провайдеров и моделей
 
-#### Улучшенный пользовательский опыт
+### Улучшенный пользовательский опыт
 
 - Упрощение пользовательского интерфейса для большей ясности и интуитивности
-- Постоянное совершенствование рабочего процесса для соответствия высоким ожиданиям, которые разработчики предъявляют к инструментам ежедневного использования
+- Постоянное совершенствование рабочего процесса для соответствия высоким ожиданиям разработчиков
 
-#### Лидерство в производительности агентов
+### Лидерство в производительности агентов
 
 - Создание комплексных показателей оценки (evals) для измерения реальной продуктивности
 - Упрощение запуска и интерпретации этих оценок для всех пользователей
-- Внедрение улучшений в Roo Code, демонстрирующих явное повышение оценочных показателей
+- Внедрение улучшений, демонстрирующих явное повышение оценочных показателей
 
-Особенно приветствуются вклады, которые способствуют достижению целей дорожной карты. Если ты работаешь над чем-то, что связано с этими направлениями, укажи это в описании PR.
+Упоминай связь с этими направлениями в своих PR.
 
 ### 3. Присоединяйся к сообществу Roo Code
 
-Вступление в сообщество Roo Code — отличный способ начать:
-
-- **Основной способ**:
-    1.  Присоединяйся к [сообществу Roo Code в Discord](https://discord.gg/roocode).
-    2.  После присоединения отправь личное сообщение (DM) **Hannes Rudolph** (Discord: `hrudolph`), чтобы обсудить свой интерес и получить советы.
-- **Альтернатива для опытных участников**: Если тебе удобно работать по принципу Issue-First, можешь участвовать напрямую через GitHub, следя за [Kanban-доской](https://github.com/orgs/RooVetGit/projects/1) и общаясь через issues и pull requests.
-
-## II. Поиск и планирование вклада
-
-Определи, над чем хочешь работать и как это сделать.
-
-### 1. Виды вклада
+- **Основной способ:** Присоединись к нашему [Discord](https://discord.gg/roocode) и отправь личное сообщение **Hannes Rudolph (`hrudolph`)**.
+- **Альтернатива:** Опытные участники могут взаимодействовать напрямую через [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Мы приветствуем разные виды вклада:
+## Поиск и планирование вклада
 
-- **Исправление ошибок**: Исправление проблем в существующем коде
-- **Новые функции**: Добавление новых возможностей
-- **Документация**: Улучшение руководств, добавление примеров или исправление опечаток
+### Виды вклада
 
-### 2. Ключевой принцип: подход Issue-First
+- **Исправление ошибок:** Решение проблем в коде.
+- **Новые функции:** Добавление функциональности.
+- **Документация:** Улучшение руководств и ясности.
 
-**Весь вклад должен начинаться с GitHub Issue.** Это важно для согласования и предотвращения лишней работы.
+### Подход Issue-First
 
-- **Найти или создать Issue**:
-    - Перед началом работы проверь [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues), есть ли уже issue для твоего вклада.
-    - Если есть и не назначено, оставь комментарий, что хочешь заняться этим. Мейнтейнер назначит его тебе.
-    - Если нет, создай новое, используя подходящий шаблон на нашей [странице issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Для багов — шаблон "Bug Report"
-        - Для новых функций — шаблон "Detailed Feature Proposal". Дождись одобрения мейнтейнера (особенно @hannesrudolph) перед началом реализации.
-        - **Примечание**: Общие идеи или предварительные обсуждения функций можно начать в [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Когда идея станет конкретной, создай issue "Detailed Feature Proposal".
-- **Заявка и назначение**:
-    - Ясно укажи, что хочешь работать над issue, комментируя его.
-    - Дождись, пока мейнтейнер официально назначит его тебе в GitHub. Так мы избегаем дублирования работы.
-- **Последствия несоблюдения**:
-    - Pull Requests (PR), отправленные без соответствующего, одобренного и назначенного issue, могут быть закрыты без полного рассмотрения. Эта политика нужна для согласования вклада с приоритетами проекта и уважения времени всех участников.
+Весь вклад должен начинаться с GitHub Issue.
 
-Этот подход помогает отслеживать работу, гарантировать нужность изменений и эффективно координировать усилия.
+- **Проверь существующие issues:** Поищи в [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Создай issue:** Используй подходящие шаблоны:
+    - **Баги:** Шаблон "Bug Report".
+    - **Функции:** Шаблон "Detailed Feature Proposal". Требуется одобрение перед началом.
+- **Заяви issue:** Оставь комментарий и дождись официального назначения.
 
-### 3. Решение, над чем работать
+**PR без одобренных issue могут быть закрыты.**
 
-- **Good First Issues**: Ознакомься с разделом "Issue [Unassigned]" в нашем [проекте Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) на GitHub.
-- **Документация**: Хотя этот `CONTRIBUTING.md` — основной гид по вкладу в код, если хочешь внести вклад в другую документацию (например, руководства пользователя или API), смотри [репозиторий Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) или спроси в сообществе Discord.
-- **Предложение новых функций**:
-    1.  **Идея/обсуждение**: Для общих или начальных идей начни обсуждение в [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Формальное предложение**: Для конкретных, готовых к рассмотрению предложений создай issue "Detailed Feature Proposal" с шаблона на нашей [странице issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Это ключевая часть нашего **подхода Issue-First**.
+### Решение, над чем работать
 
-### 4. Сообщение об ошибках или проблемах
+- Проверь [GitHub проект](https://github.com/orgs/RooVetGit/projects/1) на наличие незанятых "Good First Issues".
+- Для документации посети [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Если нашел ошибку:
+### Сообщение об ошибках
 
-1.  **Проверь существующие issues**: Посмотри [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues), нет ли уже такого сообщения.
-2.  **Создай новое issue**: Если уникально, используй шаблон "Bug Report" на нашей [странице issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Сначала проверь существующие сообщения.
+- Создай новые сообщения об ошибках, используя [шаблон "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Уязвимости безопасности:** Сообщай приватно через [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Уязвимости безопасности**: Если обнаружил уязвимость, сообщи о ней приватно через [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Не создавай публичное issue для уязвимостей.
+## Процесс разработки и отправки
 
-## III. Процесс разработки и отправки
+### Настройка среды разработки
 
-Следуй этим шагам для написания и отправки кода.
+1. **Fork & Clone:**
 
-### 1. Настройка среды разработки
-
-1.  **Fork & Clone**:
-    - Сделай форк репозитория на GitHub.
-    - Клонируй свой форк локально: `git clone https://github.com/ТВОЙ_ПОЛЬЗОВАТЕЛЬ/Roo-Code.git`
-2.  **Установи зависимости**: `npm run install:all`
-3.  **Запусти Webview (Dev Mode)**: `npm run dev` (для приложения Vite/React с HMR)
-4.  **Отладка расширения**: Нажми `F5` в VS Code (или **Run** → **Start Debugging**), чтобы открыть новое окно Extension Development Host с Roo Code.
-
-Изменения в webview (`webview-ui`) появятся сразу благодаря Hot Module Replacement. Изменения в основной части расширения (`src`) требуют перезапуска Extension Development Host.
-
-Также можно собрать и установить пакет `.vsix`:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<версия>.vsix
+```
+git clone https://github.com/ТВОЙ_ПОЛЬЗОВАТЕЛЬ/Roo-Code.git
 ```
 
-(Замени `<версия>` на фактический номер версии сгенерированного файла).
-
-### 2. Руководство по написанию кода
-
-- **Фокусированные PR**: Одна функция/исправление на PR.
-- **Качество кода**:
-    - Пройти проверки CI (линтинг, форматирование)
-    - Исправить предупреждения или ошибки ESLint (`npm run lint`)
-    - Реагировать на обратную связь от автоматических инструментов code review
-    - Следовать лучшим практикам TypeScript и поддерживать типобезопасность
-- **Тестирование**:
-    - Добавить тесты для новых функций
-    - Запустить `npm test`, чтобы убедиться, что все тесты проходят
-    - Обновить существующие тесты, если твои изменения их затрагивают
-- **Сообщения коммитов**:
-    - Писать четкие, описательные сообщения коммитов
-    - Ссылаться на соответствующие issues через `#номер-issue` (например, `Fixes #123`)
-- **Чеклист перед отправкой PR**:
-    - Перебазировать свою ветку на последний `main` из upstream
-    - Убедиться, что код собирается (`npm run build`)
-    - Все тесты должны проходить (`npm test`)
-    - Удалить любой отладочный код или `console.log`
-
-### 3. Отправка кода: процесс Pull Request (PR)
-
-#### Черновики Pull Request
-
-Используй черновики PR для работы, которая еще не готова к полной проверке, но для которой ты хочешь:
-
-- Запустить автоматические проверки (CI)
-- Получить ранний фидбек от мейнтейнеров или других участников
-- Показать, что работа в процессе
-
-Отметь PR как "Ready for Review" только когда все проверки пройдены и ты считаешь, что он соответствует критериям "Руководства по написанию кода" и "Описание Pull Request".
-
-#### Описание Pull Request
-
-Описание PR должно быть полным и следовать структуре нашего [шаблона Pull Request](.github/pull_request_template.md). Основные моменты:
-
-- Ссылка на одобренный GitHub Issue, который решается
-- Четкое описание внесенных изменений и их цели
-- Подробные шаги для тестирования изменений
-- Список любых breaking changes
-- **Для изменений в UI: скриншоты или видео до/после**
-- **Укажи, требует ли твой PR обновления пользовательской документации и какие документы/разделы затрагиваются**
-
-#### Политика Pull Request (PR)
-
-##### Цель
-
-Поддерживать чистый, сфокусированный и управляемый бэклог PR.
+2. **Установка зависимостей:**
 
-##### Подход Issue-First
+```
+npm run install:all
+```
 
-- **Обязательно**: Перед началом работы должно быть существующее, одобренное и назначенное GitHub Issue ("Bug Report" или "Detailed Feature Proposal").
-- **Одобрение**: Issues, особенно для крупных изменений, должны быть одобрены мейнтейнерами (особенно @hannesrudolph) _до_ начала кодирования.
-- **Ссылка**: PR должны явно ссылаться на эти предварительно одобренные issues в описании.
-- **Последствия**: Несоблюдение этого процесса может привести к закрытию PR без полной проверки.
+3. **Отладка:** Открой в VS Code (`F5`).
 
-##### Условия для открытых PR
+### Руководство по написанию кода
 
-- **Готов к слиянию**: Проходит все проверки CI, соответствует дорожной карте (если применимо), связан с одобренным и назначенным Issue, имеет четкую документацию/комментарии, включает скриншоты/видео до/после для изменений в UI
-- **Для закрытия**: Ошибки CI, серьезные конфликты слияния, несоответствие целям проекта или длительная неактивность (>30 дней без обновлений после фидбека)
+- Один сфокусированный PR на функцию или исправление.
+- Следуй лучшим практикам ESLint и TypeScript.
+- Пиши ясные, описательные сообщения коммитов с ссылками на issues (например, `Fixes #123`).
+- Обеспечь тщательное тестирование (`npm test`).
+- Перебазируй на последнюю ветку `main` перед отправкой.
 
-##### Процедура
+### Отправка Pull Request
 
-1.  **Квалификация и назначение Issue**: @hannesrudolph (или другие мейнтейнеры) проверяют и назначают новые и существующие issues.
-2.  **Первичная triage PR (ежедневно)**: Мейнтейнеры быстро проверяют новые PR на срочность или критические вопросы.
-3.  **Детальная проверка PR (еженедельно)**: Мейнтейнеры тщательно проверяют PR на готовность, соответствие одобренному Issue и общее качество.
-4.  **Детальный фидбек и итерация**: По результатам проверки мейнтейнеры дают фидбек (Approve, Request Changes, Reject). Ожидается, что участники ответят и доработают PR.
-5.  **Этап принятия решения**: Одобренные PR сливаются. PR с нерешаемыми проблемами или несоответствием могут быть закрыты с объяснением.
-6.  **Follow-up**: Авторы закрытых PR могут доработать их по фидбеку и открыть новые, если проблемы решены или направление проекта изменилось.
+- Начни с **черновика PR**, если ищешь ранний фидбек.
+- Четко опиши свои изменения, следуя шаблону Pull Request.
+- Предоставь скриншоты/видео для изменений UI.
+- Укажи, нужны ли обновления документации.
 
-##### Ответственности
+### Политика Pull Request
 
-- **Квалификация Issue и соблюдение процесса (@hannesrudolph & мейнтейнеры)**: Следить, чтобы все вклады следовали подходу Issue-First. Помогать участникам с процессом.
-- **Мейнтейнеры (Dev Team)**: Проверять PR, давать технический фидбек, принимать решения об одобрении/отклонении, сливать PR.
-- **Участники**: Связывать PR с одобренным и назначенным Issue, соблюдать стандарты качества, быстро реагировать на фидбек.
+- Должен ссылаться на предварительно одобренные и назначенные issue.
+- PR, не соответствующие политике, могут быть закрыты.
+- PR должны проходить CI-тесты, соответствовать дорожной карте и иметь четкую документацию.
 
-Эта политика обеспечивает ясность и эффективную интеграцию.
+### Процесс проверки
 
-## IV. Юридическая информация
+- **Ежедневный отбор:** Быстрые проверки мейнтейнерами.
+- **Еженедельный глубокий обзор:** Комплексная оценка.
+- **Быстро итерируй** на основе полученного фидбека.
 
-### Соглашение о вкладе
+## Юридическая информация
 
-Отправляя pull request, ты соглашаешься, что твой вклад будет лицензирован по [лицензии Apache 2.0](LICENSE) (или текущей лицензии проекта), как и сам проект.
+Отправляя pull request, ты соглашаешься, что твой вклад будет лицензирован под лицензией Apache 2.0, в соответствии с лицензией Roo Code.

locales/tr/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Roo Code'a Katkıda Bulunma
 
-Roo Code, topluluk odaklı bir projedir ve her katkıyı çok önemsiyoruz. Herkes için sorunsuz ve etkili bir süreç sağlamak için **"[Issue-First](#2-temel-ilke-issue-first-yaklaşımı)" yaklaşımıyla çalışıyoruz.** Yani, tüm çalışmalar bir Pull Request gönderilmeden _önce_ bir GitHub Issue'ya bağlı olmalı (ayrıntılar için [PR Politikamıza](#pull-request-pr-politikası) bakabilirsin). Nasıl katkı sağlayacağını anlamak için lütfen bu rehberi dikkatlice oku.
-Bu rehber, Roo Code'a nasıl katkı sağlayabileceğini; ister hata düzelt, ister yeni özellik ekle, ister dokümantasyonu geliştir, adım adım açıklar.
+Roo Code, topluluk odaklı bir projedir ve her katkıyı çok önemsiyoruz. İşbirliğini kolaylaştırmak için [Issue-First](#issue-first-yaklaşımı) yaklaşımıyla çalışıyoruz; bu, tüm [Pull Request'lerin (PR'lar)](#pull-request-gönderme) önce bir GitHub Issue'ya bağlanması gerektiği anlamına gelir. Lütfen bu rehberi dikkatlice incele.
 
 ## İçindekiler
 
-- [I. Katkıdan Önce](#i-katkıdan-önce)
-    - [1. Davranış Kuralları](#1-davranış-kuralları)
-    - [2. Proje Yol Haritasını Anlamak](#2-proje-yol-haritasını-anlamak)
-        - [Güvenilirlik Öncelikli](#güvenilirlik-öncelikli)
-        - [Geliştirilmiş Kullanıcı Deneyimi](#geliştirilmiş-kullanıcı-deneyimi)
-        - [Ajan Performansında Liderlik](#ajan-performansında-liderlik)
-    - [3. Roo Code Topluluğuna Katıl](#3-roo-code-topluluğuna-katıl)
-- [II. Katkı Bulma & Planlama](#ii-katkı-bulma--planlama)
-    - [1. Katkı Türleri](#1-katkı-türleri)
-    - [2. Temel İlke: Issue-First Yaklaşımı](#2-temel-ilke-issue-first-yaklaşımı)
-    - [3. Ne Üzerinde Çalışacağına Karar Verme](#3-ne-üzerinde-çalışacağına-karar-verme)
-    - [4. Hata veya Sorun Bildirme](#4-hata-veya-sorun-bildirme)
-- [III. Geliştirme & Gönderim Süreci](#iii-geliştirme--gönderim-süreci)
-    - [1. Geliştirme Ortamı Kurulumu](#1-geliştirme-ortamı-kurulumu)
-    - [2. Kod Yazma Rehberi](#2-kod-yazma-rehberi)
-    - [3. Kod Gönderme: Pull Request (PR) Süreci](#3-kod-gönderme-pull-request-pr-süreci)
-        - [Taslak Pull Request'ler](#taslak-pull-requestler)
-        - [Pull Request Açıklaması](#pull-request-açıklaması)
-        - [Pull Request (PR) Politikası](#pull-request-pr-politikası)
-            - [Amaç](#amaç)
-            - [Issue-First Yaklaşımı](#issue-first-yaklaşımı)
-            - [Açık PR'lar için Koşullar](#açık-prlar-için-koşullar)
-            - [Prosedür](#prosedür)
-            - [Sorumluluklar](#sorumluluklar)
-- [IV. Yasal](#iv-yasal)
-    - [Katkı Anlaşması](#katkı-anlaşması)
-
-## I. Katkıdan Önce
-
-Öncelikle topluluk standartlarımızı ve projenin yönünü öğren.
+- [Katkıdan Önce](#katkıdan-önce)
+- [Katkı Bulma & Planlama](#katkı-bulma--planlama)
+- [Geliştirme & Gönderim Süreci](#geliştirme--gönderim-süreci)
+- [Yasal](#yasal)
 
-### 1. Davranış Kuralları
-
-Tüm katkı sağlayanlar [Davranış Kuralları](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md)'na uymalıdır. Katkıdan önce mutlaka oku.
+## Katkıdan Önce
 
-### 2. Proje Yol Haritasını Anlamak
+### 1. Davranış Kuralları
 
-Roo Code'un önceliklerimizi ve gelecekteki yönümüzü belirleyen net bir geliştirme yol haritası var. Yol haritasını anlamak sana şunları sağlar:
+Tüm katkı sağlayanlar [Davranış Kuralları](./CODE_OF_CONDUCT.md)'na uymalıdır.
 
-- Katkılarını proje hedefleriyle uyumlu hale getirmek
-- Uzmanlığının en değerli olacağı alanları bulmak
-- Bazı tasarım kararlarının arka planını anlamak
-- Vizyonumuzu destekleyen yeni özellikler için ilham almak
+### 2. Proje Yol Haritası
 
-Roo Code'u, yapay zeka destekli kodlama araçlarıyla çalışan geliştiriciler için en iyi seçenek haline getirmeye odaklanıyoruz. İşte bunu nasıl başaracağız:
+Yol haritamız projenin yönünü belirler. Katkılarını bu temel hedeflerle uyumlu hale getir:
 
-#### Güvenilirlik Öncelikli
+### Güvenilirlik Öncelikli
 
 - Diff düzenleme ve komut yürütme işlemlerinin sürekli olarak güvenilir olmasını sağlamak
 - Düzenli kullanımı engelleyen sürtünme noktalarını azaltmak
 - Tüm dillerde ve platformlarda sorunsuz çalışmayı garanti etmek
 - Çok çeşitli yapay zeka sağlayıcıları ve modelleri için güçlü desteği genişletmek
 
-#### Geliştirilmiş Kullanıcı Deneyimi
+### Geliştirilmiş Kullanıcı Deneyimi
 
 - Daha fazla netlik ve sezgisellik için kullanıcı arayüzünü basitleştirmek
-- Geliştiricilerin günlük kullanım araçları için beklediği yüksek standartları karşılamak üzere iş akışını sürekli iyileştirmek
+- Geliştiricilerin yüksek beklentilerini karşılamak üzere iş akışını sürekli iyileştirmek
 
-#### Ajan Performansında Liderlik
+### Ajan Performansında Liderlik
 
 - Gerçek dünyadaki üretkenliği ölçmek için kapsamlı değerlendirme kriterleri (evals) oluşturmak
 - Herkesin bu değerlendirmeleri kolayca çalıştırıp yorumlamasını sağlamak
-- Değerlendirme puanlarında net artışlar gösteren Roo Code iyileştirmeleri sunmak
+- Değerlendirme puanlarında net artışlar gösteren iyileştirmeler sunmak
 
-Yol haritası hedeflerimizi ilerleten katkılar özellikle memnuniyetle karşılanır. Bu sütunlarla uyumlu bir şey üzerinde çalışıyorsan, lütfen PR açıklamanda belirt.
+PR'larında bu alanlarla olan bağlantıyı belirt.
 
 ### 3. Roo Code Topluluğuna Katıl
 
-Roo Code topluluğuyla bağlantı kurmak başlamak için harika bir yoldur:
-
-- **Ana yöntem**:
-    1.  [Roo Code Discord topluluğuna](https://discord.gg/roocode) katıl.
-    2.  Katıldıktan sonra **Hannes Rudolph**'a (Discord: `hrudolph`) DM gönder, ilgini belirt ve rehberlik al.
-- **Deneyimli katkı sağlayanlar için alternatif**: Issue-First yaklaşımına alışkınsan, doğrudan GitHub üzerinden [Kanban panosunu](https://github.com/orgs/RooVetGit/projects/1) takip ederek ve issue ile pull request'lerle iletişim kurarak katılabilirsin.
-
-## II. Katkı Bulma & Planlama
-
-Ne üzerinde çalışmak istediğini ve nasıl yaklaşacağını belirle.
-
-### 1. Katkı Türleri
+- **Ana yöntem:** [Discord](https://discord.gg/roocode)'umuza katıl ve **Hannes Rudolph (`hrudolph`)**'a DM gönder.
+- **Alternatif:** Deneyimli katkı sağlayanlar [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1) üzerinden doğrudan katılabilir.
 
-Çeşitli katkı türlerini memnuniyetle karşılıyoruz:
+## Katkı Bulma & Planlama
 
-- **Hata düzeltmeleri**: Mevcut kodda sorunları çözmek
-- **Yeni özellikler**: Yeni işlevsellik eklemek
-- **Dokümantasyon**: Rehberleri geliştirmek, örnekler eklemek veya yazım hatalarını düzeltmek
+### Katkı Türleri
 
-### 2. Temel İlke: Issue-First Yaklaşımı
+- **Hata düzeltmeleri:** Koddaki sorunları çözmek.
+- **Yeni özellikler:** Yeni işlevsellik eklemek.
+- **Dokümantasyon:** Rehberleri geliştirmek ve netleştirmek.
 
-**Tüm katkılar bir GitHub Issue ile başlamalıdır.** Bu, uyumu sağlamak ve boşa emek harcamamak için kritik bir adımdır.
+### Issue-First Yaklaşımı
 
-- **Issue bul veya oluştur**:
-    - Başlamadan önce, [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)'da katkı yapmak istediğin konu için bir issue olup olmadığını kontrol et.
-    - Varsa ve atanmamışsa, almak istediğini belirten bir yorum bırak. Bir maintainer sana atayacaktır.
-    - Yoksa, [issue sayfamızda](https://github.com/RooVetGit/Roo-Code/issues/new/choose) uygun şablonu kullanarak yeni bir tane oluştur:
-        - Hatalar için "Bug Report" şablonu
-        - Yeni özellikler için "Detailed Feature Proposal" şablonu. Uygulamaya başlamadan önce bir maintainer'ın (özellikle @hannesrudolph) onayını bekle.
-        - **Not**: Özellikler için genel fikirler veya ilk tartışmalar [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests)'da başlatılabilir. Fikir netleşince "Detailed Feature Proposal" issue'su oluşturulmalı.
-- **Sahiplenme ve atama**:
-    - Bir issue üzerinde çalışmak istediğini açıkça belirten bir yorum bırak.
-    - Bir maintainer'ın GitHub'da resmi olarak atamasını bekle. Böylece aynı konuda birden fazla kişi çalışmaz.
-- **Uymamanın sonuçları**:
-    - İlgili, önceden onaylanmış ve atanmış bir issue olmadan gönderilen Pull Request'ler (PR'ler) tam inceleme yapılmadan kapatılabilir. Bu politika, katkıların proje öncelikleriyle uyumlu olmasını ve herkesin zamanına saygı gösterilmesini sağlamak içindir.
+Tüm katkılar bir GitHub Issue ile başlamalıdır.
 
-Bu yaklaşım, çalışmaları takip etmemize, değişikliklerin istenip istenmediğini garanti etmemize ve çabaları etkili şekilde koordine etmemize yardımcı olur.
+- **Mevcut issue'ları kontrol et:** [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)'da ara.
+- **Issue oluştur:** Uygun şablonları kullan:
+    - **Hatalar:** "Bug Report" şablonu.
+    - **Özellikler:** "Detailed Feature Proposal" şablonu. Başlamadan önce onay gerekir.
+- **Issue'ları sahiplen:** Yorum yap ve resmi atamayı bekle.
 
-### 3. Ne Üzerinde Çalışacağına Karar Verme
+**Onaylanmış issue'lara bağlı olmayan PR'lar kapatılabilir.**
 
-- **Good First Issues**: GitHub'daki [Roo Code Issues Projesi](https://github.com/orgs/RooVetGit/projects/1)'nin "Issue [Unassigned]" bölümüne bak.
-- **Dokümantasyon**: Bu `CONTRIBUTING.md` kod katkısı için ana rehberdir, ancak başka dokümantasyonlara (kullanıcı rehberleri veya API dokümanları gibi) katkı sağlamak istiyorsan [Roo Code Docs deposuna](https://github.com/RooVetGit/Roo-Code-Docs) bak veya Discord topluluğunda sor.
-- **Yeni özellikler önermek**:
-    1.  **İlk fikir/tartışma**: Genel veya ilk özellik fikirleri için [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests)'da tartışma başlat.
-    2.  **Resmi öneri**: Spesifik, uygulanabilir öneriler için [issue sayfamızda](https://github.com/RooVetGit/Roo-Code/issues/new/choose) "Detailed Feature Proposal" şablonunu kullanarak issue oluştur. Bu, **Issue-First Yaklaşımı**'nın anahtarıdır.
+### Ne Üzerinde Çalışacağına Karar Verme
 
-### 4. Hata veya Sorun Bildirme
+- [GitHub Projesi](https://github.com/orgs/RooVetGit/projects/1)'nde atanmamış "Good First Issues" bak.
+- Dokümantasyon için [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs)'u ziyaret et.
 
-Bir hata bulursan:
+### Hata veya Sorun Bildirme
 
-1.  **Mevcut issue'ları ara**: [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)'da daha önce bildirilip bildirilmediğine bak.
-2.  **Yeni bir issue oluştur**: Eğer benzersizse, [issue sayfamızda](https://github.com/RooVetGit/Roo-Code/issues/new/choose) "Bug Report" şablonunu kullan.
+- Önce mevcut raporları kontrol et.
+- ["Bug Report" şablonu](https://github.com/RooVetGit/Roo-Code/issues/new/choose) kullanarak yeni hata raporları oluştur.
+- **Güvenlik açıkları:** [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new) aracılığıyla özel olarak bildir.
 
-> 🔐 **Güvenlik açıkları**: Bir güvenlik açığı bulursan, [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new) ile özel olarak bildir. Güvenlik açıkları için herkese açık issue oluşturma.
+## Geliştirme & Gönderim Süreci
 
-## III. Geliştirme & Gönderim Süreci
+### Geliştirme Ortamı Kurulumu
 
-Kod yazarken ve gönderirken bu adımları takip et.
+1. **Fork & Clone:**
 
-### 1. Geliştirme Ortamı Kurulumu
-
-1.  **Fork & Clone**:
-    - GitHub'da depoyu forkla.
-    - Forkunu yerel olarak klonla: `git clone https://github.com/KULLANICI_ADIN/Roo-Code.git`
-2.  **Bağımlılıkları yükle**: `npm run install:all`
-3.  **Webview (Geliştirici Modu) çalıştır**: `npm run dev` (Vite/React uygulaması için HMR ile)
-4.  **Eklentiyi debug et**: VS Code'da `F5` tuşuna bas (veya **Run** → **Start Debugging**) ve Roo Code yüklü yeni bir Extension Development Host penceresi aç.
-
-Webview (`webview-ui`) değişiklikleri Hot Module Replacement sayesinde anında görünür. Ana eklenti (`src`) değişiklikleri için Extension Development Host'u yeniden başlatmak gerekir.
-
-Alternatif olarak, `.vsix` paketi oluşturup yüklemek için:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<versiyon>.vsix
+```
+git clone https://github.com/KULLANICI_ADIN/Roo-Code.git
 ```
 
-(`<versiyon>` kısmını oluşturulan dosyanın gerçek sürüm numarasıyla değiştir.)
-
-### 2. Kod Yazma Rehberi
-
-- **Odaklı PR'lar**: Her PR için bir özellik/düzeltme.
-- **Kod kalitesi**:
-    - CI kontrollerini (lint, format) geç
-    - ESLint uyarılarını veya hatalarını düzelt (`npm run lint`)
-    - Otomatik kod inceleme araçlarından gelen geri bildirimlere yanıt ver
-    - TypeScript en iyi uygulamalarını takip et ve tip güvenliğini koru
-- **Testler**:
-    - Yeni özellikler için test ekle
-    - `npm test` çalıştırarak tüm testlerin geçtiğinden emin ol
-    - Değişikliklerin mevcut testleri etkiliyorsa onları güncelle
-- **Commit mesajları**:
-    - Açık ve açıklayıcı commit mesajları yaz
-    - İlgili issue'lara `#issue-numarası` ile referans ver (ör: `Fixes #123`)
-- **PR göndermeden önce kontrol listesi**:
-    - Branch'ini upstream'deki en son `main` ile rebase et
-    - Kodun derlendiğinden emin ol (`npm run build`)
-    - Tüm testlerin geçtiğinden emin ol (`npm test`)
-    - Herhangi bir debug kodu veya `console.log` satırını kaldır
-
-### 3. Kod Gönderme: Pull Request (PR) Süreci
-
-#### Taslak Pull Request'ler
-
-Henüz tam incelemeye hazır olmayan işler için taslak PR'lar kullan:
-
-- Otomatik kontrolleri (CI) çalıştırmak
-- Maintainer'lardan veya diğer katkı sağlayanlardan erken geri bildirim almak
-- Çalışmanın devam ettiğini göstermek
-
-Tüm kontroller geçtikten ve "Kod Yazma Rehberi" ile "Pull Request Açıklaması" kriterlerini karşıladığını düşündüğünde PR'ı "Ready for Review" olarak işaretle.
-
-#### Pull Request Açıklaması
-
-PR açıklaman tam olmalı ve [Pull Request Şablonumuzun](.github/pull_request_template.md) yapısına uymalı. Temel noktalar:
-
-- İlgili, onaylanmış GitHub Issue'ya bağlantı
-- Yapılan değişikliklerin ve amacının açık açıklaması
-- Değişiklikleri test etmek için ayrıntılı adımlar
-- Herhangi bir breaking change listesi
-- **UI değişiklikleri için, önce/sonra ekran görüntüleri veya videolar**
-- **PR'ın kullanıcı dokümantasyonunu güncellemeyi gerektirip gerektirmediğini ve hangi belgelerin/alanların etkilendiğini belirt**
-
-#### Pull Request (PR) Politikası
-
-##### Amaç
-
-Temiz, odaklı ve yönetilebilir bir PR backlog'u tutmak.
+2. **Bağımlılıkları yükle:**
 
-##### Issue-First Yaklaşımı
+```
+npm run install:all
+```
 
-- **Zorunlu**: Çalışmaya başlamadan önce mevcut, onaylanmış ve atanmış bir GitHub Issue ("Bug Report" veya "Detailed Feature Proposal") olmalı.
-- **Onay**: Özellikle büyük değişiklikler için, issue'lar maintainer'lar (özellikle @hannesrudolph) tarafından _kodlamaya başlamadan önce_ onaylanmalı.
-- **Referans**: PR'lar bu önceden onaylanmış issue'lara açıklamalarında açıkça referans vermeli.
-- **Sonuçlar**: Bu sürece uyulmazsa PR tam inceleme yapılmadan kapatılabilir.
+3. **Hata ayıklama:** VS Code'da `F5` ile aç.
 
-##### Açık PR'lar için Koşullar
+### Kod Yazma Rehberi
 
-- **Birleştirmeye hazır**: Tüm CI testlerinden geçer, yol haritasıyla uyumlu (varsa), onaylanmış ve atanmış issue'ya bağlı, açık dokümantasyon/yorumlar, UI değişiklikleri için önce/sonra görseller/video içerir
-- **Kapatılacaklar**: CI test hataları, büyük birleştirme çatışmaları, proje hedefleriyle uyumsuzluk veya uzun süreli (30+ gün) güncellenmeyen PR'lar
+- Her özellik veya düzeltme için odaklı bir PR.
+- ESLint ve TypeScript en iyi uygulamalarını takip et.
+- Issue'lara referans veren açık, açıklayıcı commit mesajları yaz (örn. `Fixes #123`).
+- Kapsamlı testler sağla (`npm test`).
+- Göndermeden önce en son `main` branch'i üzerine rebase yap.
 
-##### Prosedür
+### Pull Request Gönderme
 
-1.  **Issue nitelendirme & atama**: @hannesrudolph (veya diğer maintainer'lar) yeni ve mevcut issue'ları gözden geçirip atar.
-2.  **İlk PR triage'ı (günlük)**: Maintainer'lar yeni PR'ları hızlıca kontrol eder, acil veya kritik konuları ayıklar.
-3.  **Ayrıntılı PR incelemesi (haftalık)**: Maintainer'lar PR'ları hazırlık, onaylanmış issue ile uyum ve genel kalite açısından ayrıntılı inceler.
-4.  **Ayrıntılı geri bildirim & yineleme**: İnceleme sonucunda geri bildirim (Onayla, Değişiklik İste, Reddet) verilir. Katkı sağlayanlardan yanıt ve gerekirse düzeltme beklenir.
-5.  **Karar aşaması**: Onaylanan PR'lar birleştirilir. Çözülemeyen sorunlu veya uyumsuz PR'lar gerekçesiyle kapatılır.
-6.  **Takip**: Kapatılan PR sahipleri, sorunlar çözülür veya proje yönü değişirse yeni PR açabilir.
+- Erken geri bildirim istiyorsan **taslak PR** olarak başla.
+- Pull Request Şablonunu takip ederek değişikliklerini açıkça tanımla.
+- UI değişiklikleri için ekran görüntüleri/videolar sağla.
+- Dokümantasyon güncellemeleri gerekip gerekmediğini belirt.
 
-##### Sorumluluklar
+### Pull Request Politikası
 
-- **Issue nitelendirme & süreç takibi (@hannesrudolph & maintainer'lar)**: Tüm katkıların Issue-First yaklaşımına uymasını sağlamak. Katkı sağlayanlara rehberlik etmek.
-- **Maintainer'lar (Geliştirici Takımı)**: PR'ları incelemek, teknik geri bildirim vermek, onay/ret kararı almak, PR'ları birleştirmek.
-- **Katkı sağlayanlar**: PR'ları onaylanmış ve atanmış issue'ya bağlamak, kalite rehberlerine uymak, geri bildirime hızlıca yanıt vermek.
+- Önceden onaylanmış ve atanmış issue'lara referans vermelidir.
+- Politikaya uymayan PR'lar kapatılabilir.
+- PR'lar CI testlerini geçmeli, yol haritasıyla uyumlu olmalı ve net dokümantasyona sahip olmalıdır.
 
-Bu politika, netlik ve verimli entegrasyon sağlar.
+### İnceleme Süreci
 
-## IV. Yasal
+- **Günlük triyaj:** Maintainer'lar tarafından hızlı kontroller.
+- **Haftalık detaylı inceleme:** Kapsamlı değerlendirme.
+- **Geri bildirim temelinde hızla yinele.**
 
-### Katkı Anlaşması
+## Yasal
 
-Bir pull request göndererek, katkılarının [Apache 2.0 Lisansı](LICENSE) (veya projenin mevcut lisansı) kapsamında olacağını kabul etmiş olursun; tıpkı projenin kendisi gibi.
+Pull request göndererek, katkılarının Roo Code'un lisanslamasıyla tutarlı olarak Apache 2.0 Lisansı altında lisanslanacağını kabul etmiş olursun.

locales/vi/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # Đóng góp cho Roo Code
 
-Roo Code là một dự án do cộng đồng dẫn dắt và chúng mình rất trân trọng mọi đóng góp. Để đảm bảo quy trình diễn ra suôn sẻ và hiệu quả cho tất cả mọi người, **chúng mình áp dụng nguyên tắc "[Issue-First](#2-nguyên-tắc-chính-cách-tiếp-cận-issue-first)".** Điều này có nghĩa là mọi công việc đều phải liên kết với một Issue trên GitHub _trước khi_ gửi Pull Request (xem [Chính sách PR](#chính-sách-pull-request-pr) để biết chi tiết). Hãy đọc kỹ hướng dẫn này để hiểu cách đóng góp.
-Hướng dẫn này giải thích cách đóng góp cho Roo Code, dù bạn sửa lỗi, thêm tính năng mới hay cải thiện tài liệu.
+Roo Code là một dự án do cộng đồng dẫn dắt và chúng mình rất trân trọng mọi đóng góp. Để đơn giản hóa quy trình hợp tác, chúng mình áp dụng cách tiếp cận [Issue-First](#cách-tiếp-cận-issue-first), nghĩa là tất cả [Pull Request (PR)](#gửi-pull-request) phải được liên kết với một GitHub Issue trước. Vui lòng đọc kỹ hướng dẫn này.
 
 ## Mục lục
 
-- [I. Trước khi đóng góp](#i-trước-khi-đóng-góp)
-    - [1. Quy tắc ứng xử](#1-quy-tắc-ứng-xử)
-    - [2. Hiểu lộ trình phát triển dự án](#2-hiểu-lộ-trình-phát-triển-dự-án)
-        - [Độ tin cậy là ưu tiên hàng đầu](#độ-tin-cậy-là-ưu-tiên-hàng-đầu)
-        - [Nâng cao trải nghiệm người dùng](#nâng-cao-trải-nghiệm-người-dùng)
-        - [Dẫn đầu về hiệu suất agent](#dẫn-đầu-về-hiệu-suất-agent)
-    - [3. Tham gia cộng đồng Roo Code](#3-tham-gia-cộng-đồng-roo-code)
-- [II. Tìm kiếm & lên kế hoạch đóng góp](#ii-tìm-kiếm--lên-kế-hoạch-đóng-góp)
-    - [1. Các loại đóng góp](#1-các-loại-đóng-góp)
-    - [2. Nguyên tắc chính: Cách tiếp cận Issue-First](#2-nguyên-tắc-chính-cách-tiếp-cận-issue-first)
-    - [3. Quyết định việc cần làm](#3-quyết-định-việc-cần-làm)
-    - [4. Báo cáo lỗi hoặc vấn đề](#4-báo-cáo-lỗi-hoặc-vấn-đề)
-- [III. Quy trình phát triển & gửi bài](#iii-quy-trình-phát-triển--gửi-bài)
-    - [1. Thiết lập môi trường phát triển](#1-thiết-lập-môi-trường-phát-triển)
-    - [2. Hướng dẫn viết mã](#2-hướng-dẫn-viết-mã)
-    - [3. Gửi mã: Quy trình Pull Request (PR)](#3-gửi-mã-quy-trình-pull-request-pr)
-        - [Pull Request nháp](#pull-request-nháp)
-        - [Mô tả Pull Request](#mô-tả-pull-request)
-        - [Chính sách Pull Request (PR)](#chính-sách-pull-request-pr)
-            - [Mục tiêu](#mục-tiêu)
-            - [Cách tiếp cận Issue-First](#cách-tiếp-cận-issue-first)
-            - [Điều kiện cho PR mở](#điều-kiện-cho-pr-mở)
-            - [Quy trình](#quy-trình)
-            - [Trách nhiệm](#trách-nhiệm)
-- [IV. Pháp lý](#iv-pháp-lý)
-    - [Thỏa thuận đóng góp](#thỏa-thuận-đóng-góp)
-
-## I. Trước khi đóng góp
-
-Trước tiên, hãy làm quen với các tiêu chuẩn cộng đồng và định hướng dự án.
+- [Trước khi đóng góp](#trước-khi-đóng-góp)
+- [Tìm kiếm & lên kế hoạch đóng góp](#tìm-kiếm--lên-kế-hoạch-đóng-góp)
+- [Quy trình phát triển & gửi bài](#quy-trình-phát-triển--gửi-bài)
+- [Pháp lý](#pháp-lý)
 
-### 1. Quy tắc ứng xử
-
-Tất cả thành viên đóng góp phải tuân thủ [Quy tắc ứng xử](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md) của chúng mình. Hãy đọc kỹ trước khi đóng góp.
+## Trước khi đóng góp
 
-### 2. Hiểu lộ trình phát triển dự án
+### 1. Quy tắc ứng xử
 
-Roo Code có lộ trình phát triển rõ ràng, định hướng ưu tiên và tương lai của dự án. Hiểu lộ trình này giúp bạn:
+Tất cả thành viên đóng góp phải tuân thủ [Quy tắc ứng xử](./CODE_OF_CONDUCT.md) của chúng mình.
 
-- Định hướng đóng góp phù hợp với mục tiêu dự án
-- Xác định lĩnh vực bạn có thể đóng góp tốt nhất
-- Hiểu bối cảnh đằng sau các quyết định thiết kế
-- Lấy cảm hứng cho các tính năng mới phù hợp với tầm nhìn của dự án
+### 2. Lộ trình phát triển dự án
 
-Chúng mình tập trung vào việc biến Roo Code thành lựa chọn hàng đầu cho các nhà phát triển làm việc với công cụ lập trình dựa trên AI. Dưới đây là cách chúng mình sẽ thực hiện:
+Lộ trình của chúng mình định hướng dự án. Hãy điều chỉnh đóng góp của bạn theo các mục tiêu chính:
 
-#### Độ tin cậy là ưu tiên hàng đầu
+### Độ tin cậy là ưu tiên hàng đầu
 
 - Đảm bảo việc chỉnh sửa diff và thực thi lệnh luôn đáng tin cậy
 - Giảm thiểu các điểm cản trở khiến người dùng ngại sử dụng thường xuyên
 - Đảm bảo hoạt động mượt mà trên mọi ngôn ngữ và nền tảng
 - Mở rộng hỗ trợ mạnh mẽ cho nhiều nhà cung cấp và mô hình AI đa dạng
 
-#### Nâng cao trải nghiệm người dùng
+### Nâng cao trải nghiệm người dùng
 
 - Đơn giản hóa giao diện người dùng để tăng tính rõ ràng và trực quan
-- Liên tục cải thiện quy trình làm việc để đáp ứng kỳ vọng cao của các nhà phát triển đối với công cụ sử dụng hàng ngày
+- Liên tục cải thiện quy trình làm việc để đáp ứng kỳ vọng cao của các nhà phát triển
 
-#### Dẫn đầu về hiệu suất agent
+### Dẫn đầu về hiệu suất agent
 
 - Thiết lập các tiêu chuẩn đánh giá toàn diện (evals) để đo lường năng suất trong thực tế
 - Giúp mọi người dễ dàng chạy và hiểu các đánh giá này
-- Cung cấp các cải tiến cho Roo Code thể hiện rõ sự tăng trưởng trong điểm đánh giá
+- Cung cấp các cải tiến thể hiện rõ sự tăng trưởng trong điểm đánh giá
 
-Chúng mình đặc biệt hoan nghênh các đóng góp giúp tiến gần hơn tới mục tiêu lộ trình. Nếu bạn làm việc liên quan đến các trụ cột này, hãy đề cập trong mô tả PR.
+Đề cập đến sự liên quan với các lĩnh vực này trong PR của bạn.
 
 ### 3. Tham gia cộng đồng Roo Code
 
-Kết nối với cộng đồng Roo Code là cách tuyệt vời để bắt đầu:
-
-- **Cách chính**:
-    1.  Tham gia [cộng đồng Roo Code trên Discord](https://discord.gg/roocode).
-    2.  Sau khi tham gia, gửi tin nhắn trực tiếp (DM) cho **Hannes Rudolph** (Discord: `hrudolph`) để trao đổi về mong muốn đóng góp và nhận hướng dẫn.
-- **Dành cho cộng tác viên giàu kinh nghiệm**: Nếu bạn quen với cách tiếp cận issue-first, có thể tham gia trực tiếp trên GitHub bằng cách theo dõi [bảng Kanban](https://github.com/orgs/RooVetGit/projects/1) và trao đổi qua issues, pull requests.
-
-## II. Tìm kiếm & lên kế hoạch đóng góp
-
-Xác định bạn muốn làm gì và cách thực hiện.
-
-### 1. Các loại đóng góp
+- **Cách chính:** Tham gia [Discord](https://discord.gg/roocode) của chúng mình và nhắn tin trực tiếp cho **Hannes Rudolph (`hrudolph`)**.
+- **Cách thay thế:** Cộng tác viên có kinh nghiệm có thể tham gia trực tiếp qua [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1).
 
-Chúng mình hoan nghênh nhiều hình thức đóng góp:
+## Tìm kiếm & lên kế hoạch đóng góp
 
-- **Sửa lỗi**: Khắc phục vấn đề trong mã nguồn hiện tại
-- **Tính năng mới**: Thêm chức năng mới
-- **Tài liệu**: Cải thiện hướng dẫn, ví dụ hoặc sửa lỗi chính tả
+### Các loại đóng góp
 
-### 2. Nguyên tắc chính: Cách tiếp cận Issue-First
+- **Sửa lỗi:** Khắc phục vấn đề trong mã nguồn.
+- **Tính năng mới:** Thêm chức năng mới.
+- **Tài liệu:** Cải thiện hướng dẫn và độ rõ ràng.
 
-**Mọi đóng góp đều phải bắt đầu bằng một Issue trên GitHub.** Đây là bước quan trọng để đảm bảo sự đồng thuận và tránh lãng phí công sức.
+### Cách tiếp cận Issue-First
 
-- **Tìm hoặc tạo Issue**:
-    - Trước khi bắt đầu, hãy kiểm tra [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) xem đã có issue cho đóng góp của bạn chưa.
-    - Nếu có và chưa được gán, hãy bình luận để nhận việc. Một maintainer sẽ gán cho bạn.
-    - Nếu chưa có, hãy tạo issue mới bằng template phù hợp trên [trang issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose):
-        - Sửa lỗi: dùng template "Bug Report"
-        - Tính năng mới: dùng template "Detailed Feature Proposal". Đợi maintainer (đặc biệt là @hannesrudolph) duyệt trước khi bắt đầu làm.
-        - **Lưu ý**: Ý tưởng chung hoặc thảo luận ban đầu về tính năng có thể bắt đầu ở [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests). Khi ý tưởng rõ ràng hơn, hãy tạo issue "Detailed Feature Proposal".
-- **Nhận việc và được gán**:
-    - Bình luận rõ ràng để nhận việc trên issue.
-    - Đợi maintainer gán chính thức trên GitHub để tránh trùng lặp công việc.
-- **Nếu không tuân thủ**:
-    - Pull Request (PR) gửi mà không có issue liên quan, được duyệt và gán trước có thể bị đóng mà không review đầy đủ. Chính sách này nhằm đảm bảo đóng góp phù hợp với ưu tiên dự án và tôn trọng thời gian của mọi người.
+Mọi đóng góp đều phải bắt đầu bằng một GitHub Issue.
 
-Cách này giúp chúng mình theo dõi công việc, đảm bảo thay đổi là cần thiết và phối hợp hiệu quả.
+- **Kiểm tra issue hiện có:** Tìm kiếm trong [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues).
+- **Tạo issue mới:** Sử dụng mẫu phù hợp:
+    - **Lỗi:** Mẫu "Bug Report".
+    - **Tính năng:** Mẫu "Detailed Feature Proposal". Cần được phê duyệt trước khi bắt đầu.
+- **Nhận issue:** Bình luận và chờ được gán chính thức.
 
-### 3. Quyết định việc cần làm
+**PR không có issue đã duyệt có thể bị đóng.**
 
-- **Good First Issues**: Xem mục "Issue [Unassigned]" trên [Dự án Roo Code Issues](https://github.com/orgs/RooVetGit/projects/1) trên GitHub.
-- **Tài liệu**: Dù `CONTRIBUTING.md` là hướng dẫn chính cho đóng góp mã nguồn, nếu bạn muốn đóng góp cho tài liệu khác (hướng dẫn người dùng, API...), hãy xem [repo Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs) hoặc hỏi trên Discord.
-- **Đề xuất tính năng mới**:
-    1.  **Ý tưởng/thảo luận ban đầu**: Với ý tưởng chung hoặc mới, hãy bắt đầu thảo luận ở [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests).
-    2.  **Đề xuất chính thức**: Với đề xuất cụ thể, sẵn sàng thực hiện, hãy tạo issue "Detailed Feature Proposal" bằng template trên [trang issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose). Đây là phần quan trọng của **cách tiếp cận Issue-First**.
+### Quyết định việc cần làm
 
-### 4. Báo cáo lỗi hoặc vấn đề
+- Xem [Dự án GitHub](https://github.com/orgs/RooVetGit/projects/1) để tìm "Good First Issues" chưa được gán.
+- Về tài liệu, hãy xem [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs).
 
-Nếu bạn phát hiện lỗi:
+### Báo cáo lỗi
 
-1.  **Tìm issue đã có**: Kiểm tra [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) xem đã có ai báo cáo chưa.
-2.  **Tạo issue mới**: Nếu chưa có, dùng template "Bug Report" trên [trang issues](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- Kiểm tra báo cáo hiện có trước.
+- Tạo báo cáo lỗi mới bằng [mẫu "Bug Report"](https://github.com/RooVetGit/Roo-Code/issues/new/choose).
+- **Lỗ hổng bảo mật:** Báo cáo riêng qua [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new).
 
-> 🔐 **Lỗ hổng bảo mật**: Nếu phát hiện lỗ hổng bảo mật, hãy báo cáo riêng qua [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new). Không tạo issue công khai cho lỗ hổng bảo mật.
+## Quy trình phát triển & gửi bài
 
-## III. Quy trình phát triển & gửi bài
+### Thiết lập môi trường phát triển
 
-Làm theo các bước sau để lập trình và gửi đóng góp.
+1. **Fork & Clone:**
 
-### 1. Thiết lập môi trường phát triển
-
-1.  **Fork & Clone**:
-    - Fork repo trên GitHub.
-    - Clone repo về máy: `git clone https://github.com/TEN_TAI_KHOAN/Roo-Code.git`
-2.  **Cài đặt phụ thuộc**: `npm run install:all`
-3.  **Chạy Webview (Dev Mode)**: `npm run dev` (cho app Vite/React với HMR)
-4.  **Debug extension**: Nhấn `F5` trong VS Code (hoặc **Run** → **Start Debugging**) để mở cửa sổ Extension Development Host với Roo Code đã nạp.
-
-Thay đổi ở webview (`webview-ui`) sẽ xuất hiện ngay nhờ Hot Module Replacement. Thay đổi ở extension chính (`src`) cần khởi động lại Extension Development Host.
-
-Hoặc, để build và cài đặt gói `.vsix`:
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<phiên-bản>.vsix
+```
+git clone https://github.com/TEN_TAI_KHOAN/Roo-Code.git
 ```
 
-(Thay `<phiên-bản>` bằng số phiên bản thực tế của file đã build.)
-
-### 2. Hướng dẫn viết mã
-
-- **PR tập trung**: Mỗi PR chỉ nên có một tính năng/sửa lỗi.
-- **Chất lượng mã**:
-    - Vượt qua các kiểm tra CI (lint, format)
-    - Sửa cảnh báo/lỗi ESLint (`npm run lint`)
-    - Phản hồi góp ý từ công cụ review mã tự động
-    - Tuân thủ best practice TypeScript và đảm bảo an toàn kiểu dữ liệu
-- **Kiểm thử**:
-    - Thêm test cho tính năng mới
-    - Chạy `npm test` để đảm bảo mọi test đều pass
-    - Cập nhật test hiện có nếu thay đổi ảnh hưởng đến chúng
-- **Thông điệp commit**:
-    - Viết rõ ràng, mô tả đầy đủ
-    - Tham chiếu issue liên quan bằng `#số-issue` (vd: `Fixes #123`)
-- **Checklist trước khi gửi PR**:
-    - Rebase branch lên `main` mới nhất từ upstream
-    - Đảm bảo mã build thành công (`npm run build`)
-    - Tất cả test phải pass (`npm test`)
-    - Xóa mã debug hoặc `console.log`
-
-### 3. Gửi mã: Quy trình Pull Request (PR)
-
-#### Pull Request nháp
-
-Dùng PR nháp cho công việc chưa sẵn sàng review đầy đủ nhưng bạn muốn:
-
-- Chạy kiểm tra tự động (CI)
-- Nhận góp ý sớm từ maintainer hoặc cộng tác viên khác
-- Thể hiện công việc đang tiến hành
-
-Chỉ đánh dấu PR là "Ready for Review" khi mọi kiểm tra đều pass và bạn tin rằng đã đáp ứng tiêu chí "Hướng dẫn viết mã" và "Mô tả Pull Request".
-
-#### Mô tả Pull Request
-
-Mô tả PR phải đầy đủ và theo cấu trúc của [Template Pull Request](.github/pull_request_template.md). Các điểm chính:
-
-- Link đến Issue đã duyệt trên GitHub mà PR giải quyết
-- Mô tả rõ ràng thay đổi và mục đích
-- Bước kiểm thử chi tiết
-- Danh sách breaking changes (nếu có)
-- **Với thay đổi UI, cung cấp ảnh/video trước/sau**
-- **Chỉ rõ nếu PR cần cập nhật tài liệu người dùng và tài liệu/section nào bị ảnh hưởng**
-
-#### Chính sách Pull Request (PR)
-
-##### Mục tiêu
-
-Duy trì backlog PR sạch, tập trung và dễ quản lý.
+2. **Cài đặt phụ thuộc:**
 
-##### Cách tiếp cận Issue-First
+```
+npm run install:all
+```
 
-- **Bắt buộc**: Trước khi bắt đầu, phải có Issue trên GitHub đã được duyệt và gán (dù là "Bug Report" hay "Detailed Feature Proposal").
-- **Duyệt**: Issue, nhất là thay đổi lớn, phải được maintainer (đặc biệt là @hannesrudolph) duyệt _trước_ khi bắt đầu code.
-- **Tham chiếu**: PR phải tham chiếu rõ ràng đến các Issue đã duyệt trong mô tả.
-- **Hậu quả**: Không tuân thủ có thể khiến PR bị đóng mà không review đầy đủ.
+3. **Debug:** Mở bằng VS Code (`F5`).
 
-##### Điều kiện cho PR mở
+### Hướng dẫn viết mã
 
-- **Sẵn sàng merge**: Pass mọi kiểm tra CI, phù hợp roadmap (nếu có), liên kết với Issue đã duyệt và gán, có tài liệu/bình luận rõ ràng, có ảnh/video trước/sau cho thay đổi UI
-- **Đóng**: Lỗi CI, xung đột merge lớn, không phù hợp mục tiêu dự án hoặc không cập nhật sau góp ý >30 ngày
+- Mỗi PR chỉ tập trung vào một tính năng hoặc sửa lỗi.
+- Tuân thủ các thực hành tốt nhất của ESLint và TypeScript.
+- Viết thông điệp commit rõ ràng, tham chiếu đến issue (ví dụ: `Fixes #123`).
+- Cung cấp bài kiểm tra đầy đủ (`npm test`).
+- Rebase trên nhánh `main` mới nhất trước khi gửi.
 
-##### Quy trình
+### Gửi Pull Request
 
-1.  **Duyệt & gán Issue**: @hannesrudolph (hoặc maintainer khác) duyệt và gán Issue mới/cũ.
-2.  **Triage PR ban đầu (hàng ngày)**: Maintainer kiểm tra nhanh PR mới để lọc việc khẩn cấp hoặc vấn đề nghiêm trọng.
-3.  **Review PR chi tiết (hàng tuần)**: Maintainer review kỹ PR về độ sẵn sàng, phù hợp Issue và chất lượng tổng thể.
-4.  **Góp ý chi tiết & lặp lại**: Sau review, maintainer góp ý (Approve, Request Changes, Reject). Cộng tác viên cần phản hồi và chỉnh sửa nếu cần.
-5.  **Quyết định**: PR được duyệt sẽ merge. PR có vấn đề không giải quyết được hoặc không phù hợp sẽ bị đóng kèm giải thích.
-6.  **Theo dõi**: Tác giả PR bị đóng có thể sửa theo góp ý và mở lại nếu vấn đề được giải quyết hoặc hướng dự án thay đổi.
+- Bắt đầu với **PR nháp** nếu muốn nhận phản hồi sớm.
+- Mô tả rõ ràng các thay đổi, tuân theo Mẫu Pull Request.
+- Cung cấp ảnh chụp/video cho thay đổi UI.
+- Chỉ rõ nếu cần cập nhật tài liệu.
 
-##### Trách nhiệm
+### Chính sách Pull Request
 
-- **Duyệt Issue & tuân thủ quy trình (@hannesrudolph & maintainer)**: Đảm bảo mọi đóng góp tuân thủ cách tiếp cận Issue-First. Hướng dẫn cộng tác viên.
-- **Maintainer (Dev Team)**: Review PR, góp ý kỹ thuật, quyết định duyệt/từ chối, merge PR.
-- **Cộng tác viên**: Đảm bảo PR liên kết với Issue đã duyệt và gán, tuân thủ hướng dẫn chất lượng, phản hồi nhanh góp ý.
+- Phải tham chiếu đến issue đã được phê duyệt và gán.
+- PR không tuân thủ chính sách có thể bị đóng.
+- PR cần vượt qua kiểm tra CI, phù hợp với lộ trình và có tài liệu rõ ràng.
 
-Chính sách này đảm bảo rõ ràng và tích hợp hiệu quả.
+### Quy trình đánh giá
 
-## IV. Pháp lý
+- **Phân loại hàng ngày:** Kiểm tra nhanh bởi maintainer.
+- **Đánh giá chi tiết hàng tuần:** Đánh giá toàn diện.
+- **Lặp lại nhanh chóng** dựa trên phản hồi.
 
-### Thỏa thuận đóng góp
+## Pháp lý
 
-Khi gửi pull request, bạn đồng ý rằng đóng góp của mình sẽ được cấp phép theo [Giấy phép Apache 2.0](LICENSE) (hoặc giấy phép hiện tại của dự án), giống như dự án.
+Khi gửi pull request, bạn đồng ý rằng đóng góp của mình sẽ được cấp phép theo Giấy phép Apache 2.0, phù hợp với giấy phép của Roo Code.

locales/zh-CN/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # 参与 Roo Code 贡献
 
-Roo Code 是一个由社区驱动的项目，我们非常重视每一位贡献者。为了让每个人的贡献流程顺畅高效，**我们采用“[Issue-First](#2-关键原则-issue-first-方式)”原则。** 这意味着所有工作都必须在提交 Pull Request _之前_ 关联到一个 GitHub Issue（详情见[PR 政策](#pull-request-pr-政策)）。请认真阅读本指南，了解如何参与贡献。
-本指南介绍了如何为 Roo Code 做出贡献，无论是修复 bug、添加新功能还是完善文档。
+Roo Code 是一个由社区驱动的项目，我们高度重视每一份贡献。为了简化协作流程，我们采用 [Issue-First](#issue-first-方式) 原则，这意味着所有 [Pull Request (PR)](#提交-pull-request) 必须首先关联到 GitHub Issue。请仔细阅读本指南。
 
 ## 目录
 
-- [I. 贡献前须知](#i-贡献前须知)
-    - [1. 行为准则](#1-行为准则)
-    - [2. 了解项目路线图](#2-了解项目路线图)
-        - [可靠性优先](#可靠性优先)
-        - [增强用户体验](#增强用户体验)
-        - [引领代理性能](#引领代理性能)
-    - [3. 加入 Roo Code 社区](#3-加入-roo-code-社区)
-- [II. 寻找与规划你的贡献](#ii-寻找与规划你的贡献)
-    - [1. 贡献类型](#1-贡献类型)
-    - [2. 关键原则：Issue-First 方式](#2-关键原则-issue-first-方式)
-    - [3. 决定要做什么](#3-决定要做什么)
-    - [4. 报告 bug 或问题](#4-报告-bug-或问题)
-- [III. 开发与提交流程](#iii-开发与提交流程)
-    - [1. 开发环境配置](#1-开发环境配置)
-    - [2. 编码规范](#2-编码规范)
-    - [3. 提交代码：Pull Request (PR) 流程](#3-提交代码-pull-request-pr-流程)
-        - [草稿 Pull Request](#草稿-pull-request)
-        - [Pull Request 描述](#pull-request-描述)
-        - [Pull Request (PR) 政策](#pull-request-pr-政策)
-            - [目标](#目标)
-            - [Issue-First 方式](#issue-first-方式)
-            - [开放 PR 条件](#开放-pr-条件)
-            - [流程](#流程)
-            - [责任分工](#责任分工)
-- [IV. 法律声明](#iv-法律声明)
-    - [贡献协议](#贡献协议)
-
-## I. 贡献前须知
-
-首先，请熟悉我们的社区标准和项目方向。
+- [贡献前须知](#贡献前须知)
+- [寻找与规划你的贡献](#寻找与规划你的贡献)
+- [开发与提交流程](#开发与提交流程)
+- [法律声明](#法律声明)
 
-### 1. 行为准则
-
-所有贡献者都必须遵守我们的[行为准则](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md)。请在贡献前仔细阅读。
+## 贡献前须知
 
-### 2. 了解项目路线图
+### 1. 行为准则
 
-Roo Code 有清晰的发展路线图，指引我们的优先级和未来方向。了解路线图有助于你：
+所有贡献者必须遵守我们的[行为准则](./CODE_OF_CONDUCT.md)。
 
-- 让你的贡献与项目目标保持一致
-- 找到你最擅长的领域
-- 理解某些设计决策的背景
-- 获得新功能灵感，助力项目愿景
+### 2. 项目路线图
 
-我们专注于将 Roo Code 打造成开发者使用 AI 驱动编码工具时的首选。这是我们的实现路径：
+我们的路线图指引项目方向。请将你的贡献与这些关键目标保持一致：
 
-#### 可靠性优先
+### 可靠性优先
 
 - 确保差异编辑和命令执行始终可靠
 - 减少阻碍常规使用的摩擦点
 - 确保在所有语言环境和平台上流畅运行
 - 扩展对各种 AI 提供商和模型的强大支持
 
-#### 增强用户体验
+### 增强用户体验
 
-- 简化 UI/UX，提高清晰度和直观性
+- 简化用户界面，提高清晰度和直观性
 - 持续改进工作流程，满足开发者对日常工具的高期望
 
-#### 引领代理性能
+### 引领代理性能
 
-- 建立全面的评估基准（evals）来衡量实际工作中的生产力
+- 建立全面的评估基准（evals）衡量实际工作中的生产力
 - 让每个人都能轻松运行和解读这些评估
-- 提供 Roo Code 改进，展示明确的评分提升
+- 提供明显提升评分的改进
 
-特别欢迎推进路线图目标的贡献。如果你的工作与这些方向相关，请在 PR 描述中说明。
+在 PR 中请提及与这些领域的关联。
 
 ### 3. 加入 Roo Code 社区
 
-加入 Roo Code 社区是一个很好的起点：
-
-- **主要方式**：
-    1.  加入 [Roo Code Discord 社区](https://discord.gg/roocode)。
-    2.  加入后，私信 **Hannes Rudolph**（Discord: `hrudolph`），表达你的兴趣并获取指导。
-- **有经验的贡献者可选**：如果你熟悉 Issue-First 方式，可以直接通过 GitHub 跟进 [看板](https://github.com/orgs/RooVetGit/projects/1)，通过 issue 和 pull request 沟通。
-
-## II. 寻找与规划你的贡献
-
-明确你想做什么以及如何开展。
-
-### 1. 贡献类型
+- **主要方式：** 加入我们的 [Discord](https://discord.gg/roocode) 并私信 **Hannes Rudolph (`hrudolph`)**。
+- **替代方式：** 有经验的贡献者可通过 [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1) 直接参与。
 
-我们欢迎多种形式的贡献：
+## 寻找与规划你的贡献
 
-- **Bug 修复**：修正现有代码中的问题
-- **新功能**：添加新功能
-- **文档**：完善指南、补充示例或修正错别字
+### 贡献类型
 
-### 2. 关键原则：Issue-First 方式
+- **Bug 修复：** 解决代码问题。
+- **新功能：** 添加新功能。
+- **文档：** 完善指南和提高清晰度。
 
-**所有贡献都必须从 GitHub Issue 开始。** 这是确保协作一致、避免无效劳动的关键步骤。
+### Issue-First 方式
 
-- **查找或创建 Issue**：
-    - 开始前，先在 [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) 检查是否已有相关 issue。
-    - 如果有且未分配，评论表达你想认领，维护者会分配给你。
-    - 如果没有，请在 [issues 页面](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 用合适模板新建：
-        - Bug 用“Bug Report”模板
-        - 新功能用“Detailed Feature Proposal”模板。开始实现前请等待维护者（尤其是 @hannesrudolph）批准。
-        - **注意**：功能的初步想法或讨论可在 [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests) 开始，具体后再建“Detailed Feature Proposal” issue。
-- **认领与分配**：
-    - 明确评论表达你要做某个 issue。
-    - 等待维护者在 GitHub 正式分配，避免多人重复劳动。
-- **不遵守的后果**：
-    - 未关联、未批准、未分配的 PR 可能会被关闭，不做完整 review。此政策确保贡献与项目优先级一致，尊重所有人的时间。
+所有贡献必须从 GitHub Issue 开始。
 
-这样有助于我们跟踪工作、确保变更是需要的，并高效协作。
+- **检查现有 issue：** 搜索 [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)。
+- **创建 issue：** 使用适当模板：
+    - **Bug：** "Bug Report" 模板。
+    - **功能：** "Detailed Feature Proposal" 模板。开始前需获得批准。
+- **认领 issue：** 评论并等待正式分配。
 
-### 3. 决定要做什么
+**未关联已批准 issue 的 PR 可能会被关闭。**
 
-- **Good First Issues**：查看 GitHub [Roo Code Issues 项目](https://github.com/orgs/RooVetGit/projects/1) 的“未分配 Issue”部分。
-- **文档**：虽然本 `CONTRIBUTING.md` 是代码贡献主指南，但如想参与其他文档（如用户指南、API 文档），请查阅 [Roo Code Docs 仓库](https://github.com/RooVetGit/Roo-Code-Docs) 或在 Discord 社区咨询。
-- **提出新功能**：
-    1.  **初步想法/讨论**：广泛或初步想法可在 [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests) 讨论。
-    2.  **正式提案**：具体、可执行的建议请用 [issues 页面](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 的“Detailed Feature Proposal”模板新建 issue。这是 **Issue-First 方式** 的关键环节。
+### 决定要做什么
 
-### 4. 报告 bug 或问题
+- 查看 [GitHub 项目](https://github.com/orgs/RooVetGit/projects/1) 中未分配的 "Good First Issues"。
+- 文档相关，请访问 [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs)。
 
-如果你发现 bug：
+### 报告 Bug
 
-1.  **查找已有 issue**：在 [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) 检查是否已有人报告。
-2.  **新建 issue**：如无重复，请用 [issues 页面](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 的“Bug Report”模板新建。
+- 先检查是否已有相关报告。
+- 使用 ["Bug Report" 模板](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 创建新 bug 报告。
+- **安全问题：** 通过 [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new) 私下报告。
 
-> 🔐 **安全漏洞**：如发现安全漏洞，请通过 [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new) 私下报告。请勿公开 issue。
+## 开发与提交流程
 
-## III. 开发与提交流程
+### 开发环境配置
 
-按以下步骤进行开发和提交。
+1. **Fork & Clone：**
 
-### 1. 开发环境配置
-
-1.  **Fork & Clone**：
-    - 在 GitHub 上 fork 本仓库
-    - 本地克隆你的 fork：`git clone https://github.com/你的用户名/Roo-Code.git`
-2.  **安装依赖**：`npm run install:all`
-3.  **运行 Webview（开发模式）**：`npm run dev`（适用于 Vite/React 应用，支持 HMR）
-4.  **调试扩展**：在 VS Code 按 `F5`（或 **Run** → **Start Debugging**），打开 Roo Code 的 Extension Development Host 窗口
-
-webview（`webview-ui`）的更改会通过热更新（HMR）即时生效。核心扩展（`src`）的更改需重启 Extension Development Host。
-
-也可以构建并安装 `.vsix` 包：
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<版本号>.vsix
+```
+git clone https://github.com/你的用户名/Roo-Code.git
 ```
 
-（将 `<版本号>` 替换为实际生成的文件版本号）
-
-### 2. 编码规范
-
-- **聚焦 PR**：每个 PR 只做一项功能/修复
-- **代码质量**：
-    - 通过 CI 检查（lint、格式化）
-    - 修复 ESLint 警告或错误（`npm run lint`）
-    - 响应自动代码审查工具反馈
-    - 遵循 TypeScript 最佳实践，保持类型安全
-- **测试**：
-    - 新功能需添加测试
-    - 运行 `npm test`，确保所有测试通过
-    - 如有影响，需更新现有测试
-- **提交信息**：
-    - 编写清晰、描述性的提交信息
-    - 用 `#issue-number`（如 `Fixes #123`）引用相关 issue
-- **PR 提交前检查**：
-    - 将分支 rebase 到最新 upstream `main`
-    - 确保代码可构建（`npm run build`）
-    - 所有测试通过（`npm test`）
-    - 移除调试代码或 `console.log`
-
-### 3. 提交代码：Pull Request (PR) 流程
-
-#### 草稿 Pull Request
-
-对于尚未准备好完整 review 的工作，请用草稿 PR：
-
-- 运行自动检查（CI）
-- 提前获取维护者或其他贡献者反馈
-- 标明工作正在进行中
-
-只有当所有检查通过，并且你认为已满足“编码规范”和“Pull Request 描述”要求时，才将 PR 标记为“Ready for Review”。
-
-#### Pull Request 描述
-
-你的 PR 描述必须完整，并遵循我们的 [Pull Request 模板](.github/pull_request_template.md) 结构。要点包括：
-
-- 关联的已批准 GitHub Issue 链接
-- 变更内容及目的的清晰描述
-- 测试变更的详细步骤
-- 所有 breaking changes 列表
-- **UI 变更需提供前后截图或视频**
-- **如需更新用户文档，请说明涉及哪些文档/部分**
-
-#### Pull Request (PR) 政策
-
-##### 目标
-
-保持清晰、聚焦、可管理的 PR backlog。
+2. **安装依赖：**
 
-##### Issue-First 方式
+```
+npm run install:all
+```
 
-- **必须**：开始前，需有已批准并分配的 GitHub Issue（“Bug Report”或“Detailed Feature Proposal”）
-- **审批**：尤其是重大变更，需维护者（特别是 @hannesrudolph）提前审批
-- **引用**：PR 描述中需明确引用这些已审批的 issue
-- **后果**：不遵守流程的 PR 可能会被关闭，不做完整 review
+3. **调试：** 在 VS Code 中按 `F5` 打开。
 
-##### 开放 PR 条件
+### 编码规范
 
-- **可合并**：通过所有 CI 测试，符合路线图（如适用），关联已批准并分配的 issue，有清晰文档/注释，UI 变更有前后图片/视频
-- **需关闭**：CI 测试失败、严重合并冲突、不符项目目标或长期（>30 天）无更新
+- 每个 PR 专注于一个功能或修复。
+- 遵循 ESLint 和 TypeScript 最佳实践。
+- 编写清晰的提交信息，引用相关 issue（如 `Fixes #123`）。
+- 提供完整测试（`npm test`）。
+- 提交前先在最新 `main` 分支上进行 rebase。
 
-##### 流程
+### 提交 Pull Request
 
-1.  **Issue 资格审核与分配**：@hannesrudolph（或其他维护者）审核并分配新/现有 issue
-2.  **初步 PR 筛查（每日）**：维护者快速检查新 PR，筛选紧急或关键问题
-3.  **详细 PR 审查（每周）**：维护者详细评估 PR 的准备度、与 issue 的一致性和整体质量
-4.  **详细反馈与迭代**：根据审查反馈（Approve、Request Changes、Reject），贡献者需及时响应和改进
-5.  **决策阶段**：通过的 PR 合并，无法解决或不符方向的 PR 说明原因后关闭
-6.  **后续跟进**：被关闭 PR 的作者可根据反馈修正后重新提交
+- 如需早期反馈，可先提交**草稿 PR**。
+- 清晰描述你的更改，遵循 Pull Request 模板。
+- 为 UI 变更提供截图/视频。
+- 说明是否需要更新文档。
 
-##### 责任分工
+### Pull Request 政策
 
-- **Issue 资格审核与流程把控（@hannesrudolph & 维护者）**：确保所有贡献遵循 Issue-First 方式，指导贡献者
-- **维护者（开发团队）**：初步/详细审查 PR，提供技术反馈，决定批准/拒绝，合并 PR
-- **贡献者**：确保 PR 关联已批准并分配的 issue，遵守质量规范，及时响应反馈
+- 必须引用已批准并分配的 issue。
+- 不遵守政策的 PR 可能会被关闭。
+- PR 应通过 CI 测试，符合路线图，并有清晰文档。
 
-本政策确保流程清晰、高效集成。
+### 审查流程
 
-## IV. 法律声明
+- **每日筛查：** 维护者快速检查。
+- **每周深入审查：** 全面评估。
+- **根据反馈快速迭代**。
 
-### 贡献协议
+## 法律声明
 
-提交 Pull Request 即表示你同意你的贡献将以 [Apache 2.0 许可证](LICENSE)（或当前项目许可证）授权，与项目一致。
+提交贡献即表示你同意你的贡献将基于 Apache 2.0 许可证，与 Roo Code 的许可一致。

locales/zh-TW/CONTRIBUTING.md

@@ -4,239 +4,126 @@
 
 # 參與 Roo Code 貢獻
 
-Roo Code 是一個由社群驅動的專案，我們非常重視每一位貢獻者。為了讓每個人的貢獻流程順暢且有效率，**我們採用「[Issue-First](#2-關鍵原則-issue-first-方式)」原則。** 這代表所有工作都必須在提交 Pull Request _之前_ 先關聯一個 GitHub Issue（詳情請見[PR 政策](#pull-request-pr-政策)）。請仔細閱讀本指南，了解如何參與貢獻。
-本指南說明如何為 Roo Code 做出貢獻，無論是修正 bug、加入新功能或完善文件。
+Roo Code 是一個由社群驅動的專案，我們深深重視每一份貢獻。為了簡化協作流程，我們採用 [Issue-First](#issue-first-方式) 原則，這表示所有 [Pull Request (PR)](#提交-pull-request) 必須先關聯至 GitHub Issue。請仔細閱讀本指南。
 
 ## 目錄
 
-- [I. 貢獻前須知](#i-貢獻前須知)
-    - [1. 行為準則](#1-行為準則)
-    - [2. 了解專案藍圖](#2-了解專案藍圖)
-        - [可靠性優先](#可靠性優先)
-        - [增強使用者體驗](#增強使用者體驗)
-        - [引領代理效能](#引領代理效能)
-    - [3. 加入 Roo Code 社群](#3-加入-roo-code-社群)
-- [II. 尋找與規劃你的貢獻](#ii-尋找與規劃你的貢獻)
-    - [1. 貢獻類型](#1-貢獻類型)
-    - [2. 關鍵原則：Issue-First 方式](#2-關鍵原則-issue-first-方式)
-    - [3. 決定要做什麼](#3-決定要做什麼)
-    - [4. 回報 bug 或問題](#4-回報-bug-或問題)
-- [III. 開發與提交流程](#iii-開發與提交流程)
-    - [1. 開發環境設定](#1-開發環境設定)
-    - [2. 程式碼規範](#2-程式碼規範)
-    - [3. 提交程式碼：Pull Request (PR) 流程](#3-提交程式碼-pull-request-pr-流程)
-        - [草稿 Pull Request](#草稿-pull-request)
-        - [Pull Request 描述](#pull-request-描述)
-        - [Pull Request (PR) 政策](#pull-request-pr-政策)
-            - [目標](#目標)
-            - [Issue-First 方式](#issue-first-方式)
-            - [開放 PR 條件](#開放-pr-條件)
-            - [流程](#流程)
-            - [責任分工](#責任分工)
-- [IV. 法律聲明](#iv-法律聲明)
-    - [貢獻協議](#貢獻協議)
-
-## I. 貢獻前須知
-
-請先熟悉我們的社群標準與專案方向。
+- [貢獻前須知](#貢獻前須知)
+- [尋找與規劃你的貢獻](#尋找與規劃你的貢獻)
+- [開發與提交流程](#開發與提交流程)
+- [法律聲明](#法律聲明)
 
-### 1. 行為準則
-
-所有貢獻者都必須遵守我們的[行為準則](https://github.com/RooVetGit/Roo-Code/blob/main/CODE_OF_CONDUCT.md)。請在貢獻前仔細閱讀。
+## 貢獻前須知
 
-### 2. 了解專案藍圖
+### 1. 行為準則
 
-Roo Code 有明確的開發藍圖，指引我們的優先順序與未來方向。了解藍圖有助於你：
+所有貢獻者必須遵守我們的[行為準則](./CODE_OF_CONDUCT.md)。
 
-- 讓你的貢獻與專案目標一致
-- 找到你最擅長的領域
-- 理解某些設計決策的背景
-- 激發新功能靈感，推動專案願景
+### 2. 專案藍圖
 
-我們專注於將 Roo Code 打造成開發者使用 AI 驅動編碼工具時的首選。這是我們的實現路徑：
+我們的藍圖指引專案方向。請將你的貢獻與這些關鍵目標保持一致：
 
-#### 可靠性優先
+### 可靠性優先
 
 - 確保差異編輯和命令執行始終可靠
 - 減少阻礙常規使用的摩擦點
 - 確保在所有語言環境和平台上順暢運行
 - 擴展對各種 AI 供應商和模型的強大支援
 
-#### 增強使用者體驗
+### 增強使用者體驗
 
-- 簡化 UI/UX，提高清晰度和直覺性
+- 簡化使用者介面，提高清晰度和直覺性
 - 持續改進工作流程，滿足開發者對日常工具的高期望
 
-#### 引領代理效能
+### 引領代理效能
 
-- 建立全面的評估基準（evals）來衡量實際工作中的生產力
+- 建立全面的評估基準（evals）衡量實際工作中的生產力
 - 讓每個人都能輕鬆執行和解讀這些評估
-- 提供 Roo Code 改進，展示明確的評分提升
+- 提供明顯提升評分的改進
 
-特別歡迎推動藍圖目標的貢獻。如果你的工作與這些方向相關，請在 PR 描述中說明。
+在 PR 中請提及與這些領域的關聯。
 
 ### 3. 加入 Roo Code 社群
 
-加入 Roo Code 社群是很好的起點：
-
-- **主要方式**：
-    1.  加入 [Roo Code Discord 社群](https://discord.gg/roocode)。
-    2.  加入後，私訊 **Hannes Rudolph**（Discord: `hrudolph`），表達你的興趣並獲得指導。
-- **有經驗的貢獻者可選**：如果你熟悉 Issue-First 方式，可以直接透過 GitHub 跟進 [看板](https://github.com/orgs/RooVetGit/projects/1)，用 issue 與 pull request 溝通。
-
-## II. 尋找與規劃你的貢獻
-
-明確你想做什麼以及如何進行。
-
-### 1. 貢獻類型
+- **主要方式：** 加入我們的 [Discord](https://discord.gg/roocode) 並私訊 **Hannes Rudolph (`hrudolph`)**。
+- **替代方式：** 有經驗的貢獻者可透過 [GitHub Projects](https://github.com/orgs/RooVetGit/projects/1) 直接參與。
 
-我們歡迎多種形式的貢獻：
+## 尋找與規劃你的貢獻
 
-- **Bug 修正**：修正現有程式碼問題
-- **新功能**：新增功能
-- **文件**：完善指南、補充範例或修正錯字
+### 貢獻類型
 
-### 2. 關鍵原則：Issue-First 方式
+- **Bug 修正：** 解決程式碼問題。
+- **新功能：** 新增功能。
+- **文件：** 完善指南和提高清晰度。
 
-**所有貢獻都必須從 GitHub Issue 開始。** 這是確保協作一致、避免無效勞動的關鍵步驟。
+### Issue-First 方式
 
-- **查找或建立 Issue**：
-    - 開始前，先在 [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) 檢查是否已有相關 issue。
-    - 如果有且未分配，留言表達你想認領，維護者會分配給你。
-    - 如果沒有，請在 [issues 頁面](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 用合適模板新建：
-        - Bug 用「Bug Report」模板
-        - 新功能用「Detailed Feature Proposal」模板。開始實作前請等維護者（尤其是 @hannesrudolph）批准。
-        - **注意**：功能初步想法或討論可在 [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests) 開始，具體後再建「Detailed Feature Proposal」issue。
-- **認領與分配**：
-    - 明確留言表達你要做某個 issue。
-    - 等待維護者在 GitHub 正式分配，避免多人重複。
-- **不遵守的後果**：
-    - 未關聯、未批准、未分配的 PR 可能會被關閉，不做完整 review。此政策確保貢獻與專案優先順序一致，尊重大家的時間。
+所有貢獻必須從 GitHub Issue 開始。
 
-這有助於我們追蹤工作、確保變更是需要的，並高效協作。
+- **檢查現有 issue：** 搜尋 [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues)。
+- **建立 issue：** 使用適當範本：
+    - **Bug：** 「Bug Report」範本。
+    - **功能：** 「Detailed Feature Proposal」範本。開始前需獲得批准。
+- **認領 issue：** 留言並等待正式分配。
 
-### 3. 決定要做什麼
+**未關聯已批准 issue 的 PR 可能會被關閉。**
 
-- **Good First Issues**：查看 GitHub [Roo Code Issues 專案](https://github.com/orgs/RooVetGit/projects/1) 的「未分配 Issue」區塊。
-- **文件**：雖然本 `CONTRIBUTING.md` 是程式碼貢獻主指南，但如想參與其他文件（如使用者指南、API 文件），請參考 [Roo Code Docs 倉庫](https://github.com/RooVetGit/Roo-Code-Docs) 或在 Discord 社群詢問。
-- **提出新功能**：
-    1.  **初步想法/討論**：廣泛或初步想法可在 [GitHub Discussions](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests) 討論。
-    2.  **正式提案**：具體、可執行的建議請用 [issues 頁面](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 的「Detailed Feature Proposal」模板新建 issue。這是 **Issue-First 方式** 的關鍵環節。
+### 決定要做什麼
 
-### 4. 回報 bug 或問題
+- 查看 [GitHub 專案](https://github.com/orgs/RooVetGit/projects/1) 中未分配的「Good First Issues」。
+- 文件相關，請訪問 [Roo Code Docs](https://github.com/RooVetGit/Roo-Code-Docs)。
 
-如果你發現 bug：
+### 回報 Bug
 
-1.  **查找已有 issue**：在 [GitHub Issues](https://github.com/RooVetGit/Roo-Code/issues) 檢查是否已有人回報。
-2.  **新建 issue**：如無重複，請用 [issues 頁面](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 的「Bug Report」模板新建。
+- 先檢查是否已有相關報告。
+- 使用 [「Bug Report」範本](https://github.com/RooVetGit/Roo-Code/issues/new/choose) 建立新 bug 報告。
+- **安全問題：** 透過 [security advisories](https://github.com/RooVetGit/Roo-Code/security/advisories/new) 私下回報。
 
-> 🔐 **安全漏洞**：如發現安全漏洞，請透過 [GitHub Security Advisory Tool](https://github.com/RooVetGit/Roo-Code/security/advisories/new) 私下回報。請勿公開 issue。
+## 開發與提交流程
 
-## III. 開發與提交流程
+### 開發環境設定
 
-請依下列步驟進行開發與提交。
+1. **Fork & Clone：**
 
-### 1. 開發環境設定
-
-1.  **Fork & Clone**：
-    - 在 GitHub 上 fork 本倉庫
-    - 本地 clone 你的 fork：`git clone https://github.com/你的帳號/Roo-Code.git`
-2.  **安裝相依套件**：`npm run install:all`
-3.  **執行 Webview（開發模式）**：`npm run dev`（適用於 Vite/React 應用，支援 HMR）
-4.  **除錯擴充功能**：在 VS Code 按 `F5`（或 **Run** → **Start Debugging**），開啟 Roo Code 的 Extension Development Host 視窗
-
-webview（`webview-ui`）的變更會即時熱更新（HMR）。核心擴充（`src`）的變更需重啟 Extension Development Host。
-
-也可建置並安裝 `.vsix` 套件：
-
-```sh
-npm run build
-code --install-extension bin/roo-cline-<版本號>.vsix
+```
+git clone https://github.com/你的帳號/Roo-Code.git
 ```
 
-（將 `<版本號>` 替換為實際產生的檔案版本號）
-
-### 2. 程式碼規範
-
-- **聚焦 PR**：每個 PR 只做一項功能/修正
-- **程式碼品質**：
-    - 通過 CI 檢查（lint、格式化）
-    - 修正 ESLint 警告或錯誤（`npm run lint`）
-    - 回應自動化程式碼審查工具意見
-    - 遵循 TypeScript 最佳實踐，保持型別安全
-- **測試**：
-    - 新功能需加測試
-    - 執行 `npm test`，確保所有測試通過
-    - 如有影響，需更新現有測試
-- **提交訊息**：
-    - 撰寫清楚、具描述性的提交訊息
-    - 用 `#issue-number`（如 `Fixes #123`）引用相關 issue
-- **PR 提交前檢查**：
-    - 將分支 rebase 到最新 upstream `main`
-    - 確保程式碼可建置（`npm run build`）
-    - 所有測試通過（`npm test`）
-    - 移除除錯程式碼或 `console.log`
-
-### 3. 提交程式碼：Pull Request (PR) 流程
-
-#### 草稿 Pull Request
-
-對於尚未準備好完整 review 的工作，請用草稿 PR：
-
-- 執行自動檢查（CI）
-- 提前獲得維護者或其他貢獻者回饋
-- 標明工作進行中
-
-只有當所有檢查通過，且你認為已滿足「程式碼規範」與「Pull Request 描述」要求時，才將 PR 標記為「Ready for Review」。
-
-#### Pull Request 描述
-
-你的 PR 描述必須完整，並遵循我們的 [Pull Request 模板](.github/pull_request_template.md) 結構。重點包括：
-
-- 關聯的已批准 GitHub Issue 連結
-- 變更內容及目的的清楚描述
-- 測試變更的詳細步驟
-- 所有 breaking changes 列表
-- **UI 變更需提供前後截圖或影片**
-- **如需更新使用者文件，請說明涉及哪些文件/區塊**
-
-#### Pull Request (PR) 政策
-
-##### 目標
-
-保持清楚、聚焦、可管理的 PR backlog。
+2. **安裝相依套件：**
 
-##### Issue-First 方式
+```
+npm run install:all
+```
 
-- **必須**：開始前，需有已批准並分配的 GitHub Issue（「Bug Report」或「Detailed Feature Proposal」）
-- **審核**：尤其是重大變更，需維護者（特別是 @hannesrudolph）提前審核
-- **引用**：PR 描述中需明確引用這些已審核的 issue
-- **後果**：不遵守流程的 PR 可能會被關閉，不做完整 review
+3. **除錯：** 在 VS Code 中按 `F5` 開啟。
 
-##### 開放 PR 條件
+### 程式碼規範
 
-- **可合併**：通過所有 CI 測試，符合藍圖（如適用），關聯已批准並分配的 issue，有清楚文件/註解，UI 變更有前後圖片/影片
-- **需關閉**：CI 測試失敗、嚴重合併衝突、不符專案目標或長期（>30 天）無更新
+- 每個 PR 專注於一個功能或修正。
+- 遵循 ESLint 和 TypeScript 最佳實踐。
+- 撰寫清晰的提交訊息，引用相關 issue（如 `Fixes #123`）。
+- 提供完整測試（`npm test`）。
+- 提交前先在最新 `main` 分支上進行 rebase。
 
-##### 流程
+### 提交 Pull Request
 
-1.  **Issue 資格審查與分配**：@hannesrudolph（或其他維護者）審查並分配新/現有 issue
-2.  **初步 PR 篩查（每日）**：維護者快速檢查新 PR，篩選緊急或關鍵問題
-3.  **詳細 PR 審查（每週）**：維護者詳細評估 PR 的準備度、與 issue 的一致性和整體品質
-4.  **詳細回饋與修正**：根據審查回饋（Approve、Request Changes、Reject），貢獻者需及時回應和改進
-5.  **決策階段**：通過的 PR 合併，無法解決或不符方向的 PR 說明原因後關閉
-6.  **後續跟進**：被關閉 PR 的作者可根據回饋修正後重新提交
+- 如需早期回饋，可先提交**草稿 PR**。
+- 清晰描述你的更改，遵循 Pull Request 範本。
+- 為 UI 變更提供截圖/影片。
+- 說明是否需要更新文件。
 
-##### 責任分工
+### Pull Request 政策
 
-- **Issue 資格審查與流程把控（@hannesrudolph & 維護者）**：確保所有貢獻遵循 Issue-First 方式，指導貢獻者
-- **維護者（開發團隊）**：初步/詳細審查 PR，提供技術回饋，決定批准/拒絕，合併 PR
-- **貢獻者**：確保 PR 關聯已批准並分配的 issue，遵守品質規範，及時回應回饋
+- 必須引用已批准並分配的 issue。
+- 不遵守政策的 PR 可能會被關閉。
+- PR 應通過 CI 測試，符合藍圖，並有清晰文件。
 
-本政策確保流程清楚、高效整合。
+### 審查流程
 
-## IV. 法律聲明
+- **每日篩查：** 維護者快速檢查。
+- **每週深入審查：** 全面評估。
+- **根據回饋快速迭代**。
 
-### 貢獻協議
+## 法律聲明
 
-提交 Pull Request 即表示你同意你的貢獻將以 [Apache 2.0 授權條款](LICENSE)（或專案現行授權）釋出，與專案一致。
+提交貢獻即表示你同意你的貢獻將基於 Apache 2.0 授權條款，與 Roo Code 的授權一致。