{
  "id": "improve-codebase-architecture",
  "handle": "improve-codebase-architecture",
  "canonicalUrl": "https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture",
  "language": "pt-BR",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/improve-codebase-architecture",
    "es": "https://bestskillsforclaude.com/es/skills/improve-codebase-architecture",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture",
    "ja": "https://bestskillsforclaude.com/ja/skills/improve-codebase-architecture"
  },
  "category": {
    "id": "build-and-ship",
    "name": "Construir e publicar"
  },
  "publisher": {
    "name": "Matt Pocock",
    "url": "https://github.com/mattpocock"
  },
  "source": "https://github.com/mattpocock/skills",
  "documentation": null,
  "licenseAsStated": "MIT",
  "runtime": "Claude Code and agents that support the skills CLI",
  "lastReviewed": "2026-08-05",
  "headline": "Um agente consegue dizer onde sua arquitetura realmente dói?",
  "summary": "Ele produz candidatos. Escolher quais importam continua com você.",
  "verdict": "A skill improve-codebase-architecture varre a base de código procurando oportunidades de simplificar e aprofundar módulos, apresenta os achados como relatório e só então explora os candidatos que você escolher. Essa ordem é o ponto: ela diagnostica e se recusa a reescrever antes de você decidir.",
  "bestFor": "Bases que cresceram rápido e agora vazam detalhes entre módulos.",
  "skipIf": "O projeto é pequeno o bastante para você já saber onde estão os problemas.",
  "keyTakeaways": [
    "Primeiro relatório, depois mudança. Essa ordem é o que torna seguro rodar.",
    "Limite a um subsistema, porque relatório de repositório inteiro é grande demais para agir.",
    "Achados são candidatos, não veredictos. Alguns estarão errados por razões que só seu time conhece.",
    "Combina com grill-me quando você quer testar o raciocínio antes de se comprometer."
  ],
  "quickStart": [
    "Instale com o CLI de skills a partir de mattpocock/skills, sob MIT.",
    "Rode em uma área e não no repositório inteiro, para o relatório continuar revisável.",
    "Escolha um ou dois candidatos. Uma lista de trinta achados é uma forma de não escolher nada."
  ],
  "sections": [
    {
      "heading": "O que muda na prática",
      "paragraphs": [
        "Trabalho de arquitetura costuma falhar por razões sociais e não técnicas: ninguém concorda por onde começar, então nada começa. Uma lista concreta de candidatos com motivos transforma essa discussão em decisão.",
        "Apresentar achados como relatório também evita a coisa mais perigosa que um agente pode fazer, que é refatorar vários módulos ao mesmo tempo enquanto você assiste."
      ]
    },
    {
      "heading": "Onde decepciona",
      "paragraphs": [
        "Ela vê o código, não a história. Algumas fronteiras estranhas existem por uma restrição que não está escrita em lugar nenhum, e a skill vai propor remover com toda a confiança.",
        "Relatórios longos também convidam ao aumento de escopo. A disciplina de escolher um candidato é inteiramente sua."
      ]
    }
  ],
  "faq": [
    {
      "question": "Ela muda o código sozinha?",
      "answer": "Ela relata primeiro e explora os candidatos que você escolher, em vez de refatorar de imediato."
    },
    {
      "question": "Que tamanho de base aguenta?",
      "answer": "Limite a um subsistema. Relatórios de repositório inteiro costumam ser grandes demais."
    },
    {
      "question": "Quem mantém?",
      "answer": "Matt Pocock, no repositório público de skills sob licença MIT."
    }
  ],
  "sources": [
    {
      "label": "mattpocock/skills no GitHub",
      "url": "https://github.com/mattpocock/skills",
      "kind": "repository"
    },
    {
      "label": "Diretório de agent skills",
      "url": "https://skills.sh",
      "kind": "directory"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture/content.md",
    "json": "https://bestskillsforclaude.com/pt-br/skills/improve-codebase-architecture/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}