[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72E133SZ0JW2PQEB3SS2S27":3,"skill-same:01M72E133SZ0JW2PQEB3SS2S27":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":46},"01M72E133SZ0JW2PQEB3SS2S27","improve-codebase-architecture",null,"Escaneia uma codebase em busca de oportunidades de deepening, apresenta como relatório HTML visual e depois sabatina a escolhida.","leandrocfe\u002Fskills","leandrocfe","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F3833889?v=4","01M72E0G25CGV5QNVVV3KK0D6M","Leandro Ferreira","01M72E0G2W80MQK7BBV9MNH47X",42,"MIT","https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md",[],[],"2026-11-10 18:39:20",false,"---\nname: improve-codebase-architecture\ndescription: Escaneia uma codebase em busca de oportunidades de deepening, apresenta como relatório HTML visual e depois sabatina a escolhida.\ndisable-model-invocation: true\n---\n\n# Improve Codebase Architecture\n\nTraz à tona fricção arquitetural e propõe **oportunidades de deepening** — refactors que transformam módulos rasos (shallow) em profundos (deep). O objetivo é testabilidade e AI-navigability.\n\nEsta skill é _informada_ pelo domain model do projeto e construída sobre um vocabulário de design compartilhado:\n\n- Rode a skill `\u002Fcodebase-design` para o vocabulário de arquitetura (**module**, **interface**, **depth**, **seam**, **adapter**, **leverage**, **locality**) e seus princípios (o deletion test, \"a interface é a test surface\", \"um adapter = seam hipotético, dois = real\"). Use estes termos exatamente em toda sugestão — não desvie para \"component\", \"service\", \"API\" ou \"boundary\".\n- A linguagem de domínio em `CONTEXT.md` dá nomes a bons seams; ADRs em `docs\u002Fadr\u002F` registram decisões que esta skill não deve re-litigar.\n\n## Processo\n\n### 1. Explore\n\n**Escope antes de varrer — YAGNI.** Aprofundar um módulo compensa ao tornar mudanças futuras nele mais fáceis, então dê peso extra às partes da codebase que mudaram recentemente. Decida *onde* olhar antes de olhar:\n\n- Se o usuário nomeou uma direção — um módulo, um subsistema, um ponto de dor — pegue-a, e pule a inferência abaixo.\n- Senão, percorra um bom trecho do histórico de commits (`git log --oneline`) para achar os hot spots da codebase — os arquivos e áreas que aparecem repetidamente — e deixe esses paths puxarem sua atenção primeiro. Se as mudanças estiverem espalhadas sem hot spot claro, alargue a rede.\n\nLeia primeiro o glossário de domínio do projeto (`CONTEXT.md`) e quaisquer ADRs na área que você está tocando.\n\nDepois dispare um sub-agent para caminhar pela codebase. Não siga heurísticas rígidas — explore de forma orgânica e note onde você sente fricção:\n\n- Onde entender um conceito exige pular entre muitos módulos pequenos?\n- Onde módulos estão **shallow** — interface quase tão complexa quanto a implementação?\n- Onde funções puras foram extraídas só para testabilidade, mas os bugs reais se escondem em como são chamadas (sem **locality**)?\n- Onde módulos fortemente acoplados vazam através de seus seams?\n- Quais partes da codebase estão sem testes, ou difíceis de testar pela interface atual?\n\nAplique o **deletion test** em qualquer coisa que você suspeita ser shallow: deletar concentraria complexidade, ou só moveria? Um \"sim, concentra\" é o sinal que você quer.\n\n### 2. Apresente candidatos como relatório HTML\n\nEscreva um arquivo HTML self-contained no diretório temp do sistema operacional para que nada caia no repo. Resolva o temp dir a partir de `$TMPDIR`, com fallback para `\u002Ftmp` (ou `%TEMP%` no Windows), e escreva em `\u003Ctmpdir>\u002Farchitecture-review-\u003Ctimestamp>.html` para que cada execução tenha um arquivo novo. Abra para o usuário — `xdg-open \u003Cpath>` no Linux, `open \u003Cpath>` no macOS, `start \u003Cpath>` no Windows — e informe o caminho absoluto.\n\nO relatório usa **Tailwind via CDN** para layout e estilização, e **Mermaid via CDN** para diagramas onde um grafo\u002Fflow\u002Fsequência comunica a estrutura de forma confiável. Misture Mermaid com visuais CSS\u002FSVG feitos à mão — use Mermaid quando relacionamentos têm forma de grafo (call graphs, dependências, sequências), e divs\u002FSVG construídos à mão quando quiser algo mais editorial (mass diagrams, cross-sections, animações de collapse). Cada candidato recebe uma **visualização before\u002Fafter**. Seja visual.\n\nPara cada candidato, renderize um card com:\n\n- **Files** — quais arquivos\u002Fmódulos estão envolvidos\n- **Problem** — por que a arquitetura atual está causando fricção\n- **Solution** — descrição em linguagem simples do que mudaria\n- **Benefits** — explicados em termos de locality e leverage, e como os testes melhorariam\n- **Before \u002F After diagram** — lado a lado, desenhado customizado, ilustrando a shallow e o deepening\n- **Recommendation strength** — um de `Strong`, `Worth exploring`, `Speculative`, renderizado como badge\n\nEncerre o relatório com uma seção **Top recommendation**: qual candidato você atacaria primeiro e por quê.\n\n**Use vocabulário de CONTEXT.md para o domínio, e o vocabulário de `\u002Fcodebase-design` para a arquitetura.** Se `CONTEXT.md` define \"Order\", fale sobre \"o módulo de intake de Order\" — não \"o FooBarHandler\", e não \"o Order service\".\n\n**Conflitos de ADR**: se um candidato contradiz um ADR existente, só exponha quando a fricção for real o suficiente para justificar reabrir o ADR. Marque claramente no card (ex.: um callout de aviso: _\"contradiz ADR-0007 — mas vale reabrir porque...\"_). Não liste todo refactor teórico que um ADR proíbe.\n\nVeja [HTML-REPORT.md](HTML-REPORT.md) para o scaffold completo de HTML, padrões de diagrama e guia de estilo.\n\nNÃO proponha interfaces ainda. Depois que o arquivo for escrito, pergunte ao usuário: \"Qual destes você gostaria de explorar?\"\n\n### 3. Loop de sabatina\n\nUma vez que o usuário escolher um candidato, rode a skill `\u002Fgrilling` para caminhar a decision tree com ele — constraints, dependências, o shape do módulo aprofundado, o que fica atrás do seam, quais testes sobrevivem.\n\nEfeitos colaterais acontecem inline conforme decisões cristalizam — rode a skill `\u002Fdomain-modeling` para manter o domain model atualizado conforme avança:\n\n- **Nomeando um módulo aprofundado com um conceito que não está em `CONTEXT.md`?** Adicione o termo ao `CONTEXT.md`. Crie o arquivo de forma lazy se não existir.\n- **Afinando um termo vago durante a conversa?** Atualize `CONTEXT.md` ali mesmo.\n- **Usuário rejeita o candidato com uma razão importante?** Ofereça um ADR, enquadrado como: _\"Quer que eu registre isso como ADR para que futuras revisões de arquitetura não o re-sugiram?\"_ Só ofereça quando a razão realmente seria necessária para um explorador futuro evitar re-sugerir a mesma coisa — pule razões efêmeras (\"não vale a pena agora\") e óbvias.\n- **Quer explorar interfaces alternativas para o módulo aprofundado?** Rode a skill `\u002Fcodebase-design` e use o padrão de sub-agents paralelos design-it-twice dela.\n","# Improve Codebase Architecture\n\nTraz à tona fricção arquitetural e propõe **oportunidades de deepening** — refactors que transformam módulos rasos (shallow) em profundos (deep). O objetivo é testabilidade e AI-navigability.\n\nEsta skill é _informada_ pelo domain model do projeto e construída sobre um vocabulário de design compartilhado:\n\n- Rode a skill `\u002Fcodebase-design` para o vocabulário de arquitetura (**module**, **interface**, **depth**, **seam**, **adapter**, **leverage**, **locality**) e seus princípios (o deletion test, \"a interface é a test surface\", \"um adapter = seam hipotético, dois = real\"). Use estes termos exatamente em toda sugestão — não desvie para \"component\", \"service\", \"API\" ou \"boundary\".\n- A linguagem de domínio em `CONTEXT.md` dá nomes a bons seams; ADRs em `docs\u002Fadr\u002F` registram decisões que esta skill não deve re-litigar.\n\n## Processo\n\n### 1. Explore\n\n**Escope antes de varrer — YAGNI.** Aprofundar um módulo compensa ao tornar mudanças futuras nele mais fáceis, então dê peso extra às partes da codebase que mudaram recentemente. Decida *onde* olhar antes de olhar:\n\n- Se o usuário nomeou uma direção — um módulo, um subsistema, um ponto de dor — pegue-a, e pule a inferência abaixo.\n- Senão, percorra um bom trecho do histórico de commits (`git log --oneline`) para achar os hot spots da codebase — os arquivos e áreas que aparecem repetidamente — e deixe esses paths puxarem sua atenção primeiro. Se as mudanças estiverem espalhadas sem hot spot claro, alargue a rede.\n\nLeia primeiro o glossário de domínio do projeto (`CONTEXT.md`) e quaisquer ADRs na área que você está tocando.\n\nDepois dispare um sub-agent para caminhar pela codebase. Não siga heurísticas rígidas — explore de forma orgânica e note onde você sente fricção:\n\n- Onde entender um conceito exige pular entre muitos módulos pequenos?\n- Onde módulos estão **shallow** — interface quase tão complexa quanto a implementação?\n- Onde funções puras foram extraídas só para testabilidade, mas os bugs reais se escondem em como são chamadas (sem **locality**)?\n- Onde módulos fortemente acoplados vazam através de seus seams?\n- Quais partes da codebase estão sem testes, ou difíceis de testar pela interface atual?\n\nAplique o **deletion test** em qualquer coisa que você suspeita ser shallow: deletar concentraria complexidade, ou só moveria? Um \"sim, concentra\" é o sinal que você quer.\n\n### 2. Apresente candidatos como relatório HTML\n\nEscreva um arquivo HTML self-contained no diretório temp do sistema operacional para que nada caia no repo. Resolva o temp dir a partir de `$TMPDIR`, com fallback para `\u002Ftmp` (ou `%TEMP%` no Windows), e escreva em `\u003Ctmpdir>\u002Farchitecture-review-\u003Ctimestamp>.html` para que cada execução tenha um arquivo novo. Abra para o usuário — `xdg-open \u003Cpath>` no Linux, `open \u003Cpath>` no macOS, `start \u003Cpath>` no Windows — e informe o caminho absoluto.\n\nO relatório usa **Tailwind via CDN** para layout e estilização, e **Mermaid via CDN** para diagramas onde um grafo\u002Fflow\u002Fsequência comunica a estrutura de forma confiável. Misture Mermaid com visuais CSS\u002FSVG feitos à mão — use Mermaid quando relacionamentos têm forma de grafo (call graphs, dependências, sequências), e divs\u002FSVG construídos à mão quando quiser algo mais editorial (mass diagrams, cross-sections, animações de collapse). Cada candidato recebe uma **visualização before\u002Fafter**. Seja visual.\n\nPara cada candidato, renderize um card com:\n\n- **Files** — quais arquivos\u002Fmódulos estão envolvidos\n- **Problem** — por que a arquitetura atual está causando fricção\n- **Solution** — descrição em linguagem simples do que mudaria\n- **Benefits** — explicados em termos de locality e leverage, e como os testes melhorariam\n- **Before \u002F After diagram** — lado a lado, desenhado customizado, ilustrando a shallow e o deepening\n- **Recommendation strength** — um de `Strong`, `Worth exploring`, `Speculative`, renderizado como badge\n\nEncerre o relatório com uma seção **Top recommendation**: qual candidato você atacaria primeiro e por quê.\n\n**Use vocabulário de CONTEXT.md para o domínio, e o vocabulário de `\u002Fcodebase-design` para a arquitetura.** Se `CONTEXT.md` define \"Order\", fale sobre \"o módulo de intake de Order\" — não \"o FooBarHandler\", e não \"o Order service\".\n\n**Conflitos de ADR**: se um candidato contradiz um ADR existente, só exponha quando a fricção for real o suficiente para justificar reabrir o ADR. Marque claramente no card (ex.: um callout de aviso: _\"contradiz ADR-0007 — mas vale reabrir porque...\"_). Não liste todo refactor teórico que um ADR proíbe.\n\nVeja [HTML-REPORT.md](HTML-REPORT.md) para o scaffold completo de HTML, padrões de diagrama e guia de estilo.\n\nNÃO proponha interfaces ainda. Depois que o arquivo for escrito, pergunte ao usuário: \"Qual destes você gostaria de explorar?\"\n\n### 3. Loop de sabatina\n\nUma vez que o usuário escolher um candidato, rode a skill `\u002Fgrilling` para caminhar a decision tree com ele — constraints, dependências, o shape do módulo aprofundado, o que fica atrás do seam, quais testes sobrevivem.\n\nEfeitos colaterais acontecem inline conforme decisões cristalizam — rode a skill `\u002Fdomain-modeling` para manter o domain model atualizado conforme avança:\n\n- **Nomeando um módulo aprofundado com um conceito que não está em `CONTEXT.md`?** Adicione o termo ao `CONTEXT.md`. Crie o arquivo de forma lazy se não existir.\n- **Afinando um termo vago durante a conversa?** Atualize `CONTEXT.md` ali mesmo.\n- **Usuário rejeita o candidato com uma razão importante?** Ofereça um ADR, enquadrado como: _\"Quer que eu registre isso como ADR para que futuras revisões de arquitetura não o re-sugiram?\"_ Só ofereça quando a razão realmente seria necessária para um explorador futuro evitar re-sugerir a mesma coisa — pule razões efêmeras (\"não vale a pena agora\") e óbvias.\n- **Quer explorar interfaces alternativas para o módulo aprofundado?** Rode a skill `\u002Fcodebase-design` e use o padrão de sub-agents paralelos design-it-twice dela.\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","a56fdb38278610203ecd213c66660ab024c90895","skills\u002Fengineering\u002Fimprove-codebase-architecture",2,"https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills","https:\u002F\u002Fgithub.com\u002Fleandrocfe","https:\u002F\u002Fleandroferreira.dev.br","Laravel developer, member of the FilamentPHP Core Team 💛. Creator of Filament Brazilian Community - youtube.com\u002F@filamentbr","2026-08-12 21:51:59",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":24},[36,39,42],{"tool":37,"command":38},"npx","npx skills add leandrocfe\u002Fskills --skill improve-codebase-architecture",{"tool":40,"command":41},"bunx","bunx skills add leandrocfe\u002Fskills --skill improve-codebase-architecture",{"tool":43,"command":44},"pnpm","pnpm dlx skills add leandrocfe\u002Fskills --skill improve-codebase-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md",[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"agents\u002Fopenai.yaml","REFERENCE","参考文档",166,"https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002Fagents\u002Fopenai.yaml",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"HTML-REPORT.md",5553,"https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FHTML-REPORT.md",[58,65,72,79,86,93],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M72E31GMY923NK71VQJNV7BN","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M72E2ZX4NJ7VT19EB4X3HSY0","wait-what","Stop. That last message did not land — re-pitch it.","https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M72E2XB7CQCEZKAP0C1N48YY","to-questionnaire","Turn a decision you can't fully answer into a questionnaire for someone else to fill in.","https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M72E2VGV3VRDRVZD2X0VMNV3","teach","Teach the user a new skill or concept, within this workspace.","https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M72E2S4BB25HYHQRRWD030N6","handoff","Compact the current conversation into a handoff document for another agent to pick up.","https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M72E2PVNKY2555G9J49S3HRT","grilling","Grill o usuário sem dó sobre um plano, decisão ou ideia. Use quando o usuário quiser stress-test do próprio raciocínio, ou usar qualquer frase-gatilho de 'grill'.","https:\u002F\u002Fgithub.com\u002Fleandrocfe\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]