CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-modification-rules

Regras críticas sobre quando e como modificar código existente

Quality

57%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/workflow/code-modification/SKILL.md
SKILL.md
Quality
Evals
Security

Code Modification Rules

Regras fundamentais sobre quando e como modificar código existente.


Quando Usar

Aplicar esta skill quando:

  • O usuário solicita modificações em código existente
  • Há dúvida sobre o escopo de uma alteração
  • Precisando decidir se deve fazer "melhorias" não solicitadas

Regra Fundamental

SÓ ALTERAR O QUE FOI EXPLICITAMENTE SOLICITADO:

  • ✅ Alterar apenas o que foi explicitamente solicitado pelo usuário
  • ❌ NÃO fazer alterações "melhorias" não solicitadas
  • ❌ NÃO remover código que não foi pedido para remover
  • ❌ NÃO adicionar funcionalidades que não foram solicitadas
  • ❌ NÃO refatorar código que não foi pedido para refatorar

Proibições Absolutas

NUNCA fazer sem solicitação explícita:

  1. Remover código existente
  2. Adicionar novas funcionalidades
  3. Refatorar código
  4. Alterar estrutura de arquivos
  5. Modificar configurações existentes
  6. Alterar nomes de variáveis/funções/classes
  7. Mudar estilo de código
  8. Adicionar ou remover dependências
  9. Modificar migrations Django/Alembic (já aplicadas)
  10. Alterar arquivos de configuração (nginx, docker, etc.)

Quando o Usuário Pede uma Alteração

Fazer apenas:

  1. A alteração específica solicitada
  2. Alterações mínimas necessárias para a alteração funcionar
  3. Manter tudo o resto exatamente como estava

Exemplos

Exemplo 1: Adicionar Endpoint

Solicitação: "adicionar endpoint GET /users"

✅ Correto:

  • Criar apenas o endpoint solicitado
  • Seguir estrutura existente
  • Não alterar outros endpoints
  • Não refatorar código existente

❌ Incorreto:

  • Refatorar todos os endpoints
  • Alterar estrutura de pastas
  • Adicionar funcionalidades extras
  • Modificar outros arquivos não relacionados

Exemplo 2: Corrigir Bug

Solicitação: "corrigir bug no cálculo de desconto"

✅ Correto:

  • Corrigir apenas o bug específico
  • Manter resto do código igual
  • Não "melhorar" outras partes

❌ Incorreto:

  • Refatorar toda a função
  • Alterar outras funções relacionadas
  • Adicionar validações extras não solicitadas

Quando Há Dúvida

Se não tiver certeza se deve alterar algo:

  1. Fazer apenas o que foi explicitamente pedido
  2. Se necessário, perguntar ao usuário antes de alterar
  3. NUNCA assumir que "melhorias" são desejadas

Exceções Permitidas

Alterações permitidas sem solicitação explícita:

  1. Correção de erros de sintaxe que impedem execução
  2. Correção de imports quebrados necessários para a alteração
  3. Ajustes mínimos de formatação para manter consistência (apenas se não alterar lógica)

Checklist

Antes de fazer qualquer alteração:

  • A alteração foi explicitamente solicitada?
  • Estou alterando apenas o necessário?
  • Não estou fazendo "melhorias" não solicitadas?
  • Não estou removendo código não relacionado?
  • Não estou adicionando funcionalidades extras?

Referências

  • Migrations: skills/backend/fastapi/SKILL.md e skills/backend/django/SKILL.md
  • Templates: core/templates/

Esta regra é crítica e deve ser seguida rigorosamente por todos os agentes.

Repository

fernandezbaptiste/cursor-multiagent-system

Path

skills/workflow/code-modification/SKILL.md

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.