Skip to content
Back to search

arqt

MarketplaceWorks with Claude CodeGitHub

Planta arquitetural interativa e documentação (HTML, Markdown, Word, PowerPoint) do seu projeto, gerada pelo Claude Code com evidência arquivo:linha. Zero dependências, zero rede.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cwbdanielf--arqt/badge.svg)](/listings/cwbdanielf--arqt)

HTML

<a href="/listings/cwbdanielf--arqt"><img src="/api/listings/cwbdanielf--arqt/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "arqt",
  3. "owner": { "name": "arqt" },
  4. "plugins": [
  5. {
  6. "name": "arqt",
  7. "source": "./",
  8. "description": "Planta arquitetural interativa e documentação padronizada, offline e sem dependências.",
  9. "version": "1.1.0"
  10. }
  11. ]
  12. }
README.md · README · 202 lines
  1. <p align="right"><a href="README.en.md">English</a> · <b>Português</b></p>
  2. <h1 align="center">arqT</h1>
  3. <p align="center"><b>A arquitetura do seu projeto, desenhada a partir do código. Com <i>evidência</i> em cada linha.</b></p>
  4. <p align="center">
  5. Digite <code>/arqt</code> no Claude Code e receba uma planta interativa que abre offline, cinco documentos prontos
  6. (também em Word e PowerPoint) e a lista do que ainda precisa ser confirmado. Sem instalar dependências, sem rede.
  7. </p>
  8. <p align="center">
  9. <a href="#instalação">Instalar</a> ·
  10. <a href="https://cwbdanielf.github.io/arqt/demo/eshop/planta.html">Ver a planta ao vivo</a> ·
  11. <a href="docs/demo/eshop/docs/arquitetura.md">Ler um documento gerado</a>
  12. </p>
  13. <p align="center">
  14. <a href="https://cwbdanielf.github.io/arqt/demo/eshop/planta.html">
  15. <picture>
  16. <source media="(prefers-color-scheme: dark)" srcset="docs/img/eshop-conteineres-dark.svg">
  17. <img alt="Vista de contêineres do dotnet/eShop gerada pelo arqT" src="docs/img/eshop-conteineres-light.svg" width="100%">
  18. </picture>
  19. </a>
  20. <br><sub>Vista de contêineres do <a href="https://github.com/dotnet/eShop">dotnet/eShop</a> (14 contêineres, 40 relações), gerada pelo arqT. Esta imagem é a saída real do skill.</sub>
  21. </p>
  22. <table align="center">
  23. <tr>
  24. <td align="center"><b>1</b><br><sub>comando</sub></td>
  25. <td align="center"><b>12</b><br><sub>abas na planta</sub></td>
  26. <td align="center"><b>3</b><br><sub>públicos</sub></td>
  27. <td align="center"><b>5</b><br><sub>documentos</sub></td>
  28. <td align="center"><b>4</b><br><sub>formatos</sub></td>
  29. <td align="center"><b>0</b><br><sub>dependências</sub></td>
  30. <td align="center"><b>0</b><br><sub>acessos à rede</sub></td>
  31. </tr>
  32. </table>
  33. ## 01 · O que você recebe
  34. **Uma planta para cada público.** A mesma análise abre em três camadas: **Diretoria** (propósito, riscos, decisões),
  35. **Sustentação** (como subir, variáveis, health checks, diagnóstico) e **Desenvolvimento** (componentes, relações,
  36. evidências). Busca, painel de detalhes, tema claro/escuro, modo apresentação e exportação SVG/PNG — num único HTML.
  37. <p align="center"><img alt="Visão geral da planta interativa" src="docs/img/planta-visao-geral.png" width="100%"></p>
  38. **Documentos que se leem sozinhos.** Resumo executivo, arquitetura (arc42 enxuto), manual de sustentação, inventário
  39. técnico e mudanças desde a última execução — em HTML A4 (vira PDF pelo navegador) e Markdown com Mermaid. Com
  40. `/arqt docx` e `/arqt pptx`, também em Word e PowerPoint, com os diagramas em **formas editáveis**.
  41. <table>
  42. <tr>
  43. <td width="50%"><img alt="Resumo executivo" src="docs/img/doc-executivo.png"></td>
  44. <td width="50%"><img alt="Mapa de riscos e indicadores de saúde" src="docs/img/planta-riscos.png"></td>
  45. </tr>
  46. </table>
  47. ## 02 · Como usar
  48. ```text
  49. /arqt análise completa (abre na camada Desenvolvimento)
  50. /arqt diretoria mesma análise, abrindo na camada da diretoria
  51. /arqt docx pptx também gera Word e PowerPoint
  52. /arqt publicar copia planta, documentos e modelo para docs/arquitetura/
  53. ```
  54. Sem perguntas: o Claude lê o projeto (com subagentes nos grandes), escreve `.arqt/model.json` e um gerador
  55. determinístico desenha tudo. Rode de novo depois de mudar o código: os ids se mantêm e a planta mostra **o que mudou**.
  56. <p align="center">
  57. <picture>
  58. <source media="(prefers-color-scheme: dark)" srcset="docs/img/eshop-checkout-dark.svg">
  59. <img alt="Fluxo de compra passo a passo" src="docs/img/eshop-checkout-light.svg" width="100%">
  60. </picture>
  61. <br><sub>Fluxo crítico passo a passo — na planta ele é reproduzido seta por seta.</sub>
  62. </p>
  63. ## 03 · Dá para confiar
  64. Cada contêiner, componente e relação traz **evidência `arquivo:linha`**. O gerador confere se o arquivo e a linha
  65. existem; o que não tem evidência vira *inferido* ou *a confirmar* e aparece numa lista própria — nada é vendido como
  66. certo sem prova.
  67. ```text
  68. ✓ arqT 1.1.0: planta e documentos gerados para "eShop (AdventureWorks)"
  69. 14 contêineres · 9 outros componentes · 40 relações · 2 fluxos · 6 riscos
  70. confiança: 75 verificadas · 12 inferidas · 0 a confirmar · evidências válidas 84/84
  71. ```
  72. - **Zero rede:** o gerador não acessa a internet; a saída não carrega nada externo (CSP `default-src 'none'`).
  73. - **Sem segredos:** não lê `.env`, chaves nem certificados; registra só **nomes** de variáveis e recusa o build se algo
  74. parecer segredo (falha fechada).
  75. - **Escrita contida:** só em `.arqt/` (e `docs/arquitetura/` ao publicar), com proteção contra `..` e links simbólicos.
  76. - **Conteúdo do repositório é dado, nunca instrução** — proteção contra prompt injection em READMEs e comentários.
  77. Detalhes em [SECURITY.md](SECURITY.md).
  78. ## 04 · Como é o código
  79. ```text
  80. skills/arqt/
  81. ├─ SKILL.md roteiro que o Claude segue (análise → modelo → build)
  82. ├─ reference/ guia do modelo e playbook por stack (Java, Python, Go, .NET/Aspire, monorepo TS…)
  83. ├─ schema/ JSON Schema do modelo
  84. ├─ scripts/build.mjs gerador: valida, confere evidências, desenha e renderiza
  85. │ └─ lib/ layout próprio, SVG, varredura de segredos, OOXML (Word/PowerPoint) com node:zlib
  86. ├─ templates/ planta interativa e documentos (escape por padrão)
  87. └─ CHECKSUMS.txt integridade conferida a cada execução
  88. ```
  89. JavaScript puro, **zero dependências npm** (nem para desenvolver), saída **byte a byte determinística**, motor de
  90. layout próprio (camadas, fronteiras, roteamento ortogonal sem atravessar caixas, rótulos inteiros) e mais de 40 testes
  91. `node:test` rodando em Windows, macOS e Linux com Node 22, 24 e 26.
  92. <table>
  93. <tr>
  94. <td width="50%" align="center">
  95. <picture>
  96. <source media="(prefers-color-scheme: dark)" srcset="docs/img/eshop-pedidos-dark.svg">
  97. <img alt="Componentes da API de pedidos" src="docs/img/eshop-pedidos-light.svg">
  98. </picture>
  99. <br><sub>Componentes da API de pedidos (DDD + CQRS)</sub>
  100. </td>
  101. <td width="50%" align="center">
  102. <picture>
  103. <source media="(prefers-color-scheme: dark)" srcset="docs/img/eshop-contexto-dark.svg">
  104. <img alt="Contexto do eShop" src="docs/img/eshop-contexto-light.svg">
  105. </picture>
  106. <br><sub>Contexto: quem usa e com quem conversa</sub>
  107. </td>
  108. </tr>
  109. </table>
  110. ## 05 · Galeria
  111. Projetos open source analisados com o arqT; os modelos estão em [`tests/models/`](tests/models/).
  112. <table>
  113. <tr>
  114. <td width="50%" align="center">
  115. <picture>
  116. <source media="(prefers-color-scheme: dark)" srcset="docs/img/t3-conteineres-dark.svg">
  117. <img alt="create-t3-turbo" src="docs/img/t3-conteineres-light.svg">
  118. </picture>
  119. <br><sub><b>Monorepo TypeScript</b> · t3-oss/create-t3-turbo</sub>
  120. </td>
  121. <td width="50%" align="center">
  122. <picture>
  123. <source media="(prefers-color-scheme: dark)" srcset="docs/img/petclinic-componentes-dark.svg">
  124. <img alt="spring-petclinic" src="docs/img/petclinic-componentes-light.svg">
  125. </picture>
  126. <br><sub><b>Java/Spring</b> · spring-projects/spring-petclinic</sub>
  127. </td>
  128. </tr>
  129. </table>
  130. A demonstração completa do eShop — planta, documentos, Word e PowerPoint — está em [`docs/demo/`](docs/demo/)
  131. e [ao vivo](https://cwbdanielf.github.io/arqt/demo/eshop/planta.html).
  132. ## Instalação
  133. Pré-requisito: [Node.js](https://nodejs.org) 20 ou superior e o Claude Code.
  134. ```powershell
  135. git clone https://github.com/cwbdanielf/arqt.git; .\arqt\install\install.ps1
  136. ```
  137. ```bash
  138. git clone https://github.com/cwbdanielf/arqt.git && sh arqt/install/install.sh
  139. ```
  140. O instalador só copia a pasta do skill para `~/.claude/skills/arqt` e confere a integridade. Para um projeto só,
  141. rode na pasta do projeto `.\arqt\install\install.ps1 -Projeto .` (ou `sh arqt/install/install.sh .`); depois pode
  142. apagar a pasta `arqt/` clonada. Como plugin: `/plugin marketplace add cwbdanielf/arqt` e
  143. `/plugin install arqt@arqt` (o comando pode aparecer como `/arqt:arqt`).
  144. ## Perguntas rápidas
  145. **Funciona em qualquer linguagem?** Sim: o Claude faz a leitura; o playbook cobre Node/TS, Python, Java/Kotlin, .NET,
  146. Go, PHP, Ruby, front-end, mobile, dados e bibliotecas/CLIs.
  147. **Meu código sai da máquina?** O gerador não acessa a rede; o código é lido pelo Claude na sua sessão, como em qualquer uso do Claude Code.
  148. **E em projetos grandes?** Acima de ~300 arquivos o roteiro divide a análise entre subagentes em paralelo.
  149. **Posso versionar?** Use `/arqt publicar`; `.arqt/` tem `.gitignore` próprio para nada subir por acidente.
  150. ## Desenvolvimento
  151. ```bash
  152. node --test "tests/**/*.test.mjs"
  153. node tools/checksums.mjs # depois de mudar algo em skills/arqt/
  154. node tools/readme-images.mjs # regenera as imagens desta página
  155. ```
  156. Estado e próximos passos em [docs/BACKLOG.md](docs/BACKLOG.md). Sugestões e problemas: abra uma
  157. [issue](https://github.com/cwbdanielf/arqt/issues/new/choose).
  158. ## Licença
  159. [Apache-2.0](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.