# mpsmaicon/projetos-padrao architecture

> Architecture diagram of the GitHub repository mpsmaicon/projetos-padrao, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mpsmaicon/projetos-padrao
- Repository: https://github.com/mpsmaicon/projetos-padrao

## Overview

Projetos-Padrao é um template de trabalho para projetos conduzidos com Claude Code. O fluxo principal começa quando o dono cria um projeto a partir do template e inicia um objetivo com `/goal`: o orquestrador registra o plano, divide o trabalho, delega etapas ao executor e exige evidências antes de concluir. Skills preservam lições; regras, configurações e hooks limitam ações de aprovação e merge. Ao concluir objetivos em projetos filhos, skills gerais podem retornar por Pull Request, cuja aprovação permanece humana. As relações abaixo refletem apenas o README; não havia trechos de código disponíveis.

Main entry points: [`.claude/agents/orquestrador.md`](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/agents/orquestrador.md) (Orquestrador), [`.claude/agents/executor.md`](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/agents/executor.md) (Executor), [`.claude/settings.json`](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/settings.json) (Configuração Claude), [`.claude/hooks/bloquear-aprovacao-pr.sh`](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/hooks/bloquear-aprovacao-pr.sh) (Bloqueio aprovação)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orientacao["Orientação e planejamento"]
  node_claude["Regras do projeto<br/>[CLAUDE.md]"]
  node_orquestrador["Orquestrador<br/>[orquestrador.md]"]
  node_plano["Plano de trabalho<br/>[plano.md]"]
end

subgraph group_execucao["Execução e aprendizado"]
  node_executor["Executor<br/>[executor.md]"]
  node_skills["Skills aprendidas<br/>[skills]"]
  node_historico["Histórico herdado"]
end

subgraph group_controles["Controles de PR"]
  node_configuracao["Configuração Claude<br/>[settings.json]"]
  node_hook_aprovacao["Bloqueio aprovação"]
  node_hook_merge["Bloqueio merge"]
end

node_dono(("Dono do projeto"))
node_template["Template Projetos-Padrao"]
node_projeto_filho["Projeto filho"]
node_github["GitHub Pull Request"]

node_dono -->|"cria projeto"| node_template
node_dono -->|"define objetivo"| node_orquestrador
node_orquestrador -->|"registra andamento"| node_plano
node_orquestrador -->|"delega etapas"| node_executor
node_executor -->|"entrega evidências"| node_orquestrador
node_orquestrador -->|"avalia lições"| node_skills
node_orquestrador -->|"consulta herança"| node_historico
node_projeto_filho -->|"propõe skills gerais"| node_github
node_dono -->|"aprova manualmente"| node_github
node_configuracao -->|"restringe merge"| node_github
node_hook_aprovacao -->|"recusa aprovação"| node_github
node_hook_merge -->|"recusa merge"| node_github

click node_claude "https://github.com/mpsmaicon/projetos-padrao/blob/main/CLAUDE.md"
click node_orquestrador "https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/agents/orquestrador.md"
click node_plano "https://github.com/mpsmaicon/projetos-padrao/blob/main/memoria/plano.md"
click node_executor "https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/agents/executor.md"
click node_skills "https://github.com/mpsmaicon/projetos-padrao/tree/main/.claude/skills"
click node_historico "https://github.com/mpsmaicon/projetos-padrao/blob/main/memoria/historico-padrao.md"
click node_configuracao "https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/settings.json"
click node_hook_aprovacao "https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/hooks/bloquear-aprovacao-pr.sh"
click node_hook_merge "https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/hooks/bloquear-merge-bash.sh"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_claude,node_orquestrador,node_plano toneBlue
class node_executor,node_skills,node_historico toneAmber
class node_configuracao,node_hook_aprovacao,node_hook_merge,node_github toneMint
class node_dono,node_template,node_projeto_filho toneIndigo
```

## Components

### Orientação e planejamento

- [Regras do projeto](https://github.com/mpsmaicon/projetos-padrao/blob/main/CLAUDE.md): `CLAUDE.md`
- [Orquestrador](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/agents/orquestrador.md): `.claude/agents/orquestrador.md`
- [Plano de trabalho](https://github.com/mpsmaicon/projetos-padrao/blob/main/memoria/plano.md): `memoria/plano.md`

### Execução e aprendizado

- [Executor](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/agents/executor.md): `.claude/agents/executor.md`
- [Skills aprendidas](https://github.com/mpsmaicon/projetos-padrao/tree/main/.claude/skills): `.claude/skills`
- [Histórico herdado](https://github.com/mpsmaicon/projetos-padrao/blob/main/memoria/historico-padrao.md): `memoria/historico-padrao.md`

### Controles de PR

- [Configuração Claude](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/settings.json): `.claude/settings.json`
- [Bloqueio aprovação](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/hooks/bloquear-aprovacao-pr.sh): `.claude/hooks/bloquear-aprovacao-pr.sh`
- [Bloqueio merge](https://github.com/mpsmaicon/projetos-padrao/blob/main/.claude/hooks/bloquear-merge-bash.sh): `.claude/hooks/bloquear-merge-bash.sh`

### Other components

- **Dono do projeto**
- **Template Projetos-Padrao**
- **Projeto filho**
- **GitHub Pull Request**

## Connections

- Dono do projeto → Template Projetos-Padrao: cria projeto (evidence: `README.md`)
- Dono do projeto → Orquestrador: define objetivo (evidence: `README.md`)
- Orquestrador → Plano de trabalho: registra andamento (evidence: `README.md`)
- Orquestrador → Executor: delega etapas (evidence: `README.md`)
- Executor → Orquestrador: entrega evidências (evidence: `README.md`)
- Orquestrador → Skills aprendidas: avalia lições (evidence: `README.md`)
- Orquestrador → Histórico herdado: consulta herança (evidence: `README.md`)
- Projeto filho → GitHub Pull Request: propõe skills gerais (evidence: `README.md`)
- Dono do projeto → GitHub Pull Request: aprova manualmente (evidence: `README.md`)
- Configuração Claude → GitHub Pull Request: restringe merge (evidence: `README.md`)
- Bloqueio aprovação → GitHub Pull Request: recusa aprovação (evidence: `README.md`)
- Bloqueio merge → GitHub Pull Request: recusa merge (evidence: `README.md`)
