O Que Vais Construir
No final deste tutorial, vais compreender a arquitetura exata por trás de um sistema que gere uma empresa inteira através de IA. Não é teoria — este é o blueprint real que usamos diariamente na WizardingCode.
Vais aprender a:
- Estruturar um sistema operativo com IA com departamentos especializados
- Criar personas de IA que pensam como membros reais da equipa
- Configurar um cérebro de conhecimento persistente que fica mais inteligente com o tempo
- Conectar 14+ ferramentas externas através de um protocolo unificado
- Criar projetos prontos para produção em menos de 2 minutos
- Construir workflows compostos onde departamentos colaboram
Pré-requisitos: Familiaridade com linha de comandos, compreensão básica de assistentes de IA (Claude, ChatGPT), e vontade de deixar de ser o bottleneck do teu próprio negócio.
Passo 1: A Decisão de Arquitetura Que Muda Tudo
A maioria das pessoas usa IA como um motor de busca: faz uma pergunta, recebe uma resposta, esquece tudo.
É como contratar um funcionário, ter uma tarefa feita, e depois dar-lhe amnésia.
A primeira breakthrough na construção de um company OS é compreender as três camadas:
┌─────────────────────────────────────────┐
│ CAMADA DE INTELIGÊNCIA │
│ (Claude AI + System Prompts) │
├─────────────────────────────────────────┤
│ CAMADA DEPARTAMENTAL │
│ Dev | Mkt | Ecom | Fin | Ops | Strat │
├─────────────────────────────────────────┤
│ CAMADA DE INTEGRAÇÃO │
│ MCPs: Supabase, Shopify, Gmail... │
├─────────────────────────────────────────┤
│ CAMADA DE CONHECIMENTO │
│ Obsidian Vault + Memory Bank │
└─────────────────────────────────────────┘
Camada de Inteligência — O cérebro da IA. Claude com system prompts especializados que definem personalidade, expertise e frameworks de decisão para cada departamento.
Camada Departamental — O organograma. Sete departamentos, cada um com comandos específicos, workflows, sub-skills e caminhos de output. É aqui que o trabalho acontece.
Camada de Integração — O sistema nervoso. Conexões Model Context Protocol (MCP) para todas as ferramentas externas que o teu negócio usa. A IA não apenas pensa — age.
Camada de Conhecimento — A memória. Um vault Obsidian onde cada decisão, relatório e insight é guardado permanentemente. O sistema fica mais inteligente todos os dias.
Insight chave: Estas camadas não são ferramentas separadas. São um sistema unificado onde uma tarefa de marketing pode referenciar documentação de desenvolvimento, que foi informada por uma análise estratégica, tudo guardado no mesmo cérebro de conhecimento.
Passo 2: Configurar a Estrutura Departamental
Eis a estrutura de pastas que faz tudo funcionar:
arka-os/
├── CLAUDE.md # System prompt mestre
├── arka/ # Sistema core
│ ├── SKILL.md # Comandos de sistema
│ ├── agents/ # Agentes cross-departamento
│ ├── scripts/ # Scripts utilitários
│ ├── skills/ # Skills de sistema
│ └── templates/ # Templates de output
├── departments/
│ ├── dev/ # Desenvolvimento
│ │ ├── SKILL.md # Comandos & workflows dev
│ │ ├── agents/ # Agentes IA específicos de dev
│ │ ├── scripts/ # Build, deploy, scaffold scripts
│ │ ├── skills/ # Sub-skills (scaffold, mcp)
│ │ └── templates/ # Templates de código
│ ├── marketing/
│ ├── ecommerce/
│ ├── finance/
│ ├── operations/
│ ├── strategy/
│ └── knowledge/
├── knowledge/ # Config de conhecimento
├── mcps/ # Registry & perfis MCP
│ ├── registry.json # Todos os MCPs disponíveis
│ ├── profiles/ # Conjuntos MCP pré-configurados
│ ├── scripts/ # Scripts de gestão MCP
│ └── stacks/ # Configurações de pacotes
└── projects/ # Contextos de projetos ativos
O Padrão SKILL.md
Cada departamento tem um ficheiro SKILL.md na raiz. Este é o ficheiro de instrução mestre que diz à IA:
- O que este departamento faz (descrição, âmbito)
- Comandos disponíveis (com sintaxe exata)
- Personas envolvidas (quem responde e em que contexto)
- Sub-skills (links para ficheiros de workflow especializados)
- Caminhos de output (onde guardar resultados no vault Obsidian)
Porque isto importa: A IA não adivinha o que fazer. Cada departamento tem instruções explícitas, comandos explícitos e expectativas explícitas de output. É isto que transforma uma IA genérica num departamento funcional.
Passo 3: O System Prompt Mestre (CLAUDE.md)
O ficheiro CLAUDE.md na raiz é o cérebro de toda a operação. É aqui que defines:
Identidade e Princípios
## Identidade
- **Empresa:** TuaEmpresa
- **Sistema:** Nome do Teu OS
- **Propósito:** Sistema operativo empresarial aumentado por IA
## Princípios Core
1. Um Sistema, Muitos Departamentos
2. Personas São Membros da Equipa
3. Conhecimento Acumula
4. Contexto É Rei
5. Ação Sobre Teoria
6. Sempre Pronto Para o Cliente
7. Obsidian É O Cérebro
Stack Tecnológico Padrão
Define as tuas ferramentas standard para que cada projeto comece com a mesma base.
Registo de Comandos Departamentais
Mapeia cada comando ao seu departamento para que a IA encaminhe corretamente.
Standards de Código
Garante consistência em todos os projetos.
O power move: Este único ficheiro garante que quer estejas a trabalhar num projeto de cliente às 14h ou a rever código à meia-noite, a IA opera com os mesmos standards, princípios e conhecimento.
Passo 4: Construir a Camada de Integração MCP
É aqui que o ARKA OS passa de "assistente inteligente" para "centro de comando operacional."
O Que É MCP?
Model Context Protocol (MCP) permite que assistentes de IA se conectem a ferramentas e serviços externos. Em vez de copiar dados entre apps, a IA pode diretamente ler a tua base de dados, enviar emails, gerir o teu calendário, atualizar o teu quadro de projetos e fazer deploy do teu código.
O Registry
Cria um catálogo central de todos os MCPs disponíveis em mcps/registry.json.
Perfis MCP
Diferentes tipos de projeto precisam de diferentes ferramentas. Os perfis resolvem isto:
base: obsidian, context7, playwright, memory-bank, sentry, clickup
laravel: base + laravel-boost, serena
nuxt: base + nuxt, nuxt-ui
ecommerce: base + laravel-boost, serena, shopify
full-stack: base + laravel-boost, serena, nuxt, nuxt-ui
Quando executas /dev mcp apply laravel, um script lê o perfil, gera a configuração .mcp.json correta, e o teu projeto tem instantaneamente acesso a todas as ferramentas necessárias.
Os 14 MCPs Que Usamos
| MCP | O Que Faz | Departamento |
|---|---|---|
| Obsidian | Armazenamento de conhecimento | Todos |
| Context7 | Documentação de bibliotecas | Dev |
| Playwright | Testes de browser | Dev |
| Memory Bank | Memória persistente | Todos |
| Sentry | Tracking de erros | Dev, Ops |
| GitHub Grep | Pesquisa de código | Dev |
| ClickUp | Gestão de tarefas | Todos |
| Supabase | Base de dados | Dev |
| Shopify | E-commerce | Ecom |
| Gmail | Ops, Mkt | |
| Google Calendar | Agendamento | Ops |
| Google Drive | Documentos | Todos |
| Canva | Design visual | Mkt |
| Chrome | Automação de browser | Todos |
O efeito composto: Quando o departamento de marketing cria uma campanha, pode verificar o cronograma no ClickUp, referenciar assets de marca no Google Drive, criar visuais no Canva, agendar envios de email pelo Gmail, e registar tudo no Obsidian — tudo num único workflow.
Passo 5: A Camada de Conhecimento (A Memória da Tua IA)
Esta é a feature que separa um company OS de um chatbot fancy.
Porquê Obsidian?
- Local-first: Os teus dados ficam na tua máquina
- Markdown: Universal, portável, controlável por versão
- Wikilinks: Conecta ideias naturalmente com
[[Nome da Nota]] - Vista de grafo: Visualiza relações de conhecimento
- Extensível: Plugins para tudo
- Rápido: Lida com 10,000+ notas sem pestanejar
Estrutura do Vault
Obsidian Vault/
├── Projects/
│ └── <nome-projeto>/
│ ├── Home.md
│ ├── Architecture/
│ └── Docs/
├── Personas/ # Definições de personas IA
├── Sources/ # Conteúdo aprendido
├── Topics/ # Tópicos de conhecimento
├── 🧠 Knowledge Base/ # Insights processados
├── WizardingCode/
│ ├── Marketing/
│ ├── Ecommerce/
│ ├── Finance/
│ ├── Operations/
│ └── Strategy/
O Workflow de Aprendizagem
Quando executas /kb learn https://algum-relatorio-industria.com, o departamento de conhecimento:
- Busca e lê o conteúdo
- Extrai insights e dados chave
- Cria uma nota estruturada em
Sources/ - Liga-a a
Topics/relevantes - Atualiza quaisquer
Personas/relacionadas com novo conhecimento
Na próxima vez que qualquer departamento precisar de informação sobre esse tópico, já está no cérebro.
Passo 6: Scaffolding de Projetos — De Zero a Produção em 2 Minutos
Este é o workflow que faz cair o queixo a outros developers.
Como Funciona
/dev scaffold laravel client-crm
Por trás:
1. Clone starter kit do Git
2. Instala pacotes obrigatórios (por ordem!)
├── laravel/boost
├── laravel/horizon
├── echolabs/prism (AI SDK)
└── php-mcp/laravel
3. Aplica perfil MCP "laravel" (9 MCPs pré-configurados)
4. Configura Laravel Herd
5. Cria página de projeto Obsidian
6. Resultado: Projeto pronto para produção
Cada scaffold vem de um repositório Git real e mantido — não um gerador de templates. Código real, configurações reais, melhores práticas reais.
Passo 7: Construir Workflows Cross-Departamento
É aqui que a magia acontece. Os departamentos não trabalham em silos — colaboram.
Exemplo: Onboarding de Novo Cliente
Passo 1: Estratégia analisa o mercado do cliente
/strat analyze market <industria>
Passo 2: Desenvolvimento faz scaffold do projeto
/dev scaffold laravel <nome-projeto>
Passo 3: Marketing cria a proposta
/mkt content proposal <nome-projeto>
→ Referencia: Análise de mercado da Estratégia
Passo 4: Finanças cria a previsão
/fin forecast <nome-projeto>
Passo 5: Operações configura a gestão de projeto
/ops setup project <nome-projeto>
Passo 6: Conhecimento indexa tudo
/kb index project <nome-projeto>
Tempo total: ~20 minutos. Departamentos envolvidos: 6. Contexto perdido: zero.
Passo 8: O Ritmo Diário
Manhã (5 minutos)
/arka standup
Recebes: estado dos projetos, tarefas pendentes, calendário de hoje, erros durante a noite, prioridades estratégicas.
Execução (Horas de Trabalho)
Alterna entre departamentos conforme necessário. A IA mantém contexto em todos eles.
Final do Dia (2 minutos)
/arka status
/kb daily-summary
Passo 9: Escalar o Teu OS
Adicionar Novos Departamentos
A estrutura é modular. Queres um departamento de RH? Cria a pasta, define o SKILL.md, adiciona o prefixo ao CLAUDE.md.
Adicionar Novos MCPs
Encontraste uma nova ferramenta? Adiciona ao registry, coloca no perfil relevante, e cada novo projeto desse tipo tem automaticamente acesso.
Adicionar Novos Tipos de Projeto
Cria um novo starter kit Git, regista-o como tipo de scaffold, atribui um perfil MCP.
O Que Deves Construir Primeiro
Se estás a começar do zero, eis a ordem de prioridade:
- CLAUDE.md — Define identidade, princípios e tech stack
- Camada de Conhecimento — Configura a estrutura do vault Obsidian
- Departamento de Desenvolvimento — O departamento mais usado, com scaffolding
- Perfil MCP Base — Conecta as ferramentas essenciais
- Mais Um Departamento — O que te ocupa mais tempo depois do desenvolvimento
- Workflows Cross-Departamento — Começa a conectar departamentos
Não tentes construir os 7 departamentos de uma vez. Começa com 2, torna-os excelentes, depois expande.
O Panorama Geral
Construir um company OS não é um projeto de fim de semana — é um sistema em evolução que cresce com o teu negócio.
Mas eis o que a maioria falha: não tens de o construir sozinho.
Na WizardingCode, já construímos este sistema, testámo-lo em dezenas de projetos reais, e refinámo-lo ao longo de meses de uso diário. Podemos fazer deploy de uma versão personalizada para o teu negócio — adaptada à tua indústria, às tuas ferramentas, aos teus workflows.
Quer sejas um developer que quer parar de fazer context-switching, um dono de agência que precisa de escalar sem contratar, ou um fundador de startup que precisa de se mover mais rápido — um company OS alimentado por IA é a vantagem injusta que andavas à procura.
A questão não é se precisas de um. É quão rápido consegues ter um a funcionar.
Este tutorial é baseado no ARKA OS, o sistema operativo interno que alimenta a WizardingCode. Todas as features descritas estão em uso de produção hoje.
