CommunityImagemgithub.com

mattpocock/improve-codebase-architecture

Analisa uma base de código em busca de oportunidades de melhoria, apresenta-as em um relatório HTML visual e permite aprofundar-se em cada uma delas.

O que é improve-codebase-architecture?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) analise a arquitetura de uma base de código existente, identificando potenciais problemas, pontos fracos ou oportunidades de melhoria. O resultado é apresentado em um relatório HTML visual interativo, que facilita a compreensão dos achados. O usuário pode então selecionar qualquer uma das oportunidades identificadas e o agente irá 'grillar' (questionar e iterar) profundamente sobre ela, sugerindo refatorações ou mudanças arquiteturais. É útil para desenvolvedores que desejam receber um diagnóstico rápido e detalhado da arquitetura do seu projeto, seguido de uma exploração guiada e prática das melhorias. A skill suporta múltiplas plataformas de agentes de IA e funciona através da leitura de arquivos, análise de dependências e padrões de código.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/improve-codebase-architecture

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, lobehub/add-provider-doc · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que improve-codebase-architecture faz?

Analisa uma base de código em busca de oportunidades de melhoria, apresenta-as em um relatório HTML visual e permite aprofundar-se em cada uma delas.

Como usar

  1. Execute o agente de IA com a skill ativada.
  2. Forneça o caminho para a raiz da base de código que você deseja analisar.
  3. O agente irá escanear a base de código e gerar um relatório HTML.
  4. Abra o relatório em um navegador para visualizar as oportunidades identificadas.
  5. Selecione uma oportunidade e peça ao agente para 'grillar' (aprofundar) sobre ela.
  6. O agente irá analisar o código, sugerir refatorações e guiar você pelas mudanças.

Plataformas suportadas

  • Claude Code
  • Cursor
  • Codex
  • Outros agentes de IA compatíveis com skills

Exemplo de saída do relatório

O relatório HTML incluirá uma lista de problemas ou oportunidades, como:

  • Funções longas
  • Acoplamento excessivo
  • Duplicação de código
  • Padrões inconsistentes
  • Dependências circulares

Cada item pode ser expandido para mais detalhes e para iniciar uma sessão de 'grill'.

Notas

  • Certifique-se de que o diretório do projeto é acessível e contém código-fonte legível.
  • A análise é baseada heurística e pode variar conforme a linguagem e o framework.
  • Para melhores resultados, forneça contexto adicional sobre a arquitetura desejada.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

Habilidades Relacionadas