rezendefabiorezendefabio/financas-lab/.claude/skills/setup-architecture/SKILL.md

setup-architecture

Skill0 starsChanged 6 months agoMITView on GitHub

Define a arquitetura do projeto: linguagem, framework, estilo (DDD/Clean/Hexagonal/CRUD), banco de dados, estrategia de testes. Recebe descricao do projeto como argumento. Gera docs/architecture.md.

In this repository27 other files it gives its agents.
- frontend/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- frontend/CLAUDE.mdCLAUDE.md
- add-entity-to-auditSkill
- auditSkill
- babysit-prsSkill
- batchSkill
- daily-summarySkill
- factory-metricsSkill
- feature-frontSkill
- featureSkill
- init-projectSkill
- migrateSkill
- planSkill
- register-screenSkill
- review-archSkill
- review-frontSkill
- review-prSkill
- setup-designSkill
- setup-infraSkill
- shipSkill
- tasksSkill
- watch-ciSkill
- write-jobSkill
- write-migrationSkill
- write-reportSkill
- write-testSkill

The file

Create a free account to mount

Files

SKILL.md

Voce deve definir a arquitetura do projeto descrito no argumento. Execute todos os passos em ordem.

Input

Argumento recebido: descricao do projeto (ex: "sistema de gestao financeira pessoal com contas, categorias e lancamentos").

Passo 0 -- Ler contexto existente

Verifique se docs/architecture.md ja existe:

Test-Path docs/architecture.md

Se existir: leia o conteudo e considere as decisoes ja tomadas antes de propor alteracoes.

Verifique tambem se CLAUDE.md existe e leia-o para entender convencoes do projeto.

Passo 1 -- Analisar dominio e propor arquitetura

Com base na descricao do projeto, analise o dominio e produza uma proposta de arquitetura cobrindo:

Linguagem + versao: escolha com justificativa (ex: Java 21 LTS -- ecossistema maduro, suporte a virtual threads)
Framework principal: escolha com justificativa (ex: Spring Boot 3.x -- autoconfiguracao, ecossistema)
Estilo arquitetural: uma das opcoes abaixo com justificativa:
- DDD com Clean Architecture: ideal para dominios ricos com regras de negocio complexas
- Hexagonal (Ports & Adapters): ideal para isolamento de portas de entrada/saida
- CRUD simples: ideal para CRUD direto sem regras de negocio complexas
- Microservicos: ideal para times grandes e dominios independentes
Banco de dados: escolha com justificativa (ex: PostgreSQL -- ACID, maturidade, JSON support)
Estrategia de testes: niveis e ferramentas (ex: JUnit 5 + Mockito para unit; Testcontainers para integration; MockMvc para E2E)
Estrutura de pacotes recomendada: listagem dos pacotes principais

Passo 2 -- Exibir proposta ao operador

Exibir ao operador a proposta formatada:

/setup-architecture: proposta para "<descricao>"

Linguagem:          <linguagem + versao>
                    Motivo: <justificativa>

Framework:          <framework>
                    Motivo: <justificativa>

Estilo:             <estilo arquitetural>
                    Motivo: <justificativa>

Banco de dados:     <banco>
                    Motivo: <justificativa>

Testes:
  Unit:             <ferramenta>
  Integration:      <ferramenta>
  E2E:              <ferramenta>

Estrutura de pacotes:
  <lista de pacotes>

Usar AskUserQuestion com a pergunta "Aprovar esta arquitetura e gerar docs/architecture.md?" Opcoes: "Sim, aprovar" e "Nao, cancelar".

Se cancelar: exibir "Arquitetura cancelada. Nenhum arquivo gerado." e terminar.

Passo 3 -- Gerar docs/architecture.md

Verificar se o diretorio docs/ existe:

Test-Path docs

Se nao existir: criar o diretorio com New-Item -ItemType Directory -Path docs.

Gerar o arquivo docs/architecture.md com o conteudo aprovado:

# Architecture Decision — <descricao-do-projeto>

> Gerado por /setup-architecture. Revisado e aprovado pelo operador.

## Linguagem e Runtime

**<linguagem + versao>**

<justificativa>

## Framework Principal

**<framework>**

<justificativa>

## Estilo Arquitetural

**<estilo>**

<justificativa>

### Estrutura de Pacotes

<estrutura>
```

Banco de Dados

<banco>

<justificativa>

Estrategia de Testes

Nivel	Ferramenta	Escopo
Unit	`<ferramenta>`	`<escopo>`
Integration	`<ferramenta>`	`<escopo>`
E2E	`<ferramenta>`	`<escopo>`

Decisoes Complementares

<outras decisoes relevantes para o dominio especifico>
```

Apos gravar o arquivo, verificar existencia:

Test-Path docs/architecture.md

Se nao existir: reportar erro e terminar.

Passo 4 -- Relatorio

Exibir:

/setup-architecture concluido.

Arquivo gerado: docs/architecture.md
Decisoes:
  Linguagem:   <linguagem>
  Framework:   <framework>
  Estilo:      <estilo>
  Banco:       <banco>

Proximo passo: /setup-design "<descricao>" ou /setup-infra "<descricao>"

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free