Habilidade de Design Organizacional
A partir do objetivo, realiza uma série de entrevistas, define papéis (agentes) e gera de uma só vez: estrutura de diretórios, CLAUDE.md e o harness (Rules / Hooks / Skills / Settings). Atende desde a definição de responsáveis para metas individuais até organizações de grande porte.
Visão Geral dos Artefatos
.claude/
rules/
role-<nome>.md ← Regras operacionais de cada papel (vinculadas a caminhos)
skills/
ask-<nome>/SKILL.md ← Skill de invocação de cada papel
settings.json ← Hooks, permissões e ativação do Agent Team são adicionados
org/
<papel>/CLAUDE.md ← Documento de design de cada papel
workflows/ ← Definições de fluxo de trabalho (qual padrão usar para qual tarefa)
README.md ← Organograma (Mermaid)
Fluxo
Utiliza a ferramenta AskUserQuestion para conduzir a entrevista de forma interativa, com opções de múltipla escolha.
Não apresente todas as etapas de uma vez; vá passo a passo.
Como usar o AskUserQuestion
- Cada pergunta deve ter de 2 a 4 opções (a opção "Outro (entrada livre)" é adicionada automaticamente, não a inclua)
- Para perguntas que permitem várias respostas, defina
multiSelect: true - Se houver uma opção recomendada, coloque-a em primeiro lugar com o marcador "(Recomendado)"
- No máximo 4 perguntas podem ser feitas simultaneamente por chamada
- Use o campo
descriptiondas opções para fornecer explicações adicionais, facilitando a decisão do usuário
Passo 0: Verificação do Estado Atual (Execução Automática)
Ao iniciar a skill, as seguintes verificações são feitas automaticamente (sem perguntar ao usuário):
-
Verificar se o diretório
org/existe (usar Glob paraorg/**/CLAUDE.md) -
Se existir:
-
Ler
org/README.mde oCLAUDE.mdde cada papel -
Apresentar um resumo textual da estrutura organizacional atual (lista de papéis, relacionamentos, escopos de responsabilidade)
-
Verificar também o estado do harness:
- Existência de
.claude/rules/role-*.md - Existência de
.claude/skills/ask-*/SKILL.md - Configuração de hooks em
.claude/settings.json
- Existência de
-
Examinar outros arquivos do projeto (código-fonte, documentação, etc.) para analisar se a estrutura organizacional atual está alinhada com a realidade do projeto
-
Levantar pontos de revisão sob as seguintes perspectivas:
- Falta de cobertura: áreas funcionais existentes no projeto que não têm um papel responsável
- Excesso ou falta de papéis: papéis não utilizados ou com carga desbalanceada
- Inconsistência nos relacionamentos: linhas de reporte ou caminhos de comunicação que não correspondem à realidade
- Situação de subagentes: se existe um papel orquestrador definido, se cada CLAUDE.md tem uma seção "Protocolo de Execução de Subagente", e se um modelo recomendado foi especificado
- Falta de harness: papéis para os quais Rules/Skills/Hooks ainda não foram gerados
-
Se houver pontos de revisão, apresentá-los como sugestões
-
Usar
AskUserQuestionpara selecionar o modo:O que deseja fazer? (multiSelect: false, header: "Modo")
label description Revisar Revisar e melhorar a configuração atual Adicionar Adicionar novos papéis à configuração existente Gerar apenas o harness Adicionar apenas o harness (Rules/Skills/Hooks) para papéis existentes Criar do zero Ignorar a configuração existente e criar uma nova -
Se "Revisar": iniciar a partir do Passo 3 (definição de papéis) com base nas sugestões de revisão
-
Se "Adicionar": iniciar a partir do Passo 2 (levantamento de funcionalidades), tratando as funcionalidades existentes como já selecionadas
-
Se "Gerar apenas o harness": ir diretamente para o Passo 5 (geração do harness)
-
Se "Criar do zero": iniciar normalmente a partir do Passo 1
-
-
Se não existir: iniciar normalmente a partir do Passo 1
Passo 1: Confirmação do Objetivo
Usar AskUserQuestion para fazer as 3 perguntas a seguir simultaneamente em uma única chamada:
P1. O que deseja alcançar? (multiSelect: true, header: "Objetivo")
| label | description |
|---|---|
| Desenvolvimento de produto | Criar um produto, como um serviço ou aplicativo |
| Produção de conteúdo | Criar e publicar conteúdo, como artigos, vídeos ou materiais |
| Otimização de processos | Melhorar ou automatizar processos ou fluxos de trabalho existentes |
| Pesquisa e aprendizado | Aprofundar conhecimento por meio de pesquisa, análise ou desenvolvimento de habilidades |
P2. Para quem se destina? (multiSelect: true, header: "Público-alvo")
| label | description |
|---|---|
| Para si mesmo | Para alcançar metas pessoais ou autogerenciamento |
| Membros da equipe | Para colegas dentro da empresa ou projeto |
| Clientes | Para clientes ou parceiros diretos |
| Usuários finais | Para usuários em geral ou a comunidade |
P3. Qual é a escala? (multiSelect: false, header: "Escala")
| label | description |
|---|---|
| Individual | Configuração de agente ou responsável para uso pessoal |
| Pequena equipe | Configuração de pequena escala, cerca de 2 a 5 pessoas |
| Média escala | Configuração de equipe, cerca de 6 a 20 pessoas |
| Organização/Departamento | Configuração de grande escala, com mais de 20 pessoas |
Com base nas respostas, organizar o entendimento em formato de checklist e confirmar textualmente com o usuário. Após a concordância, prosseguir para o próximo passo.
Passo 2: Levantamento das Funcionalidades Necessárias
Com base nas respostas do Passo 1, selecionar 4 funcionalidades relacionadas e apresentá-las.
Usar AskUserQuestion para fazer uma pergunta:
Quais funcionalidades são necessárias? (multiSelect: true, header: "Funcionalidades")
As opções são selecionadas dinamicamente (4 itens) com base no objetivo do Passo 1. Pool de opções (apresentar 4 de acordo com o objetivo): Planejamento/Estratégia / Design/Arquitetura / Desenvolvimento/Implementação / Design/UI-UX / Teste/Gestão de Qualidade / Pesquisa/Coleta de Informações / Redação/Criação de Documentos / Marketing/Aquisição de Clientes / Vendas/Atendimento ao Cliente / Suporte ao Cliente / Gerenciamento de Projetos / Análise de Dados / Finanças/Contabilidade / RH/Recrutamento / Infraestrutura/Operações
Após a seleção, perguntar se há mais funcionalidades (se sim, apresentar mais 4 do pool restante; repetir até que o usuário considere suficiente).
Passo 3: Definição dos Papéis
Com base nas funcionalidades selecionadas no Passo 2, gerar automaticamente uma proposta de estrutura de papéis e apresentá-la textualmente.
P1. Esta configuração está boa? (multiSelect: false, header: "Confirmação da Configuração")
| label | description |
|---|---|
| OK com esta configuração | Prosseguir com a estrutura de papéis proposta |
| Quero adicionar um papel | Há um papel faltando |
| Quero mesclar/excluir | Há muitos papéis, quero consolidar |
| Quero renomear | Desejo corrigir o nome de um papel |
Se forem necessárias correções, solicitar instruções específicas por meio da entrada livre "Outro". Repetir até que o usuário aprove.
P2. Qual é a relação entre os papéis? (multiSelect: false, header: "Relacionamentos")
| label | description |
|---|---|
| Plana | Todos são iguais, sem hierarquia |
| Líder | Uma pessoa como coordenadora, as outras como membros |
| Hierárquica | Múltiplos níveis: chefe de departamento → líder → membro |
| Hub | Um papel central se conecta com todos os outros |
P3. Confirmação dos escopos de responsabilidade Apresentar textualmente uma proposta de escopo de responsabilidade para cada papel e perguntar "OK com este conteúdo / quero corrigir" (correções via entrada livre).
Passo 3.5: Design da Arquitetura de Execução
Os detalhes deste passo devem ser consultados em architecture-design.md para execução.
Conteúdo: Seleção entre SubAgent / Agent Team, design de orquestrador e trabalhadores, formação de equipes, alocação de modelos.
Passo 4: Confirmação e Geração
Apresentar textualmente o diagrama Mermaid e a lista de papéis, juntamente com a visão geral dos artefatos (consulte a seção "Visão Geral dos Artefatos").
Usar AskUserQuestion para a confirmação final:
Posso gerar? Confirmar com "Gerar / Quero corrigir". Após a aprovação, gerar tudo de uma vez, incluindo o Passo 5 (geração do harness).
Passo 5: Geração do Harness
Os detalhes da lógica de geração devem ser consultados em harness-generation.md para execução.
Consulte templates.md para os modelos.
Regras para a estrutura de diretórios:
- O diretório de cada papel deve ser criado em
org/<papel>/ - Se o diretório
org/já existir, adicionar ou atualizar a configuração existente - Se houver hierarquia, usar aninhamento; se for plano, dispor em paralelo
Observações
- Os nomes dos papéis (nomes de diretório) devem usar kebab-case em letras minúsculas em inglês
- O conteúdo do CLAUDE.md deve ser descrito em português
- Projetar de forma que os escopos de responsabilidade de cada papel sejam claramente separados
- Evitar expressões como "empresa", "corporação"; usar termos genéricos como "organização", "time", "configuração"
- Para uso pessoal, tratar os papéis como "responsável" ou "agente"
- Ao gerar o harness, fazer merge diferencial para não corromper o
settings.jsonexistente - Seguir o princípio do menor privilégio para
allowed-tools, não incluindo ferramentas desnecessárias para o papel