development-guidelines

Claude Marketplace

Uma coleção de plugins para o Claude Code voltados à arquitetura de software e à documentação de design. Os plugins automatizam tarefas como registrar decisões arquiteturais, gerar diagramas, analisar a arquitetura de projetos e produzir guias de desenvolvimento por linguagem.

Plugins Disponíveis

Este marketplace oferece quatro plugins para documentação e análise arquitetural:

Plugin	Descrição	Comandos
ADRs Management	Análise, geração e vinculação de Architecture Decision Records (ADRs)	/adrs-management:adr-map, :adr-identify, :adr-generate, :adr-link
Diagrams Generator	Geração de diagramas C4 (PlantUML) e Mermaid a partir de Feature Design Documents (FDDs)	/diagrams-generator:c4-generate, :mermaid-generate
Project Analyzer	Análise arquitetural completa, análise profunda de componentes e auditoria de dependências	/project-analizer:generate-architectural-report, :run-dependency-audit
Development Guidelines	Geração de guias de desenvolvimento abrangentes e específicos por linguagem	/development-guidelines:guidelines-generate

Instalação

Todos os comandos abaixo são executados dentro do Claude Code no terminal (rode claude). Em outros ambientes (extensões/IDE) o comando /plugin pode não estar disponível.

Passo 1 — Adicionar o Marketplace

/plugin marketplace add Lucassamuel97/claude-plugins

Esse comando registra o repositório do GitHub como uma fonte de plugins. Você verá: Successfully added marketplace: lucassamuel-plugins.

O identificador do marketplace (lucassamuel-plugins) é o campo name definido em .claude-plugin/marketplace.json — não é o nome do repositório.

Passo 2 — Instalar os Plugins

Instale apenas os que for usar (ou todos):

/plugin install adrs-management@lucassamuel-plugins
/plugin install diagrams-generator@lucassamuel-plugins
/plugin install project-analizer@lucassamuel-plugins
/plugin install development-guidelines@lucassamuel-plugins

Passo 3 — Recarregar os Plugins (obrigatório)

Após instalar, os comandos não ficam ativos imediatamente. Recarregue:

/reload-plugins

Se os comandos ainda não aparecerem após o /reload-plugins, feche e reabra o Claude Code (saia e rode claude novamente).

Passo 4 — Usar os Comandos

Os comandos dos plugins são namespaced pelo nome do plugin, no formato /<plugin>:<comando>:

/diagrams-generator:mermaid-generate docs/features/FDD_Rate_Limiter.md
/adrs-management:adr-map
/project-analizer:generate-architectural-report
/development-guidelines:guidelines-generate Python

Dica: digite / e comece a escrever o nome do comando (ex.: /mer ou /diagrams) para o autocomplete mostrar o nome/namespace exato com que cada comando foi registrado.

Para navegar pelos plugins instalados e seus comandos a qualquer momento:

/plugin

Início Rápido

Os comandos usam o prefixo do plugin (/<plugin>:<comando>). Se preferir, digite / e use o autocomplete para localizá-los.

ADRs Management

Documente decisões arquiteturais de forma sistemática, seguindo um fluxo de 3 fases (mapear → identificar → gerar) com vinculação ao final:

/adrs-management:adr-map                 # Fase 1: mapeia a base de código em módulos lógicos
/adrs-management:adr-identify AUTH DATA  # Fase 2: identifica ADRs em potencial nos módulos
/adrs-management:adr-generate BILLING    # Fase 3: gera ADRs formais no formato MADR
/adrs-management:adr-link                # Vincula os ADRs com relacionamentos bidirecionais

Os ADRs podem ser gerados em vários idiomas (en, pt-BR, es, fr, de). O plugin aplica filtragem rigorosa — apenas cerca de 5% das descobertas viram ADRs — e usa o histórico do git para enriquecer o contexto temporal.

Diagrams Generator

Crie documentação visual a partir de Feature Design Documents (FDDs):

/diagrams-generator:c4-generate docs/features/FDD_Rate_Limiter.md       # Diagramas C4 (C1–C4) em PlantUML
/diagrams-generator:mermaid-generate docs/features/FDD_Rate_Limiter.md  # Diagramas Mermaid (sequência, fluxo, classe, ER)

O idioma dos diagramas é detectado automaticamente a partir do FDD, mantendo os termos técnicos em inglês (Service, Gateway, Redis etc.). Nenhum diagrama é inventado quando o FDD não tem informação suficiente.

Este repositório já inclui um FDD de exemplo em docs/features/FDD_Rate_Limiter.md (um SDK de rate limiting em Go) para você testar os comandos imediatamente.

Project Analyzer

Analise a arquitetura e as dependências do projeto (somente leitura — não modifica o código):